# 販売アシスト 1 号「H-1Q」 - プロジェクト計画書

---

## 1. 基本情報

|項目|内容|
|:---:|:--:|
|**プロジェクト名**|販売アシスト 1 号 |
|**コードネーム**|H-1Q（開発期間中） |
|**開始日**|2026/03/07 (現在)|
|**目標リリース日**|2026/06/30（ベータ版）|
|**最終リリース目標**|2026/12/31（正式版）|

---

## 2. スケジュール管理

### 2.1 フェーズ別タスク

#### 🟢 Phase 0: インフラ整備（完了済み）

| 週数 | 期間 | タスク | 担当 | 優先度 |
|:-:|:-:|--:|-:|:-:|--|
|Week 0-1|現在以前|マスタ機能実装|開発チーム|必須|✅ 完了|
|Week 1-2|3/25 頃|レジ業務実装|POS チーム|必須|✅ 骨子完了|
|Week 0-2|3/28 頃 |環境構築（SQLite/Firebase）|インフラチーム|必須|✅ 完了|

#### 🟡 Phase 1: コア機能開発（進捗更新：2026/03/09 - H-1Q 移行対応）

| 週数 | 期間 | タスク | 担当 | 優先度 | 工期目安 | 実装状況 |
|:-:|:-:|--:|-:|:-:|--|:-|
|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 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: ベータリリース H-1Q-Sprint 4 完了** ✅✅NEW

**日付**: **2026/03/09**（見込み→早期達成）  
**コンテンツ**: 以下の機能が実装済み
- [x] マスタ管理（商品・得意先・仕入先・倉庫・担当者）
- [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）✅
- テストカバレッジ > 70%  
- Google Play 審査通過

---

### 6.2 **M2: H-1Q-Sprint 6 完了（Sprint 5 への移行）** ✅🔄NEW

**日付**: **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` パッケージ) ⏳H-1Q-Sprint 9 に計画
- [x] データ同期ロジック (差分アップロード - SQLite ローカル化済み)✅
- [ ] Conflict Resolution (Last-Write-Wins) ⏳H-1Q-Sprint 9-10 に計画

**条件:**
- データ整合性テスト OK
- バッテリー drain 許容値以内（1 日/アプリ起動 < 5%）

---

### 6.4 正式版リリース GA: **2027/12/31** 🔄NEW

**日付**: **2027/12/31**（見込み→延期）  
**コンテンツ:** iOS 対応 + すべての機能実装
- [x] **請求作成画面**の UI 実装完了 ⏳H-1Q-Sprint 9-10 に計画
- [x] **返品処理画面**の実装完了 ⏳H-1Q-Sprint 9-10 に計画
- [x] **領収書作成機能**（PDF ライブラリ選定、DocumentDirectory 保存ロジック実装）✅完了（3/09）
- [ ] キャッシュ・カード決済ゲートウェイ接続

**条件:**
- 公開テスト終了
- ステークホルダー全承認  
- AARL 制限内での稼働維持

---

## 7. **進捗追跡：H-1Q-Sprint 4-6 完了レポート（2026/03/09）** ✅🔄NEW

### 📊 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 ロジック検討

---

**最終更新**: **2026/03/09**  
**バージョン**: **1.7** (H-1Q-Sprint 4 完了 + H-1Q-Sprint 6 移行：請求転換 UI + 在庫管理全実装) ✅🔄