# 販売アシスト 1 号「母艦お局様」プロジェクト - Engineering Management

**開発コード**: CMO-01  
**最終更新日**: 2026/03/09  
**バージョン**: 1.6 (Sprint 4 完了 + 売上入力完全実装)

---

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

### 📖 導入概要

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

- **`docs/project_plan.md`**: 全体の計画書（マイルストーン・スケジュール）
- **`docs/short_term_plan.md`**: 短期計画（スプリントごとのタスクリスト）
- **`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 の完全実装、顧客情報連携済み |

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

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

### 📝 見積簡素化対応履歴 (2026/03/08)

- **EstimateScreen の簡素化**: Estimate モデル依存の排除（Map データ保存方式）
- **ビルド修正**: showModal→showDialog、Duration(inDays:...)→Duration(days:)、TextButton child 追加
- **ビルド結果**: app-release.apk (49.4MB)

---

## 🔄 Sprint 5: クラウド同期機能（計画段階）

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

| タスク | ステータス | 詳細 |
|------|------|-|-|
| **見積→請求転換** | ⚪ 未着手 | 見積データを請求書への変換ロジック実装 |
| **Inventory モデル** | ⚪ 未着手 | 在庫管理用のモデル定義と DatabaseHelper API |
| **PDF 領収書テンプレート** | ⚪ 未着手 | 領収書のデザイン・レイアウト設計 |
| **Google 認証統合** | ⚪ 計画段階 | `google_sign_in` パッケージの導入検討 |

### 📅 Sprint 5 スケジュール（見込み）

- **開始**: 2026/04/01
- **完了**: 2026/04/15
- **マイルストーン**: S5-M1（請求機能初版実装）

---

## 🚧 進行中タスク

| タスク | 進捗 | 担当者 |
|------|-|-|-|
| **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.6 | 売上入力画面完全実装、PDF 帳票出力完成、DocumentDirectory 自動保存完了 |
| 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)  
**作成者**: 開発チーム全体