# 販売アシスト1号

Python + Fletで開発したAndroid対応販売管理アプリケーションです。

## 機能

- **ダッシュボード**: 顧客数、商品数、売上件数、総売上を表示
- **顧客管理**: 顧客情報の追加、編集、削除
- **商品管理**: 商品情報の追加、編集、削除、在庫管理
- **売上管理**: 売上データの記録と閲覧
- **データ出力**: JSON/CSV形式でのデータエクスポート
- **電子帳簿保存法対応**: 10年間データ保持、監査証跡、整合性チェック

## 電子帳簿保存法対応

- **10年間データ保持**: 法定期間のデータ保存に対応
- **監査証跡**: 全データ操作のログ記録
- **データ整合性**: チェックサムによる改ざん検知
- **アーカイブ機能**: 7年以上前のデータを自動アーカイブ
- **コンプライアンスレポート**: 法令対応状況の定期報告

## セットアップ

1. 依存関係をインストール:
```bash
pip install -r requirements.txt
```

2. アプリケーションを実行:
```bash
python main.py
```

## Androidビルド

Fletを使用してAndroidアプリをビルド:

```bash
flet build apk .
```

リリースAABを作る場合:
```bash
flet build aab .
```

## リポジトリ整理の自動化

SWE実行で生成された試作ファイル/生成物を安全に整理するため、
削除ではなく `trash/` へ隔離するスクリプトを用意しています。

```bash
bash scripts/auto_recover_and_build.sh /home/user/dev/h-1.flet.3
```

このスクリプトで実行される内容:

- プロジェクト全体のバックアップ作成
- 生成物/試作ファイルの `trash/<timestamp>/` への移動
- `.gitignore` の整備
- Gitベースラインコミット作成（必要時）

注意:

- 実行確認 (`python main.py`) と APK ビルド (`flet build apk`) は自動実行しません
- 必要に応じて最後に表示されるコマンドを手動実行してください

## データベース

アプリケーションはSQLiteデータベース(`sales.db`)を使用してデータを保存します。

- `customers`: 顧客情報
- `products`: 商品情報  
- `sales`: 売上データ
- `audit_logs`: 監査ログ
- `integrity_checks`: 整合性チェック記録
- `archive_sales`: アーカイブ済み売上データ

## 使用方法

1. アプリを起動するとダッシュボードが表示されます
2. 左側のナビゲーションレールで各機能にアクセス
3. 各画面で「追加」ボタンから新しいデータを登録
4. 編集・削除ボタンで既存データを管理
5. 「データ出力」でバックアップ作成
6. 「コンプライアンス」で法令対応管理

## 電子帳簿保存法要件

- **検索要件**: 任意の項目でデータ検索可能
- **日付要件**: 取引日時の正確な記録
- **金額要件**: 取引金額の正確な記録
- **署名要件**: 電子署名（チェックサム）による改ざん防止
- **保存期間**: 10年間のデータ保持
- **可視性要件**: 随時閲覧可能な形式

## 技術仕様

- **フレームワーク**: Flet
- **言語**: Python 3.8+
- **データベース**: SQLite
- **UI**: モダンなマテリアルデザイン
- **対応OS**: Android, iOS, Windows, macOS, Linux
- **オフライン動作**: 完全スタンドアローン

## 法令対応

電子帳簿保存法のすべての要件を満たす設計：
- 完全な監査証跡の保持
- データ改ざん防止機能
- 10年間の長期保存
- 検索・閲覧の容易性
- 定期的な整合性検証