スマートフォン用 見積納品請求領収書発行システム を制作します

• 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 で管理するとスムーズです。