基本設計書の読み方

基本設計書とは

別名

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

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

役割

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

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

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

視点の違い

基本設計書の構成要素

よくある構成

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

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

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

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

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

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

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

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

    subgraph データ層
        DB[(データベース
PostgreSQL)]
        CACHE[(キャッシュ
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[トップページ
SCR-001]
    REG[会員登録
SCR-002]
    LOGIN[ログイン
SCR-003]
    MYPAGE[会員情報
SCR-004]
    LIST[商品一覧
SCR-005]
    DETAIL[商品詳細
SCR-006]
    CART[カート
SCR-007]
    CONFIRM[注文確認
SCR-008]
    COMPLETE[注文完了
SCR-009]
    HISTORY[注文履歴
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 {
        int user_id PK
        string email
        string name
    }
    ORDER {
        int order_id PK
        int user_id FK
        datetime order_date
        decimal total_amount
    }
    PRODUCT {
        int product_id PK
        string product_name
        decimal price
    }

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

基本設計書を読む流れ

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

読む順番のポイント

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

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

読む前に確認すること

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

読んだ後に確認すること

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

よくある疑問

Q: 基本設計書がない場合は？

A: 要件定義書や既存のコードから読み取る必要があります。

• 小規模プロジェクトでは省略されることがある
• 既存システムの改修では、コードがドキュメント代わりになることも
• 不明点は先輩に確認しましょう

Q: 基本設計書と詳細設計書、どちらを先に読む？

A: 基本設計書を先に読みます。

全体像を把握してから、詳細に入ります。いきなり詳細設計書を読んでも、「なぜこうなっているか」が分かりません。

Q: 設計書が古い場合は？

A: 現状のコードと照らし合わせ、差分を確認します。

設計書が最新でないことはよくあります。差分があれば先輩に確認し、どちらが正しいか判断を仰ぎましょう。

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

関連ドキュメント

• 設計書・仕様書の読み方
• 要件定義書の読み方
• 詳細設計書の読み方
• 画面設計書の読み方