基本設計書の読み方

基本設計書は、システムの外部仕様を定義したドキュメントです。「何を作るか」「ユーザーにどう見えるか」を記述します。

基本設計書とは

別名

基本設計書は、現場によって以下のような呼び方をされることがあります。

• 外部設計書
• 基本設計
• BD（Basic Design）

役割

flowchart LR
    A[要件定義書] -->|何を作るか| B[基本設計書]
    B -->|どう作るか| C[詳細設計書]
    C --> D[実装]

基本設計書は、要件定義書と詳細設計書の間に位置し、以下を定義します。

• システムの全体像（アーキテクチャ）
• ユーザーから見える部分の設計
• システムが何ができるか

視点の違い

基本設計書の構成要素

よくある構成

基本設計書は、以下のような構成で作られることが多いです。

【実践】基本設計書サンプルと読み方

ここからは、実際の基本設計書に近いサンプルを使って、具体的な読み方を解説します。

サンプル1：システム構成図

システム構成図は、システム全体のアーキテクチャを図示します。

flowchart TB
    subgraph ユーザー
        U1[PCブラウザ]
        U2[スマートフォン]
    end

    subgraph フロントエンド
        F1[Webサーバー<br>Nginx]
        F2[CDN<br>CloudFront]
    end

    subgraph バックエンド
        A1[APサーバー①<br>Spring Boot]
        A2[APサーバー②<br>Spring Boot]
        LB[ロードバランサー<br>ALB]
    end

    subgraph データ層
        DB[(データベース<br>PostgreSQL)]
        CACHE[(キャッシュ<br>Redis)]
    end

    subgraph 外部連携
        EXT1[決済サービス]
        EXT2[メール配信]
    end

    U1 --> F2
    U2 --> F2
    F2 --> F1
    F1 --> LB
    LB --> A1
    LB --> A2
    A1 --> DB
    A2 --> DB
    A1 --> CACHE
    A2 --> CACHE
    A1 --> EXT1
    A1 --> EXT2

この図から読み取るべきこと

サンプル2：機能一覧

機能一覧は、システムが持つ機能を一覧化します。

この一覧から読み取るべきこと

flowchart TD
    A[機能一覧] --> B{何を確認する？}
    B --> C[システムの全体像]
    B --> D[自分の担当機能]
    B --> E[機能間の関連]
    B --> F[優先度・スコープ]

    C --> G[全部でどのくらいの規模か]
    D --> H[どの機能を実装するか]
    E --> I[依存関係はあるか]
    F --> J[今期やる/やらないは何か]

サンプル3：画面一覧

画面一覧は、システムの全画面を一覧化します。

この一覧から読み取るべきこと

サンプル4：画面遷移図

画面遷移図は、画面間の遷移を図示します。

flowchart TD
    TOP[トップページ<br>SCR-001]
    REG[会員登録<br>SCR-002]
    LOGIN[ログイン<br>SCR-003]
    MYPAGE[会員情報<br>SCR-004]
    LIST[商品一覧<br>SCR-005]
    DETAIL[商品詳細<br>SCR-006]
    CART[カート<br>SCR-007]
    CONFIRM[注文確認<br>SCR-008]
    COMPLETE[注文完了<br>SCR-009]
    HISTORY[注文履歴<br>SCR-010]

    TOP --> REG
    TOP --> LOGIN
    TOP --> LIST
    LOGIN --> TOP
    LOGIN --> MYPAGE
    REG --> LOGIN
    LIST --> DETAIL
    DETAIL --> CART
    CART --> CONFIRM
    CONFIRM --> COMPLETE
    MYPAGE --> HISTORY

    style CART fill:#ffcccc
    style CONFIRM fill:#ffcccc
    style COMPLETE fill:#ffcccc

この図から読み取るべきこと

• 入口：どこからでもアクセスできる画面（トップ、商品一覧など）
• 流れ：ユーザーの主要な導線（商品一覧→詳細→カート→注文）
• 認証が必要な遷移：ログイン後しかアクセスできない画面

サンプル5：ER図（概念レベル）

基本設計書のER図は、詳細なカラム定義ではなく、エンティティ間の関係を示します。

erDiagram
    USER ||--o{ ORDER : places
    USER ||--o{ FAVORITE : has
    ORDER ||--|{ ORDER_DETAIL : contains
    ORDER_DETAIL }|--|| PRODUCT : refers
    FAVORITE }|--|| PRODUCT : refers
    PRODUCT }|--|| CATEGORY : belongs_to

    USER {
        ユーザーID PK
        メールアドレス
        氏名
    }
    ORDER {
        注文ID PK
        ユーザーID FK
        注文日時
        合計金額
    }
    PRODUCT {
        商品ID PK
        商品名
        価格
    }

この図から読み取るべきこと

基本設計書を読む流れ

flowchart TD
    A[1. システム構成図で全体を把握] --> B[2. 機能一覧で範囲を確認]
    B --> C[3. 画面一覧・遷移図で画面構成を理解]
    C --> D[4. ER図でデータ構造を把握]
    D --> E[5. 自分の担当範囲を特定]
    E --> F[6. 関連する詳細設計書を読む]

読む順番のポイント

1. 全体から詳細へ：まずシステム構成図で全体像を掴む
2. 機能の範囲を把握：機能一覧で「何ができるシステムか」を理解
3. 画面構成を理解：ユーザーの操作フローを把握
4. データ構造を把握：どんなデータを扱うか理解
5. 担当範囲を明確に：自分が実装する部分を特定

読むときのチェックリスト

読む前に確認すること

• [ ] バージョン：最新の設計書か確認したか
• [ ] 自分の担当範囲：どの機能/画面を担当するか明確か
• [ ] 前提知識：専門用語や略語を理解しているか

読んだ後に確認すること

• [ ] システムの全体像を説明できるか
• [ ] 主要な機能を列挙できるか
• [ ] 画面の流れを説明できるか
• [ ] データの関係を理解したか
• [ ] 不明点をリストアップしたか

よくある疑問

1年目エンジニアとしての関わり方

関連ドキュメント

• 設計書・仕様書の読み方 - 設計書全般の読み方
• 要件定義書の読み方 - 上流の要件定義
• 詳細設計書の読み方 - 詳細設計書の読み方
• 画面設計書の読み方 - 画面設計の詳細