基本設計について

概要

基本設計（外部設計）は、要件定義の成果物をもとに、システムの全体像や構造を設計するフェーズ。ユーザーから見える部分（外部仕様）を中心に、「何を作るか」を明確にする。

システム全体のインフラ・アーキテクチャを視覚的に表現する図。

記載内容
- アプリケーションサーバー、DBサーバー、キャッシュサーバーなどの配置
- ネットワーク構成（VPC、サブネット、ロードバランサー）
- 外部システムとの連携（決済API、メール配信、認証プロバイダなど）
- CDN、ストレージ（S3等）の配置
- 通信プロトコル（HTTPS、gRPC、WebSocketなど）
ポイント
- 各コンポーネント間の通信方向と通信方式を矢印で明示する
- 本番環境・ステージング環境の差異がある場合は環境ごとに作成する
- クラウドサービスを利用する場合は、使用するマネージドサービス名を記載する

ユーザーが操作する画面の構成・遷移・レイアウトを定義する。

画面一覧
- 画面ID、画面名、URL（パス）、認証要否、対応する機能
- 例: SCR-001 | ログイン画面 | /login | 不要 | ユーザー認証
画面遷移図
- 画面間の遷移を矢印で表現し、遷移条件（ボタン押下、ステータス変更等）を記載
- 正常系だけでなく、エラー時の遷移先も定義する
ワイヤーフレーム
- 各画面のレイアウト（ヘッダー、フッター、メインコンテンツ、サイドバー）
- 入力フォームの項目（項目名、入力種別、必須/任意）
- ボタン・リンクの配置と押下時のアクション
- レスポンシブ対応が必要な場合はブレイクポイントごとのレイアウト

システムが提供するすべての機能を一覧化し、スコープを明確にする。

記載内容
- 機能ID、機能名、機能概要、対応画面、優先度
- CRUD区分（どのデータに対して何の操作を行うか）
- 対応するユースケースや要件ID（トレーサビリティ）

例

機能ID	機能名	概要	対応画面	CRUD
FNC-001	ユーザー登録	メールアドレスとパスワードで新規登録	SCR-002	Create
FNC-002	ログイン	認証情報を検証しセッションを発行	SCR-001	Read

データの構造とエンティティ間の関係を定義する。物理的な実装詳細は含まない。

システムが外部に公開するインターフェース、または外部から呼び出すインターフェースを定義する。

エンドポイント一覧
- メソッド（GET/POST/PUT/DELETE）、パス、概要、認証要否
リクエスト/レスポンスの概要
- 主要なパラメータ名と概要（詳細な型定義は詳細設計で行う）
- 正常時のレスポンス構造（概要レベル）
- 主なエラーレスポンス（4xx、5xx）
例

メソッドパス概要認証
POST /api/users ユーザー新規登録不要
GET /api/users/:id ユーザー情報取得必要
PUT /api/users/:id ユーザー情報更新必要

定期実行やトリガー実行されるバッチ処理の概要を定義する。

記載内容
- バッチID、バッチ名、処理概要
- 実行タイミング（cron式、トリガー条件）
- 入力データ（参照元テーブル、外部ファイルなど）
- 出力データ（更新先テーブル、出力ファイルなど）
- 想定データ件数、処理時間の目安
- 排他制御の方針（多重実行の可否）

例

バッチID	バッチ名	実行タイミング	概要
BAT-001	日次集計バッチ	毎日 02:00	前日の売上データを集計テーブルに反映
BAT-002	メール送信バッチ	5分ごと	送信キューのメールを一括送信

機能以外のシステム品質に関する要件を定義する。

性能要件
- レスポンスタイム目標（例: 画面表示 2秒以内、API応答 500ms以内）
- スループット（例: 同時接続 1,000ユーザー）
- データ量の見積もり（初期データ量、年間増加量）
可用性要件
- 稼働率目標（例: 99.9%）
- 計画停止の許容範囲、メンテナンスウィンドウ
- 障害時の復旧目標（RTO/RPO）
セキュリティ要件
- 認証方式（OAuth2.0、JWTなど）
- 認可モデル（RBAC、ABACなど）
- データ暗号化（通信時、保存時）
- 監査ログの要件
運用・保守要件
- ログ出力方針（ログレベル、保存期間）
- 監視項目（CPU、メモリ、エラーレート、レスポンスタイム）
- バックアップ方針（頻度、世代管理、リストア手順）
- デプロイ方式（Blue-Green、ローリング、カナリア）