# 販売アシスト 1 号「母艦お局様」プロジェクト概要
**開発コード**: CMO-01 (Commercial Management Office - Version 1)
**最終更新日**: 2026/03/07
---
## 📋 プロジェクトドキュメント
| ドキュメント | 内容 | パス | 活用シーン | 更新頻度 |
| --- | --- | --- | --- | --- |
| [要件定義書](./docs/requirements.md) | 機能要件・非機能要件・アーキテクチャ定義 | 新機能開発時の要件確認
チームメンバーへの仕様共有
承認プロセスでの根拠資料 | 変更時 |
| [工程管理ガイド](./docs/engineering_management.md) | **工程管理フレームワーク**（活用方法明記） | 📝 スプリント管理・ステークホルダー報告
リスク管理・承認フロー定義
新規参入者へのオンボーディング資料 | 各スプリント完了時
⬅️ **優先的に参照** |
| [短期計画（Sprint）](./docs/short_term_plan.md) | **2 週間単位のタスクリスト**（CheckList） | 📋 次の週の仕事割り当て
実捗確認・チェックオフ管理
スプリントレビュー資料準備 | 各スプリント開始時 |
| [長期計画（Roadmap）](./docs/long_term_plan.md) | **3〜12 ヶ月目標**・マイルストーンロードマップ | 🎯 ベータ→正式版リリース道筋
チーム成長・人材獲得計画
機能拡張優先順位決定資料 | マイルストーン完了時 |
| [プロジェクト計画書](./docs/project_plan.md) | 統合計画書（承認用） | ステークホルダーレビュー
M1-M3 マイルストーン記録
リリース条件確認 | 各ステークホルダーレビュー時 |
**📚 ドキュメント活用法**:
- **新規参入者**: README → requirements.md → short_term_plan.md の順に読み進めて「何を」「なぜ」やるか理解
- **スプリント開始**: short_term_plan.md の未着手タスクリストを確認→アサイン・実装開始
- **ステークホルダー報告**: project_plan.md + long_term_plan.md で達成状況を説明資料として作成
- **リスク管理**: 発生事項は engineering_management.md に記録→チーム会議で対応策共有
- **バージョンアップ**: MAJOR バージョン時 → requirements.md の移行ガイド確認
---
## 🎯 コアコンセプト
販売アシスト 1 号は **オフライン単体で見積・納品・請求・レジ業務まで完結できる販売アシスタント** であり、オプション機能として **オンライン接続時に母艦「お局様」とデータ同期・バックアップ・監視を行う二層構造** を目指しています。
### コンセプト比較表
| モード | 目的 | 主な特徴 |
| --- | --- | --- |
| オフライン・スタンドアロン | 端末単体で全業務を完結 | SQLite に全データ保存、印影以外は非暗号化、AI などによる再利用も想定 |
| オンライン（システムオプション） | 母艦と接続しデータ交換・監視 | SSH/クラウドトンネル経由で同期、APK 寿命チェックやバックアップを遠隔制御 |
母艦「お局様」はブリッジ／モニタリング／バックアップに専念し、実務機能は販売アシスト 1 号側に集約する方針です。TV BOX を母艦に据える運用や、単一端末で両役割を兼務するシナリオも想定しています。
---
## 📝 ドキュメント管理ポリシー
ドキュメントを更新するタイミングと方針:
| 更新トリガー | 対象ドキュメント | 頻度 |
| --- | --- | --- |
| 機能実装完了 | README.md, project_plan.md | 直後 |
| 要件追加/修正 | requirements.md | 即座に |
| マイルストーン完了 | project_plan.md | フェーズ完了時 |
| リスク発生・対応策決定 | project_plan.md (リスク管理節) | 発生日 |
| アーキテクチャ変更 | README.md, requirements.md | 計画立案後 |
### 🔄 バージョン管理方針 (semver)
- `MAJOR`: バックワーズ互換性の破壊（DB スキーマ変更、API ラストメソッド等）
- `MINOR`: 新機能追加、可逆的変更、ドキュメント改善
- `PATCH`: バグ修正、パフォーマンス向上、セキュリティパッチ
**ルール**:
- MAJOR バージョンアップ時は `requirements.md` で移行ガイドを記載する
- ドキュメントは Git commit と同時に README に反映させる（例：`git commit -m "feat: XXX"` → README 更新）
### ✅ 承認フロー
1. ドキュメント作成・修正 (Plan Phase)
2. チームレビュー（必要に応じて）
3. 要件定義書 (`requirements.md`) の承認（CTO/管理母艦）
4. プロジェクト計画書 (`project_plan.md`) のマイルストーン登録
5. README.md にドキュメントリンク追加
**最終更新**: 2026/03/07
**バージョン**: 1.0 (Initial Release)
---
## 実装完了マスタ管理画面
Material Design テンプレートを使用した CRUD 機能を実装した以下の 5 マスタ管理画面が完成しました:
| 画面名 | ファイル名 | 主要機能 |
|--------|-------------|----------|
| 商品マスタ | `lib/screens/master/product_master_screen.dart` | 商品コード、名称、単価、在庫数の CRUD |
| 得意先マスタ | `lib/screens