詳細設計書

基本設計書と詳細設計書の境界は、日本のSIで最も曖昧なところです。そのまま作ると基本設計書の焼き直しか、パラメータシートの劣化版になります。この型では「基本設計書＝方式と方針／詳細設計書＝★設計判断とその根拠、および設定値では表せない動作／パラメータシート＝実際の設定値」と境界を置き、その表を1章に入れました。中核は2章の設計判断の一覧で、論点・採用案・却下案・理由を残します。5章は動作を★正常時／片系障害時／復旧時の3状態で書かせ、忘れられやすいフェイルバックを構造として持たせています。責任分界点・制約事項・要件IDのトレース表つき。

設定値そのもの（IPアドレス・ホスト名・各種パラメータ）は本書に書かず、パラメータシートに書いてください。同じ値を2つの文書に書くと、変更時に必ず片方が古くなります。本書に書くのは「その値にした理由」と「設定値では表せない動作」です。★設計判断には却下案まで書いてください。これが無いと、次に変更を検討する人が同じ比較をもう一度やることになります。「なんとなくこちらにした」しか書けない論点は、まだ判断していないということです。★動作は正常時・片系障害時・復旧時の3つの状態で書いてください。正常系だけを設計して異常時が抜けるのが最も多く、特に復旧時（フェイルバック）は忘れられます。自動で戻るのか人が戻すのかを必ず決めてください。「片系障害時」には劣化の程度（帯域・使用率・切れるもの）を数字で書いてください。「継続する」だけだと、劣化したまま気づかずに次の障害を迎えます。責任分界点は、どちら側かが判断できる物理的な点（ポート・コネクタ・IPアドレス）で切ってください。実現しないことも明記してください——書かないと「できるはず」と思われたまま試験に入ります。