joe/h-1.flutter.4

joe ff0fa2f745 feat: 工程管理ドキュメント作成・README に活用ガイドライン追加

- docs/engineering_management.md (工程管理フレームワーク)
- docs/short_term_plan.md (2 週間単位のタスクリスト)
- docs/long_term_plan.md (3〜12 ヶ月ロードマップ)
- README.md (ドキュメント活用方法の明記)

2026-03-07 16:56:31 +09:00

5.3 KiB

Raw Blame History

販売アシスト 1 号「母艦お局様」プロジェクト概要

開発コード: CMO-01 (Commercial Management Office - Version 1)
最終更新日: 2026/03/07

📋 プロジェクトドキュメント

ドキュメント	内容	パス	活用シーン
要件定義書	機能要件・非機能要件・アーキテクチャ定義	新機能開発時の要件確認チームメンバーへの仕様共有承認プロセスでの根拠資料	変更時
工程管理ガイド	工程管理フレームワーク（活用方法明記）	📝 スプリント管理・ステークホルダー報告リスク管理・承認フロー定義新規参入者へのオンボーディング資料	各スプリント完了時 ⬅️ 優先的に参照
短期計画（Sprint）	2 週間単位のタスクリスト（CheckList）	📋 次の週の仕事割り当て実捗確認・チェックオフ管理スプリントレビュー資料準備	各スプリント開始時
長期計画（Roadmap）	3〜12 ヶ月目標・マイルストーンロードマップ	🎯 ベータ→正式版リリース道筋チーム成長・人材獲得計画機能拡張優先順位決定資料	マイルストーン完了時
プロジェクト計画書	統合計画書（承認用）	ステークホルダーレビュー 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 更新）

✅ 承認フロー

ドキュメント作成・修正 (Plan Phase)
チームレビュー（必要に応じて）
要件定義書 (requirements.md) の承認（CTO/管理母艦）
プロジェクト計画書 (project_plan.md) のマイルストーン登録
README.md にドキュメントリンク追加

最終更新: 2026/03/07
バージョン: 1.0 (Initial Release)

実装完了マスタ管理画面

Material Design テンプレートを使用した CRUD 機能を実装した以下の 5 マスタ管理画面が完成しました:

画面名	ファイル名	主要機能
商品マスタ	`lib/screens/master/product_master_screen.dart`	商品コード、名称、単価、在庫数の CRUD
得意先マスタ	`lib/screens

5.3 KiB Raw Blame History Unescape Escape