質問: プログラム設計書の書き方 僕は新人seです。 今、上司の方からあるシステムの基本設計書・システム設計書・プログラム設計書を作り、プログラミングまでしてから単体テスト・結合テストもやるように言われています。(全て1人で) おそらく経験のある方ならすぐにできてしまうようなシステムで、上司の方も勉強のために全てやらせているようです。 今、基本設計書・システム設計書まではなんとかできて、プログラム設計書の作成に取り掛かりたいのですが、初めての経験で実際のプログラム設計書には何をどのように書いているものなのかも全く見当もつかずにいるので全く何も書けません。 上司さんは今週忙しいようで 「来週見てあげるから自分で調べたりしてやってみて」 と言っています。 ですが、全く何もできずにいるのもイヤなので何かそれらしいものでも書いてみたいのですが...プログラム設計書とは何をどう書いてあるものなのでしょうか? 日本語が書いてあるのかプログラムが書いてあるものなのか... そういったところからわからないので少しでも何か教えていただきたいです。 宜しくお願いします。
回答: 明確な定義は無いし、記載する項目も会社やプログラムの作成基準ごとに異なります。 自社の製品の基本設計書・システム設計書・プログラム設計書があるのなら、そちらを参考にするのが良いです。 自分の会社では、プログラム設計書というものは無く、上流の工程から順に、システム設計、基本設計、詳細設計とかです。 必要ならば、途中に概要設計とか。 それだって、相手先の会社や組織での呼称や要求が異なるのなら、そちらに合わせて書きます。 -- > 実際のプログラム設計書には何をどのように書いているものなのかも全く見当もつかずにいるので全く何も書けません。 設計書を書くコツとしては、設計書はその後作成するテスト項目、テスト仕様書の元ネタになります。 結果的に、テストで設計内容を100%網羅できれば、それは良いプロジェクトだったって評価になります。 従って、テストできない内容を設計するのはやめた方が良いです。 あんまり意識しすぎると、仕様書というより設計条件を羅列した文書とかになりがちですが。