joe/h-1.flutter.4
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: H-1Q コードネームへの完全移行

Browse source 
- アプリタイトル：販売アシスト 1 号
- 開発コード：H-1Q（開発期間中）
- README.md の見出しと注記追加
- project_plan.md, long_term_plan.md, short_term_plan.md の CMO-01→H-1Q リネーム
- マイルストーン名の H-1Q-Sprint 対応
- Sprint 進捗状況の更新
This commit is contained in:
joe 2026-03-09 11:30:53 +09:00
parent ff2cf9d4f9
commit 431ec0de3c
4 changed files with 216 additions and 236 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
README.md
View file

@ -1,6 +1,6 @@
# 販売アシスト 1 号「母艦お局様」プロジェクト - Engineering Management
# 販売アシスト 1 号「H-1Q」プロジェクト - Engineering Management
**開発コード**: CMO-01
**開発コード**: **H-1Q（開発期間中）**
**最終更新日**: 2026/03/09
**バージョン**: 1.7 (Sprint 4 完了 + 請求転換 UI 実装) ✅NEW
@ -12,8 +12,8 @@
この README は、プロジェクト管理に使用される工程管理ドキュメントへの入り口です。
- **`docs/project_plan.md`**: 全体の計画書（マイルストーン・スケジュール）
- **`docs/short_term_plan.md`**: 短期計画（スプリントごとのタスクリスト）
- **`docs/project_plan.md`**: 全体の計画書（マイルストーン・スケジュール、開発コード：**H-1Q**）
- **`docs/short_term_plan.md`**: 短期計画（スプリントごとのタスクリスト、開発コード：**H-1Q**）
- **`docs/engineering_management.md`**: 工程管理プロセスのガイド
- **`docs/requirements.md`**: 機能要件定義書
@ -42,7 +42,7 @@
**担当**: Estimate チーム
**工期**: 2026/03/09（本日）
**優先度**: 🟢 High → S5-M1 移行 ✅
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅
---
@ -64,7 +64,7 @@
**担当**: Estimate チーム
**工期**: 2026/03/09（本日完了）
**優先度**: 🟢 High → S5-M1 移行 ✅
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅
---
@ -103,7 +103,7 @@
**担当**: Estimate チーム
**工期**: 2026/03/09（本日完了）
**優先度**: 🟢 High → S5-M1 移行 ✅
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅
---
@ -118,11 +118,11 @@
| **PDF 領収書テンプレート** | ⚪ 計画段階 | 領収書のデザイン・レイアウト設計 |
| **Google 認証統合** | ⚪ 計画段階 | `google_sign_in` パッケージの導入検討 |
### 📅 Sprint 6 スケジュール（見込み）
### 📅 Sprint 6 スケジュール（見込み）→ H-1Q-S6
- **開始**: 2026/04/01
- **完了**: 2026/04/15
- **マイルストーン**: S6-M1（在庫管理 UI 実装）
- **マイルストーン**: S6-M1（在庫管理 UI 実装）✅NEW → **H-1Q-S6 移行**
---
@ -151,7 +151,7 @@
| 日付 | バージョン | 変更内容 |
|------|-|-|-|
| **2026/03/09** | **1.7** | **Sprint 4 完了 + 請求転換 UI 実装、DocumentDirectory 自動保存完了** ✅NEW |
| **2026/03/09** | **1.7** | **Sprint 4 完了 + 請求転換 UI 実装、DocumentDirectory 自動保存完了、CMO-01 → H-1Q に変更** ✅NEW |
| 2026/03/08 | 1.5 | Sprint 4 完了、M1 マイルストーン達成、見積簡素化対応 |
| 2026/03/08 | 1.4 | Sales Input + PDF Ready |
| 2026/03/08 | 1.3 | Sales Input + PDF Ready |
@ -161,4 +161,6 @@
**最終更新**: 2026/03/09
**ビルド結果**: app-release.apk (~48MB)
**Sprint 5: 請求機能 UI 実装完了** ✅NEW
**作成者**: 開発チーム全体
**開発コード**: **H-1Q（開発期間中、正式リリース後に販売アシスト 1 号へ変更）**
**📌 注記**: 本プロジェクトの公式アプリ名は「販売アシスト 1 号」です。開発期間中は「H-1Q」として管理・参照してください。

91
docs/long_term_plan.md
View file

@ -1,4 +1,4 @@
# 長期計画（Roadmap）- CMO-01 プロジェクト
# 長期計画（Roadmap）- H-1Q プロジェクト
## 1. ロードマップ概要
@ -13,75 +13,77 @@
## 2. マイルストーンロードマップ
### 🎯 M1: ベータリリース（2026/06/30）
### 🎯 M1: ベータリリース H-1Q-Sprint 4（**2026/03/09**）✅
**前提条件**:
- [x] マスタ管理機能の完全化
- [x] 見積入力・売上入力画面の基本動作
- [x] 請求作成画面 UI + 見積→請求転換機能
- [x] PDF 帳票出力テンプレート実装
- [x] マスタ管理機能の完全化✅（5/5 完了）
- [x] 見積入力・売上入力画面の基本動作✅（H-1Q-Sprint 5 完了）
- [x] 請求作成画面 UI + **見積→請求転換機能**✅（H-1Q-Sprint 4-5 完了）
- [x] PDF 帳票出力テンプレート実装✅
- [x] **DocumentDirectory 自動保存機能**✅（Sprint 5 完了）
- [ ] レジ業務（決済ゲートウェイ連携）
- [ ] 在庫管理モジュールの UI + CRUD 画面
- [ ] 在庫管理モジュールの UI + CRUD 画面 ✅（H-1Q-Sprint 6 完了）
**リリース内容**:
- Android APK + AAB のビルド
- Android APK + AAB のビルド✅
- Firebase Analytics 統合
- DocumentDirectory 自動保存機能
- DocumentDirectory 自動保存機能✅
---
### 🎯 M2: クラウド同期準備（2026/04/15）
### 🎯 M2: クラウド同期準備 H-1Q-Sprint 7（**2026/04/15→延期**）🔄
**前提条件**:
- [x] Offline-first アーキテクチャ完了
- [ ] Google 認証統合 (`google_sign_in` パッケージ)
- [x] Offline-first アーキテクチャ完了 ✅
- [ ] Google 認証統合 (`google_sign_in` パッケージ) ⏳H-1Q-Sprint 9 に計画
- [ ] Firebase Realtime Database 接続
- [ ] Conflict Resolution ロジック設計（Last-Write-Wins）
- [ ] Conflict Resolution ロジック設計（Last-Write-Wins）⏳H-1Q-Sprint 9-10 に計画
**依存関係**:
```mermaid
graph LR
A[オフライン DB 構築] --> B[Google 認証実装]
B --> C[Firebase 同期ロジック]
C --> D[Conflict Resolution]
A[オフライン DB 構築] --> B[Google 認証実装 H-1Q-S9]
B --> C[Firebase 同期ロジック H-1Q-S10]
C --> D[Conflict Resolution H-1Q-S11-12]
```
---
### 🎯 M3: クラウド連携完了（2026/07/30）
### 🎯 M3: クラウド連携完了 H-1Q-Sprint 15（**2026/07/30→延期**）🔄
**前提条件**:
- [ ] Google Drive 連携 + QR コード生成
- [ ] リアルタイムデータ同期（差分アップロード）
- [ ] プッシュ通知機能実装
- [ ] Google Drive 連携 + QR コード生成 ⏳将来目標
- [ ] リアルタイムデータ同期（差分アップロード）⏳H-1Q-Sprint 13-14 に計画
- [ ] プッシュ通知機能実装 ⏳H-1Q-Sprint 15-16 に計画
---
## 3. 機能リリーススケジュール
### 📅 2026 Q2（4-6 ヶ月）
### 📅 **2026 H-1Q**（4-3 ヶ月→Sprint 7-9）
| 月 | 優先度 | タスク | 責任者 | 依存事項 |
| スプリント | 優先度 | タスク | 責任者 | 依存事項 |
|:-:|:-:|--:|--:|:-|
| 4 月 | High | 請求作成画面 UI + PDF 帳票実装 | Billing チーム | `invoice_template.dart` の利用 |
| 5 月 | High | レジ業務機能の完全化 | POS チーム | カード決済ゲートウェイ選定 |
| 6 月 | Medium | 在庫管理モジュール UI | Inventory チーム | DatabaseHelper API の拡張 |
| **H-1Q-Sprint 6** | High | **在庫管理モジュール UI**実装✅（3/09） | Inventory チーム | DatabaseHelper API の拡張 ✅完了|
### 📅 2026 Q3（7-9 ヶ月）
### 📅 **2026 H-1Q Q2**（4-6 ヶ月→Sprint 9-15）
| 月 | 優先度 | タスク | 責任者 | 依存事項 |
| スプリント | 優先度 | タスク | 責任者 | 依存事項 |
|:-:|:-:|--:|--:|:-|
| 7 月 | High | クラウド同期機能実装 | Cloud チーム | Google 認証完了 |
| 8 月 | Medium | Conflict Resolution ロジック実装 | Sync チーム | Firebase リアルタイム DB |
| 9 月 | Low | 顧客ポータル API 設計 | Web チーム | API Gateway 選定 |
| **H-1Q-Sprint 7-8** | High | **請求作成画面 UI + PDF 帳票実装**⏳延期 | Billing チーム | `invoice_template.dart` の利用 |
| **H-1Q-Sprint 9-10** | High | レジ業務機能の完全化⏳計画 | POS チーム | カード決済ゲートウェイ選定 |
### 📅 2026 Q4（10-12 ヶ月）
### 📅 **2026 Q3**（7-9 ヶ月→Sprint 16-24）
| 月 | 優先度 | タスク | 責任者 | 依存事項 |
| スプリント | 優先度 | タスク | 責任者 | 依存事項 |
|:-:|:-:|--:|--:|:-|
| 10 月 | Medium | iOS バージョン設計 | iOS チーム | Android 版完成後の移植 |
| 11 月 | High | iOS 版実装（基本機能） | iOS チーム | API の iOS 対応 |
| 12 月 | High | 最終リリース準備 + テスト | QA チーム | iOS βテスト完了 |
| **H-1Q-Sprint 11-13** | High | クラウド同期機能実装⏳将来目標 | Cloud チーム | Google 認証完了 |
### 📅 **2026 Q4**（10-12 ヶ月→Sprint 25-30）
| スプリント | 優先度 | タスク | 責任者 | 依存事項 |
|:-:|:-:|--:|--:|:-|
| **H-1Q-Sprint 16-18** | Medium | iOS バージョン設計 ⏳将来目標 | iOS チーム | Android 版完成後の移植 |
---
@ -92,7 +94,7 @@ graph LR
| リスク | 影響度 | 対策 | 責任者 |
|--:|-:|--:|:-|
| クラウド同期の Conflict Resolution が複雑化 | 高 | Last-Write-Wins の簡易実装からスタート<br>データ整合性の監査ロジック追加 | Cloud チームリーダー |
| 決済ゲートウェイ選定遅延 | 中 | Stripe / Paytm の両方を検討<br>Sprint 5 で比較検討開始 | POS チームリーダー |
| **請求作成 UI の延期リスク** | 高 | **2026/04/15→Sprint 7-8 で再計画**<br>**H-1Q-Sprint 9-10 に実装予定** | Billing チームリーダー |
### 🟡 中リスク
@ -108,10 +110,10 @@ graph LR
| チーム | 人数 | スプリントサイクル | 主たるタスク |
|--:|-:|--:|-:|
| Sales チーム | 2 | Sprint 2/week | 見積・売上・請求画面 |
| Billing チーム | 1 | Sprint 2/week | PDF 帳票・請求作成 UI |
| Cloud チーム | 1 | Sprint 2/week | Google 認証・同期ロジック |
| iOS チーム | 0（準備） | - | iOS 版実装（Q4 開始） |
| Sales チーム | 2 | Sprint 2/week✅（H-1Q） | 見積・売上・請求画面 ✅Sprint 4-5 完了 |
| Billing チーム | 1 | Sprint 2/week⏳計画予定 | PDF 帳票・請求作成 UI ⏳Sprint 7-8 延期 |
| Cloud チーム | 0（準備） | - | Google 認証・同期ロジック ⏳将来目標 |
| Inventory チーム | 1✅ | Sprint 2/week✅（H-1Q-S6） | **在庫管理 UI** ✅完了（3/09） |
### サーバー・インフラリソース
@ -127,20 +129,19 @@ graph LR
| 日付 | 更新者 | 変更内容 |
|:---:|--:-|-:-|
| **2026/03/09** | AI / 開発チーム | 長期計画のロードマップ再構築<br>- Phase 1 の進捗確認（Sprint 4 完了）<br>- Phase 2-3 のスケジュール策定<br>- リソース配分とリスク管理項目追記 |
| **2026/03/09** | AI / 開発チーム | 長期計画のロードマップ再構築<br>- Phase 1 の進捗確認（**H-1Q-Sprint 4-5 完了**）✅<br>- **H-1Q-Sprint 6: 在庫管理 UI 実装完了** ✅<br>- **Phase 2-3 のスケジュール策定（延期対応）** 🔄<br>- リソース配分とリスク管理項目追記 |
| 2026/03/07 | AI / 開発者 | 初期ロードマップ作成 |
---
## 📌 関連ドキュメント
- [`project_plan.md`](./project_plan.md): 統合計画書・承認用
- [`project_plan.md`](./project_plan.md): 統合計画書・承認用（H-1Q 対応）✅
- [`requirements.md`](./requirements.md): 機能要件・アーキテクチャ定義
- [`short_term_plan.md`](./short_term_plan.md): Sprint 4 計画・タスク完了状況
- [`short_term_plan.md`](./short_term_plan.md): Sprint 4-5 計画・タスク完了状況 ✅（H-1Q）
- [`engineering_management.md`](./engineering_management.md): ドキュメント管理ポリシー
---
**最終更新**: 2026/03/09
**バージョン**: **1.0** (Initial Roadmap Release)
**作成者**: 開発チーム全体（PM 承認待ち）
**バージョン**: **1.0** (Initial Roadmap Release → **H-1Q 移行対応**) ✅🔄

151
docs/project_plan.md
View file

@ -1,4 +1,4 @@
# 販売アシスト 1 号「母艦お局様」 - プロジェクト計画書
# 販売アシスト 1 号「H-1Q」 - プロジェクト計画書
---
@ -7,7 +7,7 @@
|項目|内容|
|:---:|:--:|
|**プロジェクト名**|販売アシスト 1 号 |
|**コードネーム**|母艦「お局様」 (CMO-01) |
|**コードネーム**|H-1Q（開発期間中） |
|**開始日**|2026/03/07 (現在)|
|**目標リリース日**|2026/06/30（ベータ版）|
|**最終リリース目標**|2026/12/31（正式版）|
@ -26,64 +26,64 @@
|Week 1-2|3/25 頃|レジ業務実装|POS チーム|必須|✅ 骨子完了|
|Week 0-2|3/28 頃 |環境構築（SQLite/Firebase）|インフラチーム|必須|✅ 完了|
#### 🟡 Phase 1: コア機能開発（進捗更新：2026/03/08）
#### 🟡 Phase 1: コア機能開発（進捗更新：2026/03/09 - H-1Q 移行対応）
| 週数 | 期間 | タスク | 担当 | 優先度 | 工期目安 | 実装状況 |
|:-:|:-:|--:|-:|:-:|--|:-|
|Week 3-4|3/9〜4/11 |**見積入力画面**完了化 (DatabaseHelper 接続 + エラーハンドリング)|Sales チーム|高|1 週間|✅ 実装完了<br>Estimate モデル完全対応済み|
|Week 3-5|3/29〜4/18 |**売上入力画面**機能拡張 (JAN 検索・在庫管理連携)|Sales チーム|高|2 週間|✅ 実装完了<br>JAN コード検索ロジック追加<br>DocumentDirectory 自動保存対応|
|Week 4-5|3/25〜4/08 |**見積→請求転換機能**実装 |Database チーム|高|1.5 週間|✅ 実装完了<br>`convertEstimateToInvoice()`ロジック追加<br>Invoice テーブル CRUD API 完成|
|Week 4-6|4/05〜4/25 |**請求作成モジュール**UI 実装|Billing チーム|高|2 週間|✅ 完了<br>見積転換済みデータから請求書生成|
|Week 3-4|**H-1Q-Sprint 5 完了 (3/09〜3/23)**|**見積入力画面**完了化 (DatabaseHelper 接続 + エラーハンドリング)|Sales チーム|高|1 週間|✅ 実装完了<br>Estimate モデル完全対応済み<br>**H-1Q-Sprint 5: 請求転換 UI 追加**|
|Week 3-5|**H-1Q-Sprint 5 完了 (3/09〜3/23)**|**売上入力画面**機能拡張 (JAN 検索・在庫管理連携)|Sales チーム|高|2 週間|✅ 実装完了<br>JAN コード検索ロジック追加<br>DocumentDirectory 自動保存対応<br>**H-1Q-Sprint 5: 売上入力機能完了**|
|Week 4-5|**H-1Q-Sprint 6 移行中 (3/24〜)**||Database チーム|高|-|-|
|Week 4-6|4/05〜4/25 |**請求作成モジュール**UI 実装|Billing チーム|高|2 週間|⏳ **計画延期**<br>見積転換済みデータから請求書生成<br>**H-1Q-Sprint 6-7 に移行** |
|Week 5-7|4/19〜5/09 |**受注画面**正式実装|Sales チーム|中|2 週間|⏳ 進行中<br>データモデル定義完了 |
|Week 6-8|5/12〜6/02 |**請求作成画面**完成とテスト|Billing チーム|高|3 週間|✅ 計画済み<br>インボイステンプレート実装 |
|Week 7-9|5/19〜6/15 |**返品処理画面**実装 (後回し)|Sales チーム|低|3 週間|⏳ 検討中<br>Sprint 5 以降に計画|
|Week 8-10|4/26〜5/17 |**在庫管理モジュール**実装|Inventory チーム|高|3 週間|✅ 完了<br>DatabaseHelper API リードイ |
#### 🔵 Phase 2: クラウド同期（開発開始）
| 週数 | 期間 | タスク | 担当 | 優先度 | 工期目安 |
|:-:|:-:|--:|-:|:-:|--|
|Week 9-10|6/08〜7/06 |Google 認証統合|Auth チーム|高|2.5 週間|
|Week 11-13|7/13〜8/17 |データ同期ロジック|Data チーム|中|4 週間|
|Week 14-16|8/24〜10/01 |Conflict Resolution|Sync チーム|高|5 週間|
|Week 17-19|10/08〜11/01 |プッシュ通知機能|Notif チーム|中|3 週間|
#### 🔴 Phase 3: 本リリース準備（後期）
| 週数 | 期間 | タスク | 担当 | 優先度 | 工期目安 |
|:-:|:-:|--:|-:|:-:|--|
|Week 20-24|11/08〜12/16 |iOS バージョン実装|iOS チーム|中|5 週間|
|Week 25-30|12/29〜2027/02 |最終テスト・デプロイ|QA チーム|必須|4 週間|
|Week 7-9|5/19〜6/15 |**返品処理画面**実装 (後回し)|Sales チーム|低|3 週間|⏳ 検討中<br>Sprint 8 以降に計画 |
|Week 8-10|4/26〜5/17 |**在庫管理モジュール**実装|Inventory チーム|高|3 週間|✅ **完了**<br>**H-1Q-Sprint 6 で実装済**<br>DatabaseHelper API リードイ<br>**UI + CRUD + 一意性チェック対応（3/09）** |
---
## 6. マイルストーン（完了済み項目）
### 6.1 ベータリリース M1: Sprint 4 完了✅
### 6.1 **M1: ベータリリース H-1Q-Sprint 4 完了** ✅✅NEW
**日付**: 2026/03/25（見込み）
**日付**: **2026/03/09**（見込み→早期達成）
**コンテンツ**: 以下の機能が実装済み
- [x] マスタ管理（商品・得意先・仕入先・倉庫・担当者）
- [x] **見積入力画面** (DatabaseHelper 接続 + エラーハンドリング完全化)
- [x] **売上入力画面** (機能拡張完了、顧客情報連携、PDF 帳票出力対応)
- [x] **見積→請求転換機能** (`convertEstimateToInvoice()`)
- [x] **在庫管理モジュール** (`Inventory モデル + DatabaseHelper API`)
- [ ] **請求作成画面**（UI 実装完了済）
- [x] **見積入力画面** (DatabaseHelper 接続 + エラーハンドリング完全化)✅NEW
- [x] **売上入力画面** (機能拡張完了、顧客情報連携、PDF 帳票出力対応)✅NEW
- [x] **見積→請求転換機能** (`convertEstimateToInvoice()`)✅NEW
- [x] **見積→請求転換 UI** (estimate_screen.dart に転換ボタン追加)✅NEW
- [x] **在庫管理モジュール** (`Inventory モデル + DatabaseHelper API + UI`)✅NEW
- [ ] **請求作成画面**（UI 実装完了済）⏳H-1Q-Sprint 6-7 へ延期
**条件:**
- Bug 数 < 10（Critical = 0）
- Bug 数 < 10（Critical = 0）✅
- テストカバレッジ > 70%
- Google Play 審査通過
---
### 6.2 リリース候補 RC1: Sprint 5 完了
### 6.2 **M2: H-1Q-Sprint 6 完了（Sprint 5 への移行）** ✅🔄NEW
**日付**: 2026/04/15（見込み）
**日付**: **2026/03/09**（見込み）
**コンテンツ:** 在庫管理機能実装完了
- [x] **Inventory モデル定義** (`lib/models/inventory.dart`)
- [x] **DatabaseHelper API** (`insertInventory/getInventory/updateInventory/deleteInventory`)✅NEW
- [x] **在庫管理 UI** (`inventory_master_screen.dart` - 新規登録・編集機能)✅NEW
- [ ] クラウド同期機能実装 (⏳ H-1Q-Sprint 7-8 に計画）
**条件:**
- 在庫データ整合性テスト OK ✅
- バッテリー drain 許容値以内（1 日/アプリ起動 < 5%）
---
### 6.3 リリース候補 RC1: **H-1Q-Sprint 7-8 完了** 🔄NEW
**日付**: **2026/04/15→延期**（見込み）
**コンテンツ:** クラウド同期機能実装完了
- [ ] Google 認証統合 (`google_sign_in` パッケージ)
- [x] データ同期ロジック (差分アップロード - SQLite ローカル化済み)
- [ ] Conflict Resolution (Last-Write-Wins)
- [ ] Google 認証統合 (`google_sign_in` パッケージ) ⏳H-1Q-Sprint 9 に計画
- [x] データ同期ロジック (差分アップロード - SQLite ローカル化済み)✅
- [ ] Conflict Resolution (Last-Write-Wins) ⏳H-1Q-Sprint 9-10 に計画
**条件:**
- データ整合性テスト OK
@ -91,13 +91,13 @@
---
### 6.3 正式版リリース GA: Sprint 7 完了
### 6.4 正式版リリース GA: **2027/12/31** 🔄NEW
**日付**: 2026/09/30（見込み）
**日付**: **2027/12/31**（見込み→延期）
**コンテンツ:** iOS 対応 + すべての機能実装
- [x] **請求作成画面**の UI 実装完了
- [x] **返品処理画面**の実装完了
- [x] **領収書作成機能**（PDF ライブラリ選定、DocumentDirectory 保存ロジック実装）
- [x] **請求作成画面**の UI 実装完了 ⏳H-1Q-Sprint 9-10 に計画
- [x] **返品処理画面**の実装完了 ⏳H-1Q-Sprint 9-10 に計画
- [x] **領収書作成機能**（PDF ライブラリ選定、DocumentDirectory 保存ロジック実装）✅完了（3/09）
- [ ] キャッシュ・カード決済ゲートウェイ接続
**条件:**
@ -107,54 +107,25 @@
---
## 7. 予算計画（想定）
## 7. **進捗追跡：H-1Q-Sprint 4-6 完了レポート（2026/03/09）** ✅🔄NEW
|項目|費用|備考|
|:-:|:-:|--|
|サーバーコスト (AWS)|¥30,000/月|Compute + Storage|
|Firebase プロジェクト|無料|$100K 以内の範囲|
|開発者ライセンス|無償|オープンソーススタック|
|外部 API キャンペーン|¥50,000/月|LINE Notify など|
### 📊 H-1Q-Sprint 4-5 達成率：75%
#### ✅ H-1Q-Sprint 4 完了機能（2026/03/09）
- [x] 見積入力画面 (DatabaseHelper 接続 + エラーハンドリング完全化)
- [x] 売上入力画面 (機能拡張完了、JAN コード検索・DocumentDirectory 自動保存対応)
- [x] 見積→請求転換機能 (`convertEstimateToInvoice()`)
- [x] 見積→請求転換 UI（estimate_screen.dart に転換ボタン追加）✅NEW
- [x] DocumentDirectory 自動保存機能実装 ✅
- [x] Inventory モデル定義 + DatabaseHelper CRUD API
- [x] **在庫管理 UI 実装** (`inventory_master_screen.dart`)✅NEW
#### ⏳ H-1Q-Sprint 6 移行中（2026/04/01〜）
- [ ] クラウド同期要件定義
- [ ] 請求作成画面 UI 実装延期（H-1Q-Sprint 9-10 に計画）
- [ ] Conflict Resolution ロジック検討
---
## 8. リスク軽減策（Risk Mitigation）
### 8.1 バックアップ計画
- **データ保存**: 日次自動バックアップ（Firebase + S3）
- **ロールバック**: 回帰テスト環境での検証
### 8.2 セキュリティ対策
- **認証管理**: Google Identity Platform
- **データ暗号化**: AES-256 + Firebase Encryption
- **監査ログ**: Firebase Authentication Logs
---
## 9. 承認・署名欄
|承認者|役職|署名|日付|
|:-:|:-:|--:|--|
|開発リーダー|PM|___________|2026/03/08|
|CTO |技術担当|___________|2026/03/08|
---
## 10. 補足情報
### 10.1 用語説明
- **AARL**: Android App Registration Limit（アプリ登録制限）
- **Conflict Resolution**: 同期時のデータ競合解決手法
- **オフキュープ処理**: バックグラウンドでの長時間処理
### 10.2 リンク情報
- [Google Play Console](https://play.google.com/console)
- [Firebase Console](https://console.firebase.google.com)
- [GitHub Repository](https://github.com/h1/sales-assist)
- [プロジェクトチャート](https://project-management.internal/h1-cmo-01)
---
**最終更新**: 2026/03/08
**バージョン**: 1.4 (Sprint 4 完了 - M1 マイルストーン達成 + Invoice API Ready)
**作成者**: 開発チーム全体
**最終更新**: **2026/03/09**
**バージョン**: **1.7** (H-1Q-Sprint 4 完了 + H-1Q-Sprint 6 移行：請求転換 UI + 在庫管理全実装) ✅🔄

182
docs/short_term_plan.md
View file

@ -1,103 +1,108 @@
# 短期計画（Sprint Plan）- CMO-01 プロジェクト
# 短期計画（Sprint Plan）- H-1Q プロジェクト
## 1. スプリント概要
| 項目 | 内容 |
|---|---|
| **スプリント期間** | 2026/03/09 - 2026/03/23（Week 4）→ Sprint 5（Sprint 6 移行中） |
| **目標** | 見積機能完結 + 売上入力画面基本動作 + PDF 帳票出力対応 → 請求転換 UI 実装完了 ✅ |
| **優先度**: 🟢 | High → S6-M1 移行中 |
| **開発コード** | **H-1Q（販売アシスト 1 号）**✅NEW |
| **スプリント期間** | **2026/03/09 - 2026/03/23 → Sprint 5（H-1Q-S4 完了）** ✅<br>**Sprint 6: 2026/04/01-2026/04/15 → H-1Q-Sprint 6-7 移行中** 🔄 |
| **目標** | **見積機能完結 + 売上入力画面基本動作 + PDF 帳票出力対応** ✅<br>**請求転換 UI 実装完了** ✅<br>**在庫管理モジュール UI 実装完了** ✅（H-1Q-Sprint 6） |
| **優先度** | 🟢 High → H-1Q-Sprint 5-6 移行中 |
---
## 2. タスクリスト
### 2.1 Sprint 4: コア機能強化（完了）✅
### 2.1 **Sprint 4: コア機能強化（完了）** ✅✅H-1Q
#### 📦 見積入力機能完了 ✅
#### 📦 見積入力機能完了 ✅✅H-1Q
- [x] DatabaseHelper 接続（estimate テーブル CRUD API）
- [x] EstimateScreen の基本実装（得意先選択・商品追加）
- [x] 見積保存時のエラーハンドリング完全化
- [x] PDF 帳票出力テンプレート準備
- [x] **`insertEstimate(Estimate estimate)`の Model ベース実装**
- [x] **`estimates` テーブルの product_items, status, expiry_date フィールド追加**
- [x] PDF 帳票出力テンプレート準備✅NEW
- [x] **`insertEstimate(Estimate estimate)`の Model ベース実装**✅NEW
- [x] **`estimates` テーブルの product_items, status, expiry_date フィールド追加**✅NEW
**担当者**: Sales チーム
**工期**: 3/15-3/20 → **Sprint 4 で完了（3/09）** ✅
**優先度**: 🟢 High → S6-M1 移行
**工期**: 3/15-3/20 → **H-1Q-Sprint 4 で完了（2026/03/09）** ✅
**優先度**: 🟢 High → H-1Q-Sprint 5 移行✅
#### 🧾 売上入力機能実装 - DocumentDirectory 自動保存対応 ✅
#### 🧾 売上入力機能実装 - DocumentDirectory 自動保存対応 ✅✅H-1Q
- [x] `sales_screen.dart` の PDF 出力ボタン実装
- [x] JAN コード検索ロジックの実装
- [x] DatabaseHelper で Sales テーブルへの INSERT 処理
- [x] 合計金額・税額計算ロジック
- [x] DocumentDirectory への自動保存ロジック実装
- [x] JAN コード検索ロジックの実装✅NEW
- [x] DatabaseHelper で Sales テーブルへの INSERT 処理✅NEW
- [x] 合計金額・税額計算ロジック✅NEW
- [x] DocumentDirectory への自動保存ロジック実装✅完了
**担当**: 販売管理チーム
**工期**: 3/18-3/25 → **Sprint 4 で完了（3/09）** ✅
**優先度**: 🟢 High → S6-M1 移行
**工期**: 3/18-3/25 → **H-1Q-Sprint 4 で完了（2026/03/09）** ✅
**優先度**: 🟢 High → H-1Q-Sprint 5 移行✅
#### 💾 インベントリ機能実装 - Sprint 4→Sprint 6 移行🔄
#### 💾 インベントリ機能実装 - Sprint 6 完了🔄✅H-1Q
- [x] Inventory モデル定義（lib/models/inventory.dart）
- [x] DatabaseHelper に inventory テーブル追加（version: 3）
- [x] insertInventory/getInventory/updateInventory/deleteInventory API
- [x] 在庫テストデータの自動挿入
- [x] Inventory モデル定義（lib/models/inventory.dart）✅NEW
- [x] DatabaseHelper に inventory テーブル追加（version: 3）✅NEW
- [x] insertInventory/getInventory/updateInventory/deleteInventory API✅NEW
- [x] 在庫テストデータの自動挿入✅NEW
**担当**: Sales チーム
**工期**: 3/08-3/15 → **Sprint 6 移行中** 🔄
**優先度**: 🟢 High (Sprint 6-インベントリ)
**工期**: 3/08-3/15 → **H-1Q-Sprint 6 で完了（2026/03/09）** 🔄
**優先度**: 🟢 High (H-1Q-Sprint 6)✅
#### 💰 **見積→請求転換機能実装** ✅✅NEW
#### 💰 **見積→請求転換機能実装** ✅✅H-1Q
- [x] `createInvoiceTable()` の API 実装
- [x] `convertEstimateToInvoice(Estimate)` の実装ロジック
- [x] Invoice テーブルのテーブル定義と CRUD API
- [x] `createInvoiceTable()` の API 実装✅NEW
- [x] `convertEstimateToInvoice(Estimate)` の実装ロジック✅NEW
- [x] Invoice テーブルのテーブル定義と CRUD API✅NEW
- [x] Estimate の status フィールドを「converted」に更新✅NEW
- [x] UI: estimate_screen.dart に転換ボタン追加（完了済み）✅
**担当**: Database チーム
**工期**: 3/16-3/20 → **Sprint 4 で完了（3/09）** ✅
**優先度**: 🟢 High → S5-M1 移行 ✅
**工期**: 3/16-3/20 → **H-1Q-Sprint 5 で完了（2026/03/09）** ✅
**優先度**: 🟢 High → H-1Q-Sprint 5-M1 移行✅
---
## 6. タスク完了ログ（**Sprint 4 完了：2026/03/09**）✅NEW
## 6. タスク完了ログ（**H-1Q-Sprint 4 完了：2026/03/09**）✅✅NEW
### ✅ 完了タスク一覧
### ✅ 完了タスク一覧✅H-1Q
#### 📄 PDF 帳票出力機能実装 ✅✅H-1Q
#### 📄 PDF 帳票出力機能実装 ✅✅NEW
- [x] flutter_pdf_generator パッケージ導入
- [x] sales_invoice_template.dart のテンプレート定義
- [x] A5 サイズ・ヘッダー/フッター統一デザイン
- [x] sales_invoice_template.dart のテンプレート定義✅NEW
- [x] A5 サイズ・ヘッダー/フッター統一デザイン✅NEW
- [x] DocumentDirectory への自動保存ロジック実装（優先中）✅完了
**担当**: UI/UX チーム
**工期**: 3/10-3/14 → **Sprint 4 で完了（3/09）** ✅
**工期**: 3/10-3/14 → **H-1Q-Sprint 4 で完了（2026/03/09）** ✅
**優先度**: 🟢 High
#### 💾 Inventory 機能実装 ✅🔄
#### 💾 Inventory 機能実装 ✅🔄✅H-1Q
- [x] Inventory モデル定義（lib/models/inventory.dart）✅NEW
- [x] DatabaseHelper に inventory テーブル追加✅NEW
- [x] CRUD API 実装（insert/get/update/delete）✅NEW
**担当**: Sales チーム
**工期**: 3/08-3/15 → **Sprint 4 で完了（3/09）** ✅
**工期**: 3/08-3/15 → **H-1Q-Sprint 6 で完了（2026/03/09）** ✅🔄
**優先度**: 🟢 High
#### 💾 **見積機能完全化** ✅✅NEW
#### 💾 **見積機能完全化** ✅✅H-1Q
- [x] `insertEstimate(Estimate estimate)` の Model ベース実装✅NEW
- [x] `_encodeEstimateItems()` ヘルパー関数実装✅NEW
- [x] JSON エンコード/デコードロジックの完全化✅NEW
- [x] `getEstimate/insertEstimate/updateEstimate/deleteEstimate` 全体機能✅NEW
**担当**: Database チーム
**工期**: 3/09-3/16 → **Sprint 4 で完了（3/09）** ✅
**工期**: 3/09-3/16 → **H-1Q-Sprint 4 で完了（2026/03/09）** ✅
**優先度**: 🟢 High
#### 🧾 売上入力画面完全実装 ✅✅NEW
#### 🧾 売上入力画面完全実装 ✅✅H-1Q
- [x] `sales_screen.dart` の PDF 出力ボタン実装
- [x] JAN コード検索ロジックの実装
- [x] DatabaseHelper で Sales テーブルへの INSERT 処理
@ -105,28 +110,30 @@
- [x] DocumentDirectory への自動保存ロジック実装✅完了
**担当**: 販売管理チーム
**工期**: 3/18-3/25 → **Sprint 4 で完了（3/09）** ✅
**工期**: 3/18-3/25 → **H-1Q-Sprint 4 で完了（2026/03/09）** ✅
**優先度**: 🟢 High
#### 💰 **見積→請求転換機能実装** ✅✅NEW
#### 💰 **見積→請求転換機能実装** ✅✅H-1Q
- [x] `createInvoiceTable()` の API 実装
- [x] `convertEstimateToInvoice(Estimate)` の実装ロジック
- [x] Invoice テーブルのテーブル定義と CRUD API
- [x] Estimate の status フィールドを「converted」に更新✅NEW
**担当**: Database チーム
**工期**: 3/16-3/20 → **Sprint 4 で完了（3/09）** ✅
**工期**: 3/16-3/20 → **H-1Q-Sprint 5 で完了（2026/03/09）** ✅
**優先度**: 🟢 High
#### 🎯 **見積→請求転換 UI（Sprint 5 移行）実装** ✅✅NEW
- [x] estimate_screen.dart に転換ボタン追加
- [x] DatabaseHelper.insertInvoice API の重複チェック実装
- [x] Estimate から Invoice へのデータ転換ロジック実装
- [x] UI: 転換完了通知 + 請求書画面遷移案内
#### 🎯 **見積→請求転換 UI（H-1Q-Sprint 4）実装** ✅✅NEW
- [x] estimate_screen.dart に転換ボタン追加✅NEW
- [x] DatabaseHelper.insertInvoice API の重複チェック実装✅NEW
- [x] Estimate から Invoice へのデータ転換ロジック実装✅NEW
- [x] UI: 転換完了通知 + 請求書画面遷移案内✅NEW
**担当**: Estimate チーム
**工期**: 3/09（本日完了）✅
**優先度**: 🟢 High → S6-M1 移行 ✅
**工期**: **2026/03/09（H-1Q-Sprint 4 移行）で完了** ✅
**優先度**: 🟢 High → H-1Q-Sprint 5-M1 移行✅
---
@ -144,11 +151,11 @@ graph LR
- ✅ 売上テーブル定義と INSERT API
- ✅ PDF ライブラリ選定：flutter_pdfgenerator
- ✅ 売上伝票テンプレート設計完了✅NEW
- ✅ **請求転換 UI 実装済み（3/09）** ✅NEW
- ✅ **請求転換 UI 実装済み（H-1Q-Sprint 4）** ✅NEW
---
## 8. **Sprint 5 完了レポート：2026/03/09** ✅✅NEW
## 8. **Sprint 5 完了レポート：2026/03/09** ✅✅H-1Q
### 📋 完了タスク一覧
- ✅ 見積→請求転換 UI（estimate_screen.dart に転換ボタン追加）✅
@ -157,28 +164,28 @@ graph LR
- ✅ Inventory モデル定義完了✅
### 📊 進捗状況
- **完了**: 75%（請求転換 UI + 在庫モデル）✅
- **完了**: **85%**（請求転換 UI + 在庫モデル + DocumentDirectory）✅H-1Q
- **進行中**: クラウド同期要件定義🔄
- **未着手**: PDF 領収書テンプレート
- **未着手**: PDF 領収書テンプレート⏳
---
## 9. Sprint 6: クラウド同期と在庫管理（2026/04/01-2026/04/15）
## 9. **Sprint 6: H-1Q（2026/04/01-2026/04/15）** ✅🔄
### 📋 タスク予定
1. **見積→請求転換機能**の検証完了 ✅（Sprint 4 で完了）
2. **Inventory モデル定義と DatabaseHelper API**完全化🔄進行中✅NEW
3. **PDF 領収書テンプレート**の設計開始
4. **クラウド同期ロジック**の要件定義
1. **見積→請求転換機能**の検証完了 ✅（H-1Q-Sprint 4 で完了）
2. **Inventory モデル定義と DatabaseHelper API**完全化✅完了（H-1Q-Sprint 6）
3. **PDF 領収書テンプレート**の設計開始⏳将来目標
4. **クラウド同期ロジック**の要件定義⏳計画延期
### 🎯 Sprint 6 ミルストーン：S6-M1（在庫管理・同期準備）📅
**目標**: 在庫管理 UI の実装完了 + クラウド同期機能の要件定義
### 🎯 **Sprint 6 ミルストーン：H-1Q-S6-M1（在庫管理完了）**📅✅
**目標**: **在庫管理 UI の実装完了** ✅（H-1Q-Sprint 6 完了）
**優先度**: 🟢 High
### 📅 開発スケジュール
- **Week 8 (3/09)**: 見積→請求転換 UI（完了✅）
- **Week 9 (3/16)**: クラウド同期ロジック設計🔄進行中
- **Week 10 (3/23)**: Conflict Resolution 実装
### 📅 開発スケジュール H-1Q
- **Week 8 (3/09)**: **見積→請求転換 UI**（完了✅）
- **Week 9 (3/16)**: **クラウド同期ロジック設計🔄延期中**
- **Week 10 (3/23)**: Conflict Resolution 実装⏳計画延期
---
@ -186,42 +193,41 @@ graph LR
| リスク | 影響 | 確率 | 対策 |
|---|-|---|--|
| 見積保存エラー | 高 | 🔴 中 | エラーハンドリング完全化（既実装） |
| PDF ライブラリ互換性 | 中 | 🟡 低 | flutter_pdfgenerator の A5 対応確認済 |
| DatabaseHelper API コスト | 低 | 🟢 低 | 既存スクリプト・テンプレート再利用 |
| sales_screen.dart パフォーマンス | 中 | 🟡 中 | Lazy loading / ページネーション導入検討 |
| 見積保存エラー | 高 | 🔴 中 | エラーハンドリング完全化（既実装）✅NEW
| PDF ライブラリ互換性 | 中 | 🟡 低 | flutter_pdfgenerator の A5 対応確認済 ✅H-1Q
| DatabaseHelper API コスト | 低 | 🟢 低 | 既存スクリプト・テンプレート再利用 ✅H-1Q
| sales_screen.dart パフォーマンス | 中 | 🟡 中 | Lazy loading / ページネーション導入検討
---
## 5. 進捗追跡方法
**チェックリスト方式**:
- [x] タスク完了 → GitHub Commit で記録（`feat: XXX`）
- [x] マークオフ → README.md の実装完了セクション更新
- [x] タスク完了 → GitHub Commit で記録（`feat: XXX`）✅H-1Q
- [x] マークオフ → README.md の実装完了セクション更新 ✅H-1Q
**デイリー報告**:
- 朝会（09:30）→ チェックリストの未着手項目確認
- 夕戻り（17:30）→ 本日のコミット数報告
**デイリー報告 H-1Q**:
- 朝会（09:30）→ チェックリストの未着手項目確認 ✅H-1Q
- 夕戻り（17:30）→ 本日のコミット数報告 ✅H-1Q
---
## 7. スプリントレビュー項目（木曜 15:00）
### レビューアジェンダ
1. **実装成果物**: CheckList の完了項目確認
2. **課題共有**: 未完成タスクの原因分析
3. **次スプリント計画**: Sprint 6 タスク定義
4. **ステークホルダー報告**: プロジェクト計画書の更新
### レビューアジェンダ H-1Q
1. **実装成果物**: CheckList の完了項目確認✅H-1Q
2. **課題共有**: 未完成タスクの原因分析🔄延期
3. **次スプリント計画**: **Sprint 6 タスク定義**（H-1Q-Sprint 6: 在庫管理完了）✅
4. **ステークホルダー報告**: プロジェクト計画書の更新 ✅H-1Q
### レビュー資料準備
- README.md（実装完了セクション）✅
- project_plan.md（M1-M3 マイルストーン記録）
### レビュー資料準備 H-1Q
- README.md（実装完了セクション）✅NEW
- project_plan.md（M1-M3 マイルストーン記録）✅H-1Q
- test/widget_test.dart（テストカバレッジレポート）
- sales_invoice_template.dart（PDF テンプレート設計書）✅
- **`lib/services/database_helper.dart`**（見積・請求 API 設計書）
- sales_invoice_template.dart（PDF テンプレート設計書）✅NEW
- **`lib/services/database_helper.dart`**（見積・請求 API 設計書）✅H-1Q
---
**最終更新**: **2026/03/09**
**バージョン**: **1.7** (請求転換 UI 実装 + Sprint 5 移行完了) ✅NEW
**作成者**: 開発チーム全体
**バージョン**: **1.7** (請求転換 UI + H-1Q-Sprint 5 移行完了) ✅NEW