# 販売アシスト 1 号「H-1Q」プロジェクト - Engineering Management

**開発コード**: **H-1Q（開発期間中）**  
**最終更新日**: 2026/03/09  
**バージョン**: 1.7 (Sprint 4 完了 + 請求転換 UI 実装) ✅NEW

---

## 📚 プロジェクトドキュメントと活用方法

### 📖 導入概要

この README は、プロジェクト管理に使用される工程管理ドキュメントへの入り口です。

- **`docs/project_plan.md`**: 全体の計画書（マイルストーン・スケジュール、開発コード：**H-1Q**）
- **`docs/short_term_plan.md`**: 短期計画（スプリントごとのタスクリスト、開発コード：**H-1Q**）
- **`docs/engineering_management.md`**: 工程管理プロセスのガイド
- **`docs/requirements.md`**: 機能要件定義書

---

## ✅ 実装完了セクション（Sprint 4: 2026/03/09-2026/03/23）

### 📦 コア機能強化 - 完了済み ✅

| 機能 | ステータス | 詳細 |
|------|------|-|-|
| **見積入力機能** | ✅ 完了（簡素化対応） | DatabaseHelper 接続、エラーハンドリング完全化、Map データ保存方式へ簡素化 |
| **売上入力機能** | ✅ 完了 | JAN コード検索、合計金額計算、PDF 帳票出力対応（printing パッケージ） |
| **PDF 帳票出力** | ✅ 完了 | A5 サイズ・テンプレート設計完了、DocumentDirectory 保存ロジック実装済み |
| **売上データ保存 API** | ✅ 完了 | DatabaseHelper.insertSales の完全実装、顧客情報連携済み |
| **見積→請求転換 UI** | ✅ 完了（Sprint 5 移行） | estimate_screen.dart に転換ボタン追加、API で請求作成・状態更新ロジック実装 |

---

### 🔄 Sprint 5: 請求機能・在庫管理（進行中）✅NEW

| 機能 | ステータス | 詳細 |
|------|------|-|-|
| **見積→請求転換** | ✅ 実装済み | DB INSERT + status UPDATE、UI フィードバック追加 |
| **DocumentDirectory 自動保存** | ✅ 完了済み | sales_screen.dart の PDF 出力ロジックと連携中 |

**担当**: Estimate チーム  
**工期**: 2026/03/09（本日）  
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅

---

### 📋 Sprint 4 タスク完了ログ

- [x] DatabaseHelper.insertEstimate の完全なエラーハンドリング（重複チェック）→ Map データ方式へ簡素化対応
- [x] `sales_screen.dart` の得意先選択機能実装
- [x] 売上データ保存時の顧客情報連携
- [x] PDF テンプレートバグ修正（行数計算・顧客名表示）
- [x] DocumentDirectory への自動保存ロジック実装
- [x] **見積→請求転換 UI 実装** (2026/03/09) ✅NEW

#### 🔄 Sprint 5 移行タスク（完了済み）✅

- [x] estimate_screen.dart に請求転換ボタン追加
- [x] DatabaseHelper.insertInvoice API の重複チェック実装
- [x] Estimate から Invoice へのデータ転換ロジック実装
- [x] UI：転換完了通知 + 請求書画面遷移案内

**担当**: Estimate チーム  
**工期**: 2026/03/09（本日完了）  
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅

---

### 📝 実装対応履歴

#### Sprint 4 完了（2026/03/08）
- EstimateScreen の簡素化：Estimate モデル依存の排除（Map データ保存方式）
- 売上入力画面完全実装 + PDF テンプレートバグ修正
- DocumentDirectory 自動保存ロジック実装

#### Sprint 5 移行（2026/03/09）✅NEW
- **見積→請求転換 UI**：estimate_screen.dart に転換ボタン追加
- **API 強化**: DatabaseHelper.insertInvoice に重複チェック実装
- **UI フィードバック**: 転換完了通知 + 請求書画面遷移案内

#### ビルド結果 (2026/03/09)
- app-release.apk (~48MB)
- DocumentDirectory: sales.pdf, estimate_YYYYMM.pdf

---

## 🚧 Sprint 5: 請求機能・在庫管理（進行中）✅

### 📋 タスク定義（実装完了済み）✅

| タスク | ステータス | 詳細 |
|------|------|-|-|
| **見積→請求転換 UI** | ✅ **実装済み** | estimate_screen.dart に転換ボタン追加、DB INSERT + status UPDATE ロジック実装 |
| **DocumentDirectory 自動保存** | ✅ **完了済み** | sales_screen.dart の PDF 出力ロジックと連携中 |

### 📅 Sprint 5 スケジュール（実装完了）✅NEW

- **開始**: 2026/03/09
- **完了**: 2026/03/09（S4-M4 完了）✅
- **マイルストーン**: S4-M4 達成（請求機能 UI 実装完了）

**担当**: Estimate チーム  
**工期**: 2026/03/09（本日完了）  
**優先度**: 🟢 High → **H-1Q-S5-M1 移行** ✅

---

## 🚧 Sprint 6: クラウド同期・在庫管理（計画段階）

### 📋 タスク定義（予定）

| タスク | ステータス | 詳細 |
|------|------|-|-|
| **見積→請求転換 UI** | ✅ **完了済み** | DB INSERT + status UPDATE、UI フィードバック実装 |
| **Inventory モデル** | ⚪ 未着手 | 在庫管理用のモデル定義と DatabaseHelper API |
| **PDF 領収書テンプレート** | ⚪ 計画段階 | 領収書のデザイン・レイアウト設計 |
| **Google 認証統合** | ⚪ 計画段階 | `google_sign_in` パッケージの導入検討 |

### 📅 Sprint 6 スケジュール（見込み）→ H-1Q-S6

- **開始**: 2026/04/01
- **完了**: 2026/04/15
- **マイルストーン**: S6-M1（在庫管理 UI 実装）✅NEW → **H-1Q-S6 移行**

---

## 🚧 進行中タスク

| タスク | 進捗 | 担当者 |
|------|-|-|-|
| **見積→請求転換** | ✅ **完了** | Estimate チーム (3/09) |
| **DocumentDirectory 自動保存** | ✅ 完了済み | UI/UX チーム |
| **PDF 帳票出力ロジック（printing）** | ✅ 完了 | Sales チーム |
| **売上入力画面完全実装** | ✅ 完了 | Sales チーム (3/09) |

---

## 📊 技術スタック

- **Flutter**: UI フレームワーク (3.41.2)
- **SQLite**: ローカルデータベース（sqflite パッケージ）
- **printing**: PDF 帳票出力（flutter_pdf_generator 代替）
- **SharePlus**: PDF 領収書共有機能
- **Intl**: 日付・通貨フォーマット

---

## 📝 変更履歴

| 日付 | バージョン | 変更内容 |
|------|-|-|-|
| **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 |

---

**最終更新**: 2026/03/09  
**ビルド結果**: app-release.apk (~48MB)  
**Sprint 5: 請求機能 UI 実装完了** ✅NEW  
**開発コード**: **H-1Q（開発期間中、正式リリース後に販売アシスト 1 号へ変更）**

**📌 注記**: 本プロジェクトの公式アプリ名は「販売アシスト 1 号」です。開発期間中は「H-1Q」として管理・参照してください。