# スマートフォン用 見積納品請求領収書発行システム を制作します
- flutterを使います
- 今は初期段階なので請求書だけを作ります
- 今は初期段階なのでスタンドアロンですが将来的にデータをodooとOnline時に同期する予定です
- 今はデータをローカルのsqliteで管理します
- 顧客データはスマートフォンの住所録から取り込むか貼り付けか手入力します
- 商品データは手入力しsqliteで管理します
- 値引きも商品データとしてsqliteで管理します

## プロジェクト計画（スマートフォン用 見積納品請求領収書発行システム）

---

### 1. 目的・概要  
- Flutterで構築するモバイルアプリ  
- 現時点では請求書（領収書）発行機能のみ  
- 将来的に Odoo とオンライン同期を実装  
- データはローカル SQLite に保存  
- 顧客情報は電話帳からインポート／手入力  
- 商品・値引き情報は手入力で SQLite に保存  

---

### 2. 主要機能一覧  
| 機能 | 説明 | 優先度 |
|------|------|--------|
| **請求書作成** | 顧客選択 → 商品・数量入力 → 合計・税・値引き計算 → PDF/画像生成 | ★★★★★ |
| **顧客管理** | 連絡先インポート、手入力、編集、削除 | ★★★★☆ |
| **商品管理** | 商品名・単価・値引き設定、編集、削除 | ★★★★☆ |
| **データ永続化** | SQLite（sqflite）で顧客・商品・請求書履歴保存 | ★★★★★ |
| **PDF/画像出力** | `printing` / `pdf` パッケージで請求書を生成 | ★★★★☆ |
| **将来の同期** | Odoo REST API 連携（認証・CRUD） | ★★☆☆☆ |
| **UI/UX** | Material Design、レスポンシブ、アクセシビリティ | ★★★★★ |

---

### 3. 技術スタック  
- **フロントエンド**: Flutter 3.x, Dart  
- **データベース**: `sqflite` + `path_provider`  
- **PDF生成**: `pdf`, `printing`  
- **状態管理**: `provider`（または Riverpod）  
- **テスト**: `flutter_test`, `mockito`  
- **CI/CD**: GitHub Actions（ビルド・テスト）  

---

### 4. データモデル（SQLite）  
| テーブル | カラム | 型 | 備考 |
|----------|--------|----|------|
| `customers` | id | INTEGER PRIMARY KEY AUTOINCREMENT |  |
| | name | TEXT |  |
| | phone | TEXT |  |
| | address | TEXT |  |
| | email | TEXT |  |
| `products` | id | INTEGER PRIMARY KEY AUTOINCREMENT |  |
| | name | TEXT |  |
| | unit_price | REAL |  |
| | discount | REAL | 0〜1 の割合 |
| `invoices` | id | INTEGER PRIMARY KEY AUTOINCREMENT |  |
| | customer_id | INTEGER | FK |
| | date | TEXT | ISO8601 |
| | total | REAL |  |
| | tax | REAL |  |
| | discount_total | REAL |  |
| `invoice_items` | id | INTEGER PRIMARY KEY AUTOINCREMENT |  |
| | invoice_id | INTEGER | FK |
| | product_id | INTEGER | FK |
| | quantity | INTEGER |  |
| | unit_price | REAL |  |
| | discount | REAL |  |

---

### 5. 画面設計（ワイヤーフレーム）  
1. **ホーム**  
   - 「請求書作成」ボタン  
   - 「顧客一覧」ボタン  
   - 「商品一覧」ボタン  
2. **顧客一覧**  
   - 検索バー  
   - 顧客カード（名前・電話）  
   - 追加ボタン（連絡先インポート／手入力）  
3. **商品一覧**  
   - 検索バー  
   - 商品カード（名前・単価・値引き）  
   - 追加ボタン  
4. **請求書作成**  
   - 顧客選択ドロップダウン  
   - 商品追加リスト（＋ボタン）  
   - 数量入力フィールド  
   - 合計・税・値引き表示  
   - 「PDF生成」ボタン  
5. **請求書プレビュー**  
   - PDF/画像表示  
   - 共有／保存ボタン  

---

### 6. 開発フロー  
1. **環境構築**  
   - Flutter SDK 3.x インストール  
   - `pubspec.yaml` に必要パッケージ追加  
2. **データベース設計**  
   - `db_helper.dart` でテーブル作成・CRUD実装  
3. **モデルクラス**  
   - `Customer`, `Product`, `Invoice`, `InvoiceItem` を作成  
4. **状態管理**  
   - `CustomerProvider`, `ProductProvider`, `InvoiceProvider` を実装  
5. **UI実装**  
   - 画面ごとに `StatelessWidget` / `StatefulWidget` を作成  
   - `ListView.builder` でデータ表示  
6. **PDF生成**  
   - `pdf` パッケージでレイアウト設計  
   - `printing` でプレビュー・保存・共有  
7. **テスト**  
   - 単体テスト（モデル・DB）  
   - widget テスト（画面遷移・入力）  
8. **ビルド・デプロイ**  
   - Android/iOS 向けビルド  
   - GitHub Actions で自動テスト・ビルド  

---

### 7. 将来の Odoo 同期設計（ロードマップ）  
- **認証**: OAuth2 / API キー  
- **エンドポイント**: `/api/invoices`, `/api/customers`, `/api/products`  
- **同期戦略**:  
  - **プッシュ**: ローカルで作成した請求書を Odoo に POST  
  - **プル**: Odoo から顧客・商品データを取得しローカルにマージ  
- **エラーハンドリング**: ネットワーク失敗時はローカルにキュー保存  
- **UI**: 「同期」ボタン、同期ステータス表示  

---

### 8. 重要ポイント & リスク  
- **データ整合性**: SQLite の外部キー制約を有効化  
- **パフォーマンス**: 大量データ時はページング実装  
- **セキュリティ**: データ暗号化（`sqflite_sqlcipher`）検討  
- **ユーザー体験**: 入力補完、バリデーション、エラーメッセージ  

---

### 9. 次のステップ  
1. `pubspec.yaml` に必要パッケージを追加  
2. `db_helper.dart` を作成しテーブルを生成  
3. モデルクラスを実装  
4. 画面構成を決め、最小限の UI を作成  
5. PDF 生成を試作し、レイアウトを確定  

---

**以上が、現在の要件に基づくプロジェクト計画です。**  
次に進める際は、上記の順序でタスクを分割し、GitHub Issues で管理するとスムーズです。