X
【IT】正直詳細設計書いらないよね？【SE】
0001非決定性名無しさん
垢版 |
2018/05/13(日) 05:09:12.66
全部要件定義で突っ込めばよくない？
インプットアウトプット、DBとか環境設定、処理の概要くらいはみたいけどほとんど使われない設計書を大量生産するのってアホみたい。

現場でも実はソース書いてから設計書つくりましたみたいなことが多いし、客も設計書なんかみてないし、保守のSEも設計書よりも問い合わせではコード見て判断する方が多いし、バグ改修でも設計書みながらバグ改修するやつなんていないでしょ。

だれの為に作られてだれの為にメンテしてるの？日本以外のITの進んだ国でも同じことをやっているのだろうか？

5分でかけるコードのために1ヶ月かけて資料と検証をしているようなものだ。

ソースみたり検索しただけじゃ直ぐにわからない情報をパパッとわかるようにまとめたものは必要だと思うけど、過剰すぎて誰も使ってない求めてない情報まで一生懸命メンテしてない？

まとめ
今みたいな詳細設計書はいらないと思う

IT先進国のアメリカでもエクセルで大量に設計書を作っているのかだれか教えてください。
0003非決定性名無しさん
垢版 |
2018/05/13(日) 14:26:20.99
DBのなんかよくわからんパラメーターの設定一覧ならあったほうがいいと思う
でも基本いらないでしょ、どんなときに使うの？
アメリカとか設計書どうなってるんだろう、調べたら日本みたいな設計書はないって書いてあったけど
0004非決定性名無しさん
垢版 |
2018/05/13(日) 18:22:08.81
議論にすらならないのか・・・
0005非決定性名無しさん
垢版 |
2018/05/13(日) 18:26:54.24
ソースを見て判断しなければならないのはドキュメントの保守が行われていないせいであってドキュメント自体は必要だろ。
0006非決定性名無しさん
垢版 |
2018/05/13(日) 18:38:38.18
Javadocがあれば、詳細設計書は要らないかも。
ドキュメントは、後で使うものだけにしたほうがいいというのは同意。
0007非決定性名無しさん
垢版 |
2018/05/13(日) 18:55:17.09
上司がドキュメントしかみないしドキュメントをみて判断をするからドキュメント自体は必要なのはわかる。
でも必要最小限にしたい、20以上のフォルダの中にそれぞれ10～50のファイルがあってさらに1冊印刷するだけで数百ページになったりするものもある。
いくらなんでも過剰だとおもうし、保守なんてできないと思う（メンテしてることにしてるだけ）。
しかもどこの現場にいっても設計書のフォーマットが違ってどう読めばいいのか慣れが必要なんだよ
テーブルだけで300以上あるシステムとかだとDB設計書やSQLだけで恐ろしい量になったりするのもわかるけどさ

なにが必要な情報でなにが不要なのか日本中で統一して欲しいし、教科書てきなものも必要だと思う
0008非決定性名無しさん
垢版 |
2018/05/13(日) 18:56:42.00
アメリカが世界最先端で生産性も高いならアメリカに習えばいいと思ったけど検索しても情報がでてこないんだよね
0010非決定性名無しさん
垢版 |
2018/05/13(日) 21:50:50.46
>>9
詳細設計が煮詰まった段階じゃねーの
0011非決定性名無しさん
垢版 |
2018/05/13(日) 22:21:41.95
職場ではプログラム担当者(新卒一年目の私)がプログラムを書き終わってから
テスト仕様書を自分で書いて自分でテストしてるのですが
なんだか違和感というかこれ違うんじゃないかっていう感覚があって自信が持てません…
0012非決定性名無しさん
垢版 |
2018/05/13(日) 23:37:51.34
どこの現場いってもそんなもんだよ
マトリクス式で全ての結果にDBと画像の証拠をExcelに貼り付けさせるような時間のかかるテストを要求するところもあるし殆ど時間くれないとこもある(;´д｀)

工程
要件定義　　-　　基本設計（外部設計）-詳細設計（内部設計）-実装
　↓　　　　　　　　↓　　　　　　　　　↓　　　　　　　　　↓
システムテスト　　結合テスト　　　　　単体テスト　　　　　プログラムテスト

的なものを勝手にイメージしてるんだけどPS（プログラムテスト）なんてどこも存在しないから
プログラムテストと単体テストを一緒にやるかんじなるのかな？
単体テストは修正したロジックの分岐を全て試すべき！
とかいわれる
詳細設計で決めたこと全部満たしてるかと修正したロジックの分岐を全部通してみる（そのときにデッドロジックに気づいたりもする）
あとは境界値と異常値の確認くらいかな？
結合テストでは修正とは関係なくてもデータパターンを一通り試したり、あとは要件定義とか外部設計で決められたこと全部満たしてるかとかそんな感じかな？

現場の顔伺いながら自己流でやってきてるから参考にならないかも(^_^;)
0014非決定性名無しさん
垢版 |
2018/05/13(日) 23:49:53.73
V字型説明ここにもあった
https://webrage.jp/techblog/v_shaped_mode/

いろんなサイトでいろいろ仰々しいこといってるけどよくわかんないと思うんだよね
でも重要なのは
①ほんとにテストやったんかよ！っていわれるレベルのバグはのがさない
②詳細設計したとこは全部試す
③要求全部達成してるか試す
だと思ってる！
0015非決定性名無しさん
垢版 |
2018/05/13(日) 23:58:05.45
この板、人がこなくて暇だな～(・ω・`)
0016非決定性名無しさん
垢版 |
2018/05/14(月) 00:26:20.48
>>12
ありがとうございます。
今の現場は、というか新卒での初の案件ですが…
画面ごとに単体テスト仕様書を書いてテストしてます。
おっしゃる通り画面スクショとDB取得結果を証跡としてエクセルにペタペタ貼ってます。
0017非決定性名無しさん
垢版 |
2018/05/14(月) 18:47:36.89
>>16
元請け？2次受け？3次受け？
ちゃんと教育してもらえそう？
0018非決定性名無しさん
垢版 |
2018/05/14(月) 20:27:14.25
１つの画面を5日で作るのと20日で作るの、お金になるのは後者。だから書類は多ければ多いほどいい。
SIERなら常識。

テストで大事なのはステップ数と件数だから、全部同じ人がやらないと調整しにくいだろ？
バグが多ければテスト項目から削ったり設計書を直したり、少なければバグが出るテスト項目増やしたりして対応できる。
0019非決定性名無しさん
垢版 |
2018/05/14(月) 20:35:01.69
>>17
二次受けっていうんでしょうか。
大きいSIさんが取ってきたお仕事を貰って客先に常駐してます。
教育は(´･ω･`)正直期待できないです…
ピリピリした現場に放り込まれて恐る恐る質問して、
恐る恐るプログラム、テスト。
そんな毎日です。
0020非決定性名無しさん
垢版 |
2018/05/14(月) 21:04:56.57
現場はまじで場所によりけりだからね～
もし先輩がついてないならすごい心細いね、どこの会社に雇われてるのかもわからなくなるしｗ
0021非決定性名無しさん
垢版 |
2018/05/14(月) 21:09:43.17
>>18
それまじだから困る

え？それすぐ終わるくね？ってものでも一生懸命大量に資料作って遠回りな実装して毎日残業でやったほうがものすごい褒められてしまう世界
0023非決定性名無しさん
垢版 |
2018/05/14(月) 21:42:53.09
これ参考になるかも
https://geechs-magazine.com/tag/tech/20160114
正常値　異常値　境界値　限界値
あとはマトリクスを書いてパターンを見てみるとか
全部バカ正直にテストやると時間いくらあっても足りないけど

プログラムはどの会社もフレームワークってのがあるはずだからフレームワークの振る舞いを理解する。
そういうふうになってるんだって割り切って理解する
コントローラーとサービスとビューはどういうふうに繋がってるかな？とか
データベースはどういうふうに操作してるのかな？とかね！

あとは頭からお尻までの流れを知る！
ここから入ってきてここから出て行くんだとか

あとデバッグを使いこなすこと！
困ったらデバッグデバッグデバッグ！
デバッグのやり方がわからない場合は最優先で覚えてね、
無理やりありえない値を変数に入れたり処理の途中で各変数の値をみたり

SI系ならもちろんEclipse＋Javaだと思う
ショートカットを覚えてね
F3とALT+←とShift+Ctrl+R
あと呼び出し元を参照とかこの辺は基礎だから(*ﾟ▽ﾟ*)

ふう(o´Д`)
0024非決定性名無しさん
垢版 |
2018/05/14(月) 21:48:08.24
>>22
星の数ほどある人売屋の求人やんけ
0025非決定性名無しさん
垢版 |
2018/05/14(月) 21:51:27.13
>>23
ありがとうございます。
デシジョンテーブルの作り方も分からず、ほぼ総当たりのケースを作ってしまっています。
調べると色々省略できるようで勉強しないとなぁ。
0026非決定性名無しさん
垢版 |
2018/05/14(月) 22:10:22.83
>>25
デシジョンてこれか！
http://gihyo.jp/dev/serial/01/test_up/0005
むかしちょっとだけお世話になったけどこれがなんという手法なのか考えたこともなかった！
勉強になります、ありがとうございます！
0028非決定性名無しさん
垢版 |
2018/05/14(月) 22:27:03.43
真面目な人はホントに>>18を頭の片隅に入れておいてくれ。
大事なのは誰かの時間と書類の行数。
自分じゃなくてもいいことを忘れないでくれ
0029非決定性名無しさん
垢版 |
2018/05/14(月) 22:49:54.01
保守か開発かにもよるんじゃない？
開発だと遅延に遅延を重ねてとにかく早くやれって空気のとこ多いけど
0030非決定性名無しさん
垢版 |
2018/05/14(月) 22:50:34.51
>>27
ありがとうございます
0031非決定性名無しさん
垢版 |
2018/05/15(火) 07:07:47.88
手動で画面ペタペタとって黙視確認とか何とかならんのかねぇ。。
0032非決定性名無しさん
垢版 |
2018/05/15(火) 07:49:27.62
画面パチパチとって名前つけて保存するくらいならいいけど単体テストから全てのエビデンスとDBの記録をエクセルに貼り付けさせて体裁整えさせるとこあるし。単純にエクセルに貼り付けるって行為が時間かかりすぎるし無駄。まあでもその為の時間くれるならいいんじゃない？
0033非決定性名無しさん
垢版 |
2018/05/15(火) 09:03:14.62
作業が独立するので、テスト流す人と貼る人と確認する人が並列で動けるので動きが速い現場もある。
一概には何ともいえない。一人で直列にやればいつまでかかるかわからんことにもなる。
0034非決定性名無しさん
垢版 |
2018/05/15(火) 21:15:43.91
めちゃくちゃ上手に設計する人の下で開発できたらすごい楽しく仕事できるんじゃないかという期待を持ってしまう。
0035非決定性名無しさん
垢版 |
2018/05/15(火) 22:11:50.41
パイプラインで作業やるのに、設計情報全部出そろってから開発するわけないんだ。
今はこなれてない設計でも、見切り発車して開発しはじめるパイプライン上等なんだ。
0036非決定性名無しさん
垢版 |
2018/05/16(水) 00:38:36.72
他の人は詳細設計書ある部分プログラミングしてるけど俺の担当してるとこ詳細設計書ないんだけど(;´д｀)
0037非決定性名無しさん
垢版 |
2018/05/17(木) 23:23:48.39
詳細設計書ができる前に開発が始まる、開発がほぼ終わってから詳細設計書に作業がもどるってことが起こるってことは詳細設計書は開発には必要ないんじゃないかって思っちゃうよね。あくまでもそのあとの保守に必要なだけなんじゃないかとか
0038非決定性名無しさん
垢版 |
2018/05/18(金) 00:48:23.99
マジレスすると規模がデカいプロジェクトだと詳細設計書は必須
あと、コードより図や一覧表の方が全体を理解しやすい
末端のエンジニアも全体が分からないと困る
詳細設計書を省く場合でもパラメータシートは必要
0039非決定性名無しさん
垢版 |
2018/05/18(金) 06:29:11.38
>>37
全体の概要がわかるような設計書なら、メンテに使うかも知れない。

1ステップごとの処理の内容をいちいち書いてるような設計書は時間のムダ。
0041非決定性名無しさん
垢版 |
2018/05/20(日) 20:49:15.16
全体云々って、それは基本設計の領域じゃないんか？
0043非決定性名無しさん
垢版 |
2018/05/26(土) 19:24:45.21
>>1
逆だな。詳細設計がちゃんとできていればコーディングはあっと言う間に終わる。
0044非決定性名無しさん
垢版 |
2018/05/26(土) 19:53:41.42
ソースからAIが自動で作ってくれるようになるよ
0045非決定性名無しさん
垢版 |
2018/05/26(土) 20:08:36.54
>>44
あのな、AIは人間が作るんだよ。
0046非決定性名無しさん
垢版 |
2018/05/26(土) 21:43:45.72
魂けがれなく、道けわし
0047非決定性名無しさん
垢版 |
2018/05/27(日) 07:19:56.81
基本設計書は客に納品することが多いからいるよね
詳細はなくていい
基本設計書で不足してる情報を補足する資料があればいい
0048非決定性名無しさん
垢版 |
2018/05/27(日) 14:15:58.84
請負でやる場合、要件定義や基本設計は完了していることが前提だけどな。
準委任契約で開発やってんのかね？
0049非決定性名無しさん
垢版 |
2018/06/09(土) 00:39:39.07
ハラスメントが繰り返し起きている。
焦点となるのは加害者本人で、彼らの下劣で攻撃的で、
場合によっては違法ですらある行為の温床となった企業や業界の体質ではない。
だが、行為が単体で起こることはない。 企業はこうした人間を雇って昇進させ、
その仕事により収益まで得ていたわけだが、原因は構造的なものだ。
加害者の地位が高くなればそれだけ、抑制もバランスも機能しなくなる。

新日鉄住金ソリューションズ代表取締役社長 謝敷宗敬
副社長執行役員 北村公一
専務執行役員 近藤一政
常務執行役員 大城卓
常務執行役員 森田宏之
上席執行役員 國本衛
上席執行役員 福島徹二
上席執行役員 梶原敏弘
上席執行役員 南悦郎
執行役員 吉田佳子
執行役員 玉置和彦
執行役員 吉田勝彦
執行役員 熊本吉弘
執行役員 小池公彦
執行役員 黒木益尚
執行役員 福田成昭
執行役員 北沢聖
執行役員 鶴田進
執行役員 川崎淳
執行役員 齋藤聡
0050非決定性名無しさん
垢版 |
2018/06/11(月) 00:32:39.94
設計
0051非決定性名無しさん
垢版 |
2018/06/11(月) 14:11:35.76
一応書いとかないと貰ったソースで謎のフラグが行ったり来たりしてカオスになるぞw
0053非決定性名無しさん
垢版 |
2018/06/11(月) 23:30:14.94
変なフラグ作らせないためだろ
0055非決定性名無しさん
垢版 |
2018/06/12(火) 20:01:57.49
謎のフラグを使うのがNG
詳細設計書を作る暇があるなら
ソースレビューして叩きまくったほうが有意義
0056非決定性名無しさん
垢版 |
2018/06/12(火) 20:42:19.74
Documents can lie.
Source code never lies.
0058非決定性名無しさん
垢版 |
2018/06/13(水) 13:36:47.59
>>55
上司「お前らレビューする余裕あるなら人を貰ってくで～」
0059非決定性名無しさん
垢版 |
2018/06/13(水) 13:46:06.25
AIでソース書けや。
0060非決定性名無しさん
垢版 |
2018/06/13(水) 20:05:36.62
コードいじくりまわしているプログラマが一番気持ち悪い。
0061非決定性名無しさん
垢版 |
2018/06/13(水) 20:58:05.18
>>60
わいがコード職人やで
0062非決定性名無しさん
垢版 |
2018/06/14(木) 05:03:15.25
詳細設計書よりこのスレがいらなくね？
0063非決定性名無しさん
垢版 |
2018/06/21(木) 20:18:57.79
開発の規模感次第じゃね？
俺んとこは2、3人で自社パッケージ製品開発だから全くドキュメントなし
0064非決定性名無しさん
垢版 |
2018/06/22(金) 01:24:48.36
「使用済み下着販売掲示板（画像付き）」で検索。

いい子、かわいい子、いっぱいいるよ。
0065非決定性名無しさん
垢版 |
2018/06/28(木) 21:06:00.45
うちのシステム、設計書で5GBあるんだが
俺一度も開いたことないファイル山ほどあると思う
0066非決定性名無しさん
垢版 |
2018/07/07(土) 22:24:49.26
日鉄ソリューションズ
エロ対決しましょう
　　　／￣￣＼
　　 / ＼　／ 丶
　　｜(●　●) |
　　(ﾞﾞ )～( ﾞﾞ)
　　 |￣　　￣|
　 ／|　　　　|＼
　｜ 丶　　　ノ ｜
　｜　　　　　　｜
　 ＼＿＿人＿＿／
0067非決定性名無しさん
垢版 |
2018/07/16(月) 12:04:15.57
>>57
これはもう実現されてる。
詳細設計書を特殊な言語で書かなきゃいけないけどな。

COBOLとかの特殊な言語で…
0068非決定性名無しさん
垢版 |
2018/07/16(月) 18:36:37.91
設計書からコードを生成するような仕組みにすると、今度は設計書の書き方に制約がついてそのプログラミング言語の良さをつぶしてしまい、結局、コーディングした方がよくなる。
0070非決定性名無しさん
垢版 |
2018/07/17(火) 16:40:30.55
ドキュメントがいらないといってるのは末端だからじゃないの？
ウォーターフォールで工程間の入れ替え考えたらその発想はあり得ないよ
0071非決定性名無しさん
垢版 |
2018/07/17(火) 20:35:05.65
一人とか少人数でやるなら仕様書要らねぇ。
エンドユーザーがそばにいるならたぶんラフな図位で済ますと思う。

めんどいのはアレだよ、中堅とか大手。
請負前提、裁判沙汰も覚悟の奴。
アレの時は「裁判資料」としてのドキュメントの重要性が爆上がりになる。

正直そんなんどうでもええでっしゃろって思うけどな……どうせ仕様は変わるんで。
まぁDoxygen覚えておくと楽できるスクリプト作れるかも知らん。
007271
垢版 |
2018/07/17(火) 20:45:50.43
ごめん、足りてないものがあった、Graphviz。
あとはGnu Globalが時々役に立つ事がある（バークレーDBの知識は必要だが）。
0073非決定性名無しさん
垢版 |
2018/07/18(水) 06:59:16.40
要件定義と基本設計さえ、しっかりしていればいい。
0074非決定性名無しさん
垢版 |
2018/07/18(水) 08:09:44.09
>>73
そういうのは小さいシステムだろ。大きなシステムでもプロトタイピング、スパイラルモデルを採用しないのは謎だが、あとから優秀な技術者が来ると思っているプロジェクトが多すぎる。
0075非決定性名無しさん
垢版 |
2018/08/24(金) 22:01:25.64
設計書の記述レベルを揃えろと上司に言われたが、それをやると簡単な機能は設計書なんて見なくても作れるし、難しい機能は設計書読んでも作れないんだけどw
そんなわけで無駄な設計書をひたすら時間をかけて作ってる。プログラマあとは任せた。
0076非決定性名無しさん
垢版 |
2018/08/25(土) 21:29:18.84
>>75
？
0077非決定性名無しさん
垢版 |
2018/08/25(土) 21:32:04.06
だいたいまともに設計書が書けるならコーディングはかなりのものがただの作業となる。

設計書がどうのこうのという話は、そもそも設計書が書けない、言葉で説明できない人の話。

言葉で説明できない人間だからプログラムも必ずわかりにくい。
0078非決定性名無しさん
垢版 |
2018/08/31(金) 18:11:09.94
仕様書書けないPGや設計書読めないSE、定義書内の用語が分かってない上席で承認レビューとかするのは不毛だと思うけど、基本いまのSIerの組織編成では一式必要では？(見積上乗せとか懇意なBPへの仕事確保とかは置いとくとしても..)

実際フワッと人事異動でアサインされたりする様な業界事情が何とかならないと(←土方界の宿命)都度細かい仕様を問い合わせまくられる事になるわけで。

PG主体で関係者も全員実用的なコード読み書き出来る部隊で編成すれば削れるかも知れないけど、オンプレな構築が全滅してAWSの環境設定もAIでフルオート構築なんて美味しい話は(SIer界には)やって来ない
0079非決定性名無しさん
垢版 |
2018/08/31(金) 18:16:55.92
>>78
文字切れすまそ

つまりH/Wの設定シートやらが必要無くなる位まで技術進歩してくれれば、そっち側の細かい設計書ドキュメントは実用上不要。
0080非決定性名無しさん
垢版 |
2018/09/01(土) 06:21:53.29
メンテされてない詳細設計書は害でしかない
0081非決定性名無しさん
垢版 |
2018/09/01(土) 23:18:23.55
>>79
話が理路整然としてない。あんたはダメだ。
0082非決定性名無しさん
垢版 |
2018/09/01(土) 23:21:15.43
読む気が起きない文章ってあるよね
読もうと努力しても全然頭に入ってこない
0083非決定性名無しさん
垢版 |
2018/09/02(日) 01:00:31.93
自分だけ、そのときの自分にしかわからないプログラムを書くやつが多いから、詳細設計書はなおさら必要なんだよな。

設計書を書かせるとおかしな設計であることが一目瞭然となる。
0084非決定性名無しさん
垢版 |
2018/09/02(日) 02:43:38.17
>>83
君はプログラムを読めないの？
0085非決定性名無しさん
垢版 |
2018/09/02(日) 02:46:52.27
ソースコード読めない奴はソフトウェア開発者として実力不足
0086非決定性名無しさん
垢版 |
2018/09/02(日) 03:46:40.23
>>85
たいていの人のは読める

だけど、たまに
マジで意味わからんソース書くヤツがいる
0087非決定性名無しさん
垢版 |
2018/09/02(日) 04:11:47.96
>>86
かなり経験ある奴でコメントがないとか文句言ってる奴はいた。
0088非決定性名無しさん
垢版 |
2018/09/02(日) 06:29:22.38
>>84
わからないやつだな。可読性の高いプログラムが書けるなら、設計書も簡単に作れる。

ドキュメンテーションが苦手でコーディングは得意という人間がまともなプログラムを書くわけがない。
新着レスの表示
レスを投稿する

ニューススポーツなんでも実況