正直詳細設計書いらないよね?

1: 名無しさん。 2018/05/13(日) 05:09:12.66
全部要件定義で突っ込めばよくない?
インプットアウトプット、DBとか環境設定、処理の概要くらいはみたいけどほとんど使われない設計書を大量生産するのってアホみたい。

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

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

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

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

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

IT先進国のアメリカでもエクセルで大量に設計書を作っているのかだれか教えてください。

引用元:https://kizuna.5ch.net/test/read.cgi/infosys/1526155752/

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

なにが必要な情報でなにが不要なのか日本中で統一して欲しいし、教科書てきなものも必要だと思う

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

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

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

現場の顔伺いながら自己流でやってきてるから参考にならないかも(^_^;)

16: 名無しさん。 2018/05/14(月) 00:26:20.48
>>12
ありがとうございます。
今の現場は、というか新卒での初の案件ですが…
画面ごとに単体テスト仕様書を書いてテストしてます。
おっしゃる通り画面スクショとDB取得結果を証跡としてエクセルにペタペタ貼ってます。
17: 名無しさん。 2018/05/14(月) 18:47:36.89
>>16
元請け?2次受け?3次受け?
ちゃんと教育してもらえそう?
19: 名無しさん。 2018/05/14(月) 20:35:01.69
>>17
二次受けっていうんでしょうか。
大きいSIさんが取ってきたお仕事を貰って客先に常駐してます。
教育は(´・ω・`)正直期待できないです…
ピリピリした現場に放り込まれて恐る恐る質問して、
恐る恐るプログラム、テスト。
そんな毎日です。
18: 名無しさん。 2018/05/14(月) 20:27:14.25
1つの画面を5日で作るのと20日で作るの、お金になるのは後者。だから書類は多ければ多いほどいい。
SIERなら常識。

テストで大事なのはステップ数と件数だから、全部同じ人がやらないと調整しにくいだろ?
バグが多ければテスト項目から削ったり設計書を直したり、少なければバグが出るテスト項目増やしたりして対応できる。

21: 名無しさん。 2018/05/14(月) 21:09:43.17
>>18
それまじだから困る

え?それすぐ終わるくね?ってものでも一生懸命大量に資料作って遠回りな実装して毎日残業でやったほうがものすごい褒められてしまう世界

28: 名無しさん。 2018/05/14(月) 22:27:03.43
真面目な人はホントに>>18を頭の片隅に入れておいてくれ。
大事なのは誰かの時間と書類の行数。
自分じゃなくてもいいことを忘れないでくれ
20: 名無しさん。 2018/05/14(月) 21:04:56.57
現場はまじで場所によりけりだからね~
もし先輩がついてないならすごい心細いね、どこの会社に雇われてるのかもわからなくなるしw
31: 名無しさん。 2018/05/15(火) 07:07:47.88
手動で画面ペタペタとって黙視確認とか何とかならんのかねぇ。。
33: 名無しさん。 2018/05/15(火) 09:03:14.62
作業が独立するので、テスト流す人と貼る人と確認する人が並列で動けるので動きが速い現場もある。
一概には何ともいえない。一人で直列にやればいつまでかかるかわからんことにもなる。
34: 名無しさん。 2018/05/15(火) 21:15:43.91
めちゃくちゃ上手に設計する人の下で開発できたらすごい楽しく仕事できるんじゃないかという期待を持ってしまう。
35: 名無しさん。 2018/05/15(火) 22:11:50.41
パイプラインで作業やるのに、設計情報全部出そろってから開発するわけないんだ。
今はこなれてない設計でも、見切り発車して開発しはじめるパイプライン上等なんだ。
36: 名無しさん。 2018/05/16(水) 00:38:36.72
他の人は詳細設計書ある部分プログラミングしてるけど俺の担当してるとこ詳細設計書ないんだけど(;´д`)
37: 名無しさん。 2018/05/17(木) 23:23:48.39
詳細設計書ができる前に開発が始まる、開発がほぼ終わってから詳細設計書に作業がもどるってことが起こるってことは詳細設計書は開発には必要ないんじゃないかって思っちゃうよね。あくまでもそのあとの保守に必要なだけなんじゃないかとか
39: 名無しさん。 2018/05/18(金) 06:29:11.38
>>37
全体の概要がわかるような設計書なら、メンテに使うかも知れない。

1ステップごとの処理の内容をいちいち書いてるような設計書は時間のムダ。

38: 名無しさん。 2018/05/18(金) 00:48:23.99
マジレスすると規模がデカいプロジェクトだと詳細設計書は必須
あと、コードより図や一覧表の方が全体を理解しやすい
末端のエンジニアも全体が分からないと困る
詳細設計書を省く場合でもパラメータシートは必要
46: 名無しさん。 2018/05/26(土) 21:43:45.72
魂けがれなく、道けわし
47: 名無しさん。 2018/05/27(日) 07:19:56.81
基本設計書は客に納品することが多いからいるよね
詳細はなくていい
基本設計書で不足してる情報を補足する資料があればいい
48: 名無しさん。 2018/05/27(日) 14:15:58.84
請負でやる場合、要件定義や基本設計は完了していることが前提だけどな。
準委任契約で開発やってんのかね?
100: 名無しさん。 2021/08/13(金) 20:15:08.76
>>48
俺の勤め先は、詳細設計とプログラミングも準委任で契約するよう、社内で推奨してる。
リスク回避の為だと。
51: 名無しさん。 2018/06/11(月) 14:11:35.76
一応書いとかないと貰ったソースで謎のフラグが行ったり来たりしてカオスになるぞw
52: 名無しさん。 2018/06/11(月) 18:02:12.01
詳細設計書があればフラグの状態読めるのかよ
馬鹿か
53: 名無しさん。 2018/06/11(月) 23:30:14.94
変なフラグ作らせないためだろ
54: 名無しさん。 2018/06/12(火) 08:16:42.17
結局ソースと不一致で無意味だろ
馬鹿か
55: 名無しさん。 2018/06/12(火) 20:01:57.49
謎のフラグを使うのがNG
詳細設計書を作る暇があるなら
ソースレビューして叩きまくったほうが有意義
57: 名無しさん。 2018/06/13(水) 06:41:00.56
詳細設計書からソース自動作成される日も近い
67: 名無しさん。 2018/07/16(月) 12:04:15.57
>>57
これはもう実現されてる。
詳細設計書を特殊な言語で書かなきゃいけないけどな。

COBOLとかの特殊な言語で…

60: 名無しさん。 2018/06/13(水) 20:05:36.62
コードいじくりまわしているプログラマが一番気持ち悪い。
61: 名無しさん。 2018/06/13(水) 20:58:05.18
>>60
わいがコード職人やで
65: 名無しさん。 2018/06/28(木) 21:06:00.45
うちのシステム、設計書で5GBあるんだが
俺一度も開いたことないファイル山ほどあると思う
69: 名無しさん。 2018/07/17(火) 07:39:40.82
今やコードファーストがトレンドだろ
詳細設計ってコボラーかよw
70: 名無しさん。 2018/07/17(火) 16:40:30.55
ドキュメントがいらないといってるのは末端だからじゃないの?
ウォーターフォールで工程間の入れ替え考えたらその発想はあり得ないよ
72: 名無しさん。 2018/07/17(火) 20:45:50.43
ごめん、足りてないものがあった、Graphviz。
あとはGnu Globalが時々役に立つ事がある(バークレーDBの知識は必要だが)。
73: 名無しさん。 2018/07/18(水) 06:59:16.40
要件定義と基本設計さえ、しっかりしていればいい。
74: 名無しさん。 2018/07/18(水) 08:09:44.09
>>73
そういうのは小さいシステムだろ。大きなシステムでもプロトタイピング、スパイラルモデルを採用しないのは謎だが、あとから優秀な技術者が来ると思っているプロジェクトが多すぎる。

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です