113 lines
3.6 KiB
Markdown
113 lines
3.6 KiB
Markdown
# 販売アシスト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年間の長期保存
|
||
- 検索・閲覧の容易性
|
||
- 定期的な整合性検証
|