rcp-add-01:アーキテクチャ設計書
目的
  • 対象システムのアーキテクチャ(基本構造、共通メカニズム等)をまとめ文書化します
  • 設計・実装における「共通の決まり事」を定義します
メタ情報
成果物関連

入力成果物リスト
前準備
  • これまでの分析結果やアーキテクチャ設計結果を入手・整理し、そららの理解を深めておきます
作成手順
No 作業 成果
1
  • 表紙に、システム名と履歴を記述します。
    • 最初は「バージョン:0.1 改訂内容:新規作成」に
  • 目次を確認します。
2
  • 「1.はじめに」の内容を記述します。
    • 本書の目的、参照資料/文献
  • 「2.概説」の内容を記述します。
    • アーキテクチャ要件、対象とする機能要件
    • アーキテクチャ設計方針、仮定と依存性
3
  • 「3.構造及び構成」の内容を記述します。
    • 物理配置図、実行環境
    • 基本構造、アプリケーション物理構造
    • システム基盤仕様(省略)
4
  • 「4.共通メカニズム」の内容を記述します。
    • 共通メカニズム全体図及び一覧
    • 個々の共通メカニズム
5
  • 「5.設計実装制約及び環境」の内容を記述します。
    • 設計・実装制約
    • 開発ツール・環境
  • 「6.配布」の内容を記述します。
    • 実行モジュール一覧
    • 実行モジュール内の構成(必要時)
    • 配布物一覧
  • 「7.その他」の内容を記述します。
6
  • 「付録」の内容を記述します。(省略)
    • ネットワーク仕様
    • データベースシステム仕様
    • クライアント・サーバー機器仕様
    • 分析クラス図
    • 分析シーケンス図
    • 論理構造図
7
  • アーキテクチャ設計書全体の内容に矛盾や漏れ・抜けがないかを確認します。
ワンポイント・アドバイス
  • 最初に、どのような要件(非機能要件)に対してどのようなアーキテクチャ設計方針にするかを十分に検討します
  • アーキテクチャ設計書の内容は、設計・実装が進むに従って検証・洗練・詳細されていく部分があります。最初は、入力成果物やこれまでの経験・一般的な情報を元に、一番妥当と考えられる内容にしておきます。
  • 不明点は必ずその旨(「TBD」)と記載しておきます。
チェック・ポイント
  • 個々の項目の内容は、各種要件やそれに基づくアーキテクチャ設計方針、分析結果と整合していますか?
  • 個々の項目の内容は、実装可能な内容になっていますか?
  • これまでの開発経験や一般的な情報との相違点がある場合、その根拠を示していますか?
  • アーキテクチャ設計書の読者にとって分かり易く、誤解を与えないような説明内容になっていますか?
参考情報

ソフトウェア年表もご覧下さい