【IT】正直詳細設計書いらないよね?【SE】

カテゴリ_プログラム
1: 非決定性名無しさん 2018/05/13(日) 05:09:12.66

全部要件定義で突っ込めばよくない?
インプットアウトプット、DBとか環境設定、処理の概要くらいはみたいけどほとんど使われない設計書を大量生産するのってアホみたい。

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

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

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

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

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

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

43: 非決定性名無しさん 2018/05/26(土) 19:24:45.21
>>1
逆だな。詳細設計がちゃんとできていればコーディングはあっと言う間に終わる。

 

2: 非決定性名無しさん 2018/05/13(日) 13:24:23.18
パラメータはどこで書くんだよ

 

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

 

29: 非決定性名無しさん 2018/05/14(月) 22:49:54.01
保守か開発かにもよるんじゃない?
開発だと遅延に遅延を重ねてとにかく早くやれって空気のとこ多いけど

 

31: 非決定性名無しさん 2018/05/15(火) 07:07:47.88
手動で画面ペタペタとって黙視確認とか何とかならんのかねぇ。。

 

32: 非決定性名無しさん 2018/05/15(火) 07:49:27.62
画面パチパチとって名前つけて保存するくらいならいいけど単体テストから全てのエビデンスとDBの記録をエクセルに貼り付けさせて体裁整えさせるとこあるし。単純にエクセルに貼り付けるって行為が時間かかりすぎるし無駄。まあでもその為の時間くれるならいいんじゃない?

 

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
マジレスすると規模がデカいプロジェクトだと詳細設計書は必須
あと、コードより図や一覧表の方が全体を理解しやすい
末端のエンジニアも全体が分からないと困る
詳細設計書を省く場合でもパラメータシートは必要

 

44: 非決定性名無しさん 2018/05/26(土) 19:53:41.42
ソースからAIが自動で作ってくれるようになるよ

 

45: 非決定性名無しさん 2018/05/26(土) 20:08:36.54
>>44
あのな、AIは人間が作るんだよ。

 

47: 非決定性名無しさん 2018/05/27(日) 07:19:56.81
基本設計書は客に納品することが多いからいるよね
詳細はなくていい
基本設計書で不足してる情報を補足する資料があればいい

 

48: 非決定性名無しさん 2018/05/27(日) 14:15:58.84
請負でやる場合、要件定義や基本設計は完了していることが前提だけどな。
準委任契約で開発やってんのかね?

 

50: 非決定性名無しさん 2018/06/11(月) 00:32:39.94
設計

 

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
詳細設計書を作る暇があるなら
ソースレビューして叩きまくったほうが有意義

 

58: 非決定性名無しさん 2018/06/13(水) 13:36:47.59
>>55
上司「お前らレビューする余裕あるなら人を貰ってくで~」

 

56: 非決定性名無しさん 2018/06/12(火) 20:42:19.74
Documents can lie.
Source code never lies.

 

57: 非決定性名無しさん 2018/06/13(水) 06:41:00.56
詳細設計書からソース自動作成される日も近い

 

60: 非決定性名無しさん 2018/06/13(水) 20:05:36.62
コードいじくりまわしているプログラマが一番気持ち悪い。

 

61: 非決定性名無しさん 2018/06/13(水) 20:58:05.18
>>60
わいがコード職人やで

 

62: 非決定性名無しさん 2018/06/14(木) 05:03:15.25
詳細設計書よりこのスレがいらなくね?

 

63: 非決定性名無しさん 2018/06/21(木) 20:18:57.79
開発の規模感次第じゃね?
俺んとこは2、3人で自社パッケージ製品開発だから全くドキュメントなし

 

65: 非決定性名無しさん 2018/06/28(木) 21:06:00.45
うちのシステム、設計書で5GBあるんだが
俺一度も開いたことないファイル山ほどあると思う

引用元

http://ikura.2ch.sc/test/read.cgi/infosys/1526155752/0-

管理人からひと言

詳細設計必要だけど、工数削る際になぜか詳細設計が削られることが多いイメージ・・・・

関連記事

  1. 【悲報】プログラマさん、「char型」の読み方で戦争を始める

  2. カテゴリ_software

    PHP勉強していてMySQLまで到達した例のニートの者だけど質問がある

  3. カテゴリ_プログラム

    【IT】プログラマーが正規表現を使いこなすメリットとは?

  4. C言語とえいご(英語でいうとEnglish)ってどっちがむずかしい?

  5. ブラウザゲーム作ろうと思う。JavaScriptフレームワークなにオススメ?

  6. Macでプログラミングする利点はない

  7. お前ら素人プログラマはオブジェクト指向分かってる振りしてるけど何も分かってないことはばれてるぞ

  8. printf “hello, world”;;

  9. 【IT】米Facebook、Python深層学習フレームワーク「PyTorch」の正式版を発表

コメント

  1. この記事へのコメントはありません。

  1. この記事へのトラックバックはありません。

最近の人気記事

おすすめ記事

  1. カテゴリ_hardware

新着記事

  1. プログラマーって実際めちゃくちゃきついん?
  2. プログラマー「めっちゃ頭いいです。休日も朝から晩まで勉強してます。でも平均年収3…
  3. 【衝撃】ITエンジニアぼく(27)、転職しただけで年収が460万円から970万円…
  4. 【企業】上司が部下を監視、「絶対やってはいけない」とマイクロソフトが警告
  5. Twitterで、外資ITコンサル転職したら単価75→350に上がったとか言って…

ボンブの戯言

  1. 【ボンブの戯言】ITエンジニアがフリーランスになるときに考える・準備すること
  2. 【ボンブの戯言】サーバーって何なの(オンプレに限る)
  3. 【ボンブの戯言】中古サーバーの買い方まとめました
  4. 【ボンブの戯言】フリーランスのメリットを全否定してみた
  5. 【ボンブの戯言】フリーランスの実態調査をITエンジニアフリーランスの視点から見て…
PAGE TOP