Issue #1「docs配下へのプロジェクトドキュメント再編」のステップ1成果物。
specs/配下の既存文書を棚卸しし、docs/配下のどこへ吸収するかの対応表を定義する。
この段階では本文の移植は行わない。 各文書の移行先・優先順・注意点を整理することが目的。
specs/ 配下の多くのファイルは、AI との対話で生成された「成果物」をそのまま保存したもので、本文の前後に ### **【成果物 N/11】** や ### **【更新提案】** といった会話の残骸が残っている。docs/ 化の際にはこれらを除去する。20_〜40_ の「実装手順書」は、コードブロックを丸ごと貼り付けた 実装指示書 の体裁になっている。docs/features/ へは生コピーせず、現在のシステムを説明する 機能ドキュメント として書き直す。*.sync-conflict-*.md が 3 件存在する。正規ファイルとの差分を確認し、必要な情報だけ吸収したうえで移行対象外とする。accounts / cart / common / dashboard / mg_customers / mg_masters / mg_orders / mg_workflow / orders / products / system_settings。03_基本設計書.md の記載と一致している（common は基本設計書に未記載）。| # | specs ファイル | 主な内容 | 移行先（docs） | 優先 | 備考 |
|---|---|---|---|---|---|
| 01 | 01_要件定義書.md |
システム目的・利用者・機能要件・非機能要件 (Ver.4.3) | docs/overview/システム概要.md, docs/overview/要件定義.md |
高 | ✅ 移行済み。markdownフェンス・更新提案ヘッダを除去し、機能/非機能要件を構造化。実装乖離(ダッシュボード発送系2件0固定/Issue #2/#3/#4/#5/#6/#7/#8/#9/#10)を注記しfeature docへリンク |
| 03 | 03_基本設計書.md |
システム構成・アプリ責務・機能一覧・画面一覧・主要ロジック (Ver.5.2) | docs/design/アーキテクチャ.md |
高 | ✅ 移行済み。common 追記・mg_*のネスト構造・追加モデルを実装と照合 |
| 04 | 04_データベース設計書.md |
テーブル定義・リレーション (Ver.2.2) | docs/design/データベース設計.md |
中 | ✅ 移行済み。ER_DIAGRAMと統合。型/選択肢/on_deleteを実装で訂正 |
| 05 | 05_画面遷移図.md |
画面遷移 (Ver.3.0) | docs/design/画面遷移.md |
中 | ✅ 移行済み。画面ID↔URLルート対応表化。精米管理/空袋在庫を追記 |
| 06 | 06_パッケージング管理画面 手動操作要件定義書.md |
パッケージングボードの手動操作要件 (Ver.2.0) | docs/features/出荷ワークフロー.md（一部） |
中 | ✅ 35 と統合して移行済み |
| 10 | 10_開発環境構築手順書.md |
Docker開発環境構築 (Ver.4.0) | docs/development/開発環境構築.md |
中 | ✅ 移行済み。Dockerfile/compose.dev/env.development/.dockerignore/settings と照合。icecream 非固定・dev は entrypoint 上書きで migrate 手動・env 読込経路・README 不在を注記 |
| 11 | 11_本番環境デプロイ手順書.md |
本番デプロイ手順 (Ver.4.0) | docs/operations/本番デプロイ.md |
低（最後） | ✅ 移行済み。docker-compose.yml/entrypoint.sh/env.production.template/settings と照合。本番DBはnamed volume(down -vで消去)・entrypoint自動化・makemigrations禁止・clear_orders破壊性を注記。SSH個別手順は一般化 |
| 20 | 20_アカウント・認証機能 実装手順書.md |
User/Destination・日本語ID認証 (Ver.3.0) | docs/features/アカウント認証.md |
中 | ✅ 移行済み。User/Destination・IgnoreSpaceModelBackend・CustomLoginViewのロール別リダイレクト・運用制約を照合 |
| 30 | 30_共通基盤設定 実装手順書.md |
settings・context_processors 等の共通基盤 (Ver.3.1) | docs/development/共通基盤.md |
中 | ✅ 移行済み。settings/cart・dashboard context_processors/common_extras/base.html と照合。bag_stock_summary の出荷追跡・ALLOWED_HOSTS の 0.0.0.0 追加・AUTHENTICATION_BACKENDS 反映を注記 |
| 31 | 31_商品・在庫・品種マスタ管理機能 実装手順書.md |
品種・商品・在庫マスタ (Ver.3.0) | docs/features/商品在庫マスタ.md |
中 | ✅ 移行済み。価格提案式/調整量更新/安全削除/一括操作/空袋在庫を実装と照合 |
| 32 | 32_購入者向け機能 実装手順書.md |
カート・注文・請求書PDF (Ver.3.2) | docs/features/購入者向け機能.md |
高（機能の起点） | ✅ 移行済み。参考送料の梱包シミュレーション/provisional_shipping_fee保存等、specより進んだ実装に合わせ訂正 |
| 33 | 33_管理者向け注文管理機能 実装手順書.md |
注文一覧・受付・編集 (Ver.3.2) | docs/features/注文管理.md |
中 | ✅ 移行済み。複合フィルタ/編集の在庫チェック/送料リセットを照合。管理者側お届け先変更制御はIssue #4、顧客側の新規注文時お届け先変更UIはIssue #5で整理済み |
| 34 | 34_管理者向け顧客管理機能 実装手順書.md |
顧客・お届け先CRUD (Ver.3.0) | docs/features/顧客管理.md |
中 | ✅ 移行済み。検索/ソート/累計金額集計・お届け先ソフトデリート・各API・パスワード再設定を照合 |
| 35 | 35_管理者向け出荷ワークフロー機能 実装手順書.md |
袋詰・自動引当ボード・発送管理 (Ver.3.1) | docs/features/出荷ワークフロー.md |
中 | ✅ 移行済み。袋詰/精米/パッケージングAPI群/自動梱包アルゴリズム/発送・B2連携/送料確定を実装と照合。06統合 |
| 36 | 36_管理者向け補助機能 実装手順書.md |
データ移行・オンラインマニュアル等 (Ver.3.0) | docs/features/管理者向け補助機能.md |
中 | ✅ 移行済み。ダッシュボードToDo(発送系2件は0固定)/デバッグ/破壊的データ移行/マニュアル管理を照合 |
| 40 | 40_送料計算モデル変更 実装手順書.md |
参考送料・確定送料モデル (Ver.1.5) | docs/features/送料計算.md |
中 | ✅ 移行済み。参考(梱包シミュレーション)/確定(全Package)二系統・リセット契機・表示を横断集約 |
| 41 | 41_本番データ移行用管理コマンド 実装手順書.md |
マイグレーション管理・データ移行コマンド (Ver.2.0) | docs/operations/データ移行.md |
低（最後） | ✅ 移行済み。マイグレーションGit管理ルール・import_old_data_view(破壊的全置換,Issue #9で動作不可)・clear_orders・mysqldumpバックアップを照合 |
| 60 | 60_補足資料.md |
カスタム管理コマンド・静的資産・admin設定 | docs/development/補足資料.md |
低 | ✅ 移行済み。各admin.py/packaging_snapshot/clear_orders(spec未記載)/IPAexフォント/Sortable(未参照)/404/.dockerignore と照合。orders adminのpayment_status・Stock admin拡張・Sortable未参照を注記 |
| ER | ER_DIAGRAM.md |
Mermaid ER図・主要ワークフロー | docs/design/データベース設計.md（統合） |
中 | ✅ 04 と統合済み |
| ファイル | 対応する正規ファイル | 方針 |
|---|---|---|
35_管理者向け出荷ワークフロー機能 実装手順書.sync-conflict-20251013-085025-GYLYR7T.md |
35_...md |
差分確認後、必要情報のみ吸収し移行対象外 |
40_送料計算モデル変更 実装手順書.sync-conflict-20251020-090321-GYLYR7T.md |
40_...md |
同上 |
60_補足資料.sync-conflict-20251013-085026-GYLYR7T.md |
60_補足資料.md |
✅ 差分確認済み。正規版より古い版(system_settings admin の display_name_link 未反映)で吸収すべき追加情報なし。移行対象外 |
docs/
├── README.md # ドキュメント入口・目次
├── overview/ # システム概要・要件（利用者視点の入口）
│ ├── システム概要.md
│ └── 要件定義.md
├── design/ # 設計（開発者視点）
│ ├── アーキテクチャ.md
│ ├── データベース設計.md
│ └── 画面遷移.md
├── features/ # 機能別仕様（読者別に再構成）
│ ├── 購入者向け機能.md
│ ├── 商品在庫マスタ.md
│ ├── 注文管理.md
│ ├── 顧客管理.md
│ ├── 出荷ワークフロー.md
│ ├── 送料計算.md
│ ├── アカウント認証.md
│ └── 管理者向け補助機能.md
├── development/ # 開発者向け（環境・基盤）
│ ├── 開発環境構築.md
│ ├── 共通基盤.md
│ └── 補足資料.md
└── operations/ # 運用者向け（最後に検証込みで作成）
├── 本番デプロイ.md
└── データ移行.md
docs/ 配下にあるspecs/ ファイルを文末または関連欄に記録しているwiki_sync(dry_run=true) で同期対象として確認できる元資料: specs/ 配下全ファイル（2026-06-14 時点）
関連: Issue #1, docs/README.md