# 基本設計とは

要件定義で決定した内容を、画面、出力する書類、データ、他のシステムとの連携、システムの構成として具体化する設計の工程です。工程を区分する開発では、この内容を基に詳細設計に移行します。

## 基本設計とは

基本設計は、要件定義で決定した機能と条件を、画面、出力する書類、データ、他のシステムとの連携、システムの構成として具体化する設計の工程です。
利用者や他のシステムに対する振る舞いの決定が中心なので、外部設計とも呼びます。
要件定義、設計、開発と工程を区分する開発では、画面のように利用者が直接理解できる部分の基本設計の後に、機能を実現するための詳細設計を実施します[^digital]。

たとえば受注管理のシステムなら、要件定義では、受注を登録して在庫を確保するという機能と、1日に数千件を処理するという条件を決定します。
基本設計では、受注の登録画面の項目と配置、在庫の不足時の表示、出荷指示書の様式、在庫管理のシステムへ送信するデータの項目と時刻を決定します。

詳細設計は、基本設計で決定した画面や連携の振る舞いを、個々の処理としてどう実装するかを具体化します。
工程を区分する開発では、利用部門は基本設計で画面や連携の振る舞いを確認し、開発チームは詳細設計で実装方法を具体化することが一般的です。

![要件定義で何を実現するかを決定し、基本設計で画面と連携の振る舞いを決定し、詳細設計で実装の方法を決定する3段階の図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-9b39281d93b6e5288e795ece3950d362bb0609d5fc734fc80fc9084f7703b52c.png)

## なぜ必要か

要件の記述だけでは、実装に必要な振る舞いが未定の部分があります。
その状態で開発を開始すると、入力させる項目やエラーの際の表示を開発者がその場で決定します。
その結果、利用部門の想定と異なる画面になることがあります。

基本設計では、画面、出力する書類、データの項目と意味を決定します。
他のシステムとデータを送受信する外部インタフェースや、夜間に一括で実行するバッチの内容も決定し、開発チームが要件定義との整合を確認してから開発に移行します[^digital]。
振る舞いを文書で確定しておくと、開発者がその場で決定する事項が減少し、関係者の間で同じ文書を基に確認できます。

![要件だけで開発すると開発者がその場で画面の振る舞いを判断し、基本設計で振る舞いを文書にすると利用部門と開発チームが同じ文書で確認できることを対比した図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-01ad8740c376c6adf07437cd6473376019874f9f6893d3edebd3dcc5740503e9.png)

## 基本設計で決定する内容

| 対象 | 決定する内容 |
|---|---|
| 画面 | 画面の一覧、画面遷移、項目と配置、入力の規則 |
| 出力する書類 | 請求書や出荷指示書など、システムが出力する書類の一覧、様式、出力の時期 |
| データ | データの項目と意味、保存の期間 |
| 外部インタフェース | 連携する相手のシステム、送受信するデータ、時刻と頻度 |
| バッチ | 夜間の集計や連携など、画面を伴わない処理の内容と実行の時期 |
| 非機能 | 性能、セキュリティ、障害時の対応を実現する構成 |

データやシステムの移行、運用、保守の設計も、開発チームが設計の工程で同時に計画します[^digital]。
サーバーの台数や冗長化の構成、停止から復旧までの目標時間の決定は、稼働後のクラウドの利用料と監視・復旧の体制の費用に直結します。
開発チームが案を作成し、費用を負担する利用部門や情シスも決定に参加します。

![基本設計で決定する画面、出力する書類、データ、外部インタフェース、バッチ、非機能の6つの対象を並列に示した図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-60fa9cd97897a0099587ad446f2ec0c955ddf79a9a2401ec9a264f93ffb00b5e.png)

## 利用部門が基本設計書で確認すること

基本設計書の確認では、画面を1枚ずつ確認するのではなく、業務の手順の順に確認します。

- 日常の業務、月末や年度末の業務、例外的な取引を、画面遷移の上で最後まで処理できるか
- 入力の項目が、現在の業務で使用する情報と一致しているか。不要な項目が増加していないか
- エラーの際の表示と次の操作が、業務の判断と一致しているか。受注管理の例なら在庫不足の際の表示
- 他のシステムとの連携の時刻が、締めの時刻や他部署の作業の時刻と整合しているか

画面の数が多い業務システムでは、文書だけで業務の欠落を判断するのは困難です。
主要な業務の流れについてはプロトタイプの画面で操作すると、確認しやすくなります。

![例外の取引まで画面を遷移できるか、項目が業務と一致するか、エラー後の次の操作、連携の時刻と締めという4つの確認の観点を示した図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-d2065645638af634b39c3ec237238a98d496e1a6ece31e1034aa349a23d6cce4.png)

## 効果・コスト・リスク

### 効果

- 開発の途中で利用部門の想定との違いが判明する事態を減少させる
- 画面、書類、連携の数と内容が確定し、開発の工数と期間の見積もりの材料になる
- 受け入れテストで要件と受け入れ基準に対応するテストを具体化する材料になる
- 後から生じた要望が、合意した範囲の内か外かを判定できる

### コストとリスク

- 設計の作成と同時に、利用部門、連携の相手、運用の担当者の確認に時間がかかる
- 合意の後に画面や項目を変更すると、変更の時点と範囲に応じて詳細設計、開発、テストの修正が発生する
- 利用が未定の画面や書類まで開発の対象に含めると、開発と保守の費用が増加する
- 文書の量が多いと、利用部門が内容を把握しないまま承認し、承認が形式だけになる
- 稼働後の改修のたびに基本設計書を更新しないと、文書と実際のシステムが乖離し、保守の担当者の仕様の調査に時間がかかる

![判明の遅れの減少と見積もりの材料という効果と、確認の時間、合意後の変更による修正、不要な画面の開発、形式だけの承認、稼働後の文書の乖離という費用とリスクを対比した図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-9f67df03e85b47cf44baecf53a0c1e94220a5ccb89ffa1432ca1e0cd1fdf0a3c.png)

## 基本設計書で詳細に記述する部分と簡潔にする部分

詳細に記述するのは、関係者の間で解釈に差が生じる部分、他のシステムとの取り決め、変更時に複数の機能の修正が必要になる部分です。
受注管理の例なら、在庫をどの時点で確保し、受注の取り消しでいつ戻すかは、在庫管理の担当と解釈に差が生じやすいため、開発チームが基本設計書に明記します。
入力欄の並び順のように、後から変更しても修正が画面1枚に限定される部分は、プロトタイプの画面と短い一覧で十分です。

既存の設計を流用できる小さな改修では、変更する箇所を中心に記録します。

アジャイル開発では、設計の内容に応じて要件の再検討が発生することを前提に進行します[^digital]。

![解釈に差が生じる部分、他のシステムとの取り決め、複数の機能に影響する部分は詳細に記述し、それ以外はプロトタイプと短い一覧で十分とする判断の流れの図](https://media.marketing.kdotdev-tunnel.org/glossary-basic-design-9211e884f6879faf0499c11cef015e5bcdcb5bacab053d0934691e068682d870.png)

## よくある誤解

### 基本設計書を承認したら変更できない

変更はできます。
変更の手続きを定めておき、費用と期間への影響を確認してから変更します。
口頭で合意した変更も記録し、受け入れテストの合否の基準に反映します。

### 基本設計は開発チームだけの作業である

基本設計書の作成の中心は開発チームですが、内容が業務に適合しているかは利用部門も確認します。
業務の例外や締めの時刻は、日常的に業務を担当する利用部門のほうが把握しているためです。

[^digital]: [デジタル・ガバメント推進標準ガイドライン](https://www.digital.go.jp/assets/contents/node/basic_page/field_ref_resources/e2a06143-ed29-4f1d-9c31-0f06fca67afc/d4e68a9b/20250619_resources_standard_guidelines_guideline_01.pdf)（デジタル庁、2025年5月）。第3編第7章 設計・開発
