設計書について教えてください。

Question

機能設計書を書くことになり、期限が明日までなのですが、
機能部品、共通部品とは、どんなことをかくのでしょうか。

共通部品には、DAOを書くのですか？

設計書が全く分からず、過去の設計書を参考にしても、共通部品にはDAOが書かれていてマネしても
酷評されてしまい...
どなたかお分かりになる方、いらっしゃいませんでしょうか。

Answer 1

直接の回答ではありません。

期限前日（しかももう少しで日付が変わる）時点でなぜそこで詰まっているのでしょうか。
どのようなスケジュール感で、現場や自身が進めてきたのか存じ上げませんが、
もっと早く何とかなったのでは？
現場には現場の仕様書の記載ルールがあります。
全くの他人に聞くのは違うと思います。

例え何かしら回答がついたとして、その通りに書いたとして「違う」となった場合、
回答者は責任はもてません。
「teratailの回答を参考にしたんです」と現場のリーダーに言い訳しますか？
（そのような自体を避けるため、直接の回答は得られないと思ってください）

同じ現場にいる人が回答者としていない限り（もしいても私なら知らんぷりします）は、
一番現場のことを知っているのは質問者さんであるはずです。
当件についてはどんなに不細工であろうと酷評されようと自身でなんとかするしかありません。
100％のものを作る必要はなく、レビューを重ねて精度を上げていくものだと思います。
※それすらも現場レベルで違うのでそこは現場を一番知っている質問者さんで判断してください

Comments

[退会済みユーザー]

一般的にどうなんだろうということがききたくて。
ありがとうございました。

[pepperleaf]

設計書って結構、ローカルルール多いですね。
で、大手になれば、なるほどコピペが流行る。
質問者さんの職場のルールが分からない以上、回答は難しいですね。
詳細を書くと、機密漏洩になるし、、と。

[m.ts10806]

一般的なものを求めてもその酷評は変わりませんよ。
現場には現場のルールがある。それが言ってしまえば「一般」です。
「質問してる暇があれば1行でも仕様書を書きましょう」これが一番言いたい（見てる人でそう突っ込みたい人も少なくはないはず）

[m.ts10806]

>pepperleaf さん
補足ありがとうございます。
郷に入れば郷に従うしかないですよね。現場現場で全く違いますし。
その酷評したレビュワーに「どう書けばいいですか」と指南仰ぐのが最も確実。
それで教えないのであれば、ほぼわかってない人にきちんと書けるような手順書や資料残してない現場が悪いです（あとそこまでできない人を入れているプロジェクトも悪いです）

[退会済みユーザー]

まだ新人研修中で。できなくて見放されそうで、いろいろインターネットで調べているのですが。
よさそうな記事も見つからなくて質問してしまいました。

[m.ts10806]

最近は結構長く新人研修やるんですね。
研修でやってるなら研修中に学んだことを大きく超えるような指示は出ないと思いますよ。学校の宿題と同じです。
「何かを真似しよう」じゃなく「学んできたことを生かそう」という考え方にシフトしてください。
その「何かを真似しよう」という手抜き心は成果物にあらわれて、見透かされます。

[退会済みユーザー]

設計研修に入ると、資料が少なく...

[m.ts10806]

ここでうだうだ言ってる時間が勿体ないと思ってください。
集中してない、気が散っているというところも成果物に現れます。

[退会済みユーザー]

"手抜き心は成果物にあらわれて" →　それを見透かされて酷評されたんだと思います。
設計関係は、何も教わっていないんですけど....難しいですね。

[退会済みユーザー]

頑張ります。

[m.ts10806]

そのような背景も前提も見ている側は知りません。（知ったこっちゃない、と表現したほうがいいかも）
酷評されたのは「真似しよう」というのが前面に出ていて、そこを見透かされたのでは？ということだったんですが、いまひとつ伝わっていないようで残念ですね。
大事なことは仕様書をきちんと完成させることであって、資料や過去の設計書を真似することではないはずですけどね。それでは参考書読みながらコピペコード書くのと変わりません。

ですから、私であればその数十文字を打つ暇を惜しんで設計書に集中します。teratailで（に限らず赤の他人に）聞くようなものではないと私の回答時点で気づいてほしかったですね。
他の方もコメントつけてくれたわけですし。

[m.ts10806]

新人研修で酷評されたからってどうなるってほどでもないので今のうちに失敗しとけばいいんじゃないでしょうか。
はじめからできる人なんていないわけですし。同期にできる人がいたとしても自分は自分なりにやるしかないので周囲の雑音なんか気にせず集中してやればいいだけですよ。
「何かの真似をしよう」という心だけ捨ててください。

[退会済みユーザー]

丁寧に回答していただいて、本当にありがとうございます。
集中して、設計書を作成します。

[m.ts10806]

teratail開かなくても良いかと。もうそのお礼言っている間も惜しんでくださいね。一応「解決済み」になってるんで。お礼とかその課題終わった後でいいです。