desktop/njts-accounting-core

Fork 0

Files

admin a2d7b54cd3 帳票出力作成

2026-02-01 20:13:52 +09:00

6.1 KiB

Raw Blame History

📄 账票出力機能 - 実装完了レポート

✅ 実装内容サマリー

バックエンド（FastAPI）

ファイル: backend/app/payroll/vouchers/

ファイル	行数	説明
`router.py`	85	API エンドポイント定義
`schemas.py`	140	Pydantic データモデル
`service.py`	275	ビジネスロジック、DB クエリ
`__init__.py`	2	パッケージ初期化
合計	502

フロントエンド（HTML/JavaScript）

ファイル: frontend/payroll-calculation.html

セクション	行数	説明
新Tab追加	5	📄 账票出力ボタン
Tab内容	~250	フォーム、結果表示、モーダル
JavaScript関数	~300	API統合、イベントハンドラ
合計追加	~555

統合変更

backend/app/main.py - Vouchersルーター統合（+2行）

🎯 実装された機能

API エンドポイント

GET /payroll/vouchers/employees
  → 従業員リスト取得

POST /payroll/vouchers/export
  → 账票エクスポート（プレビュー・CSV）

GET /payroll/vouchers/data/salary
  → 単一従業員給与データ

GET /payroll/vouchers/data/bonus
  → 単一従業員賞与データ

UI コンポーネント

✓ 期間選択（開始年月～終了年月）
✓ 従業員マルチセレクト + 全選択/全解除
✓ 支払タイプラジオボタン（給与/賞与/両方）
✓ プレビュー・CSV出力ボタン
✓ 結果摘要表示（成功時）
✓ 無データアラート（モーダル）

JavaScript 関数一覧

loadVoucherEmployees(); // 従業員リスト読み込み
updateVoucherEmployeeCount(); // 選択数カウント更新
selectAllVoucherEmployees(); // 全選択
clearAllVoucherEmployees(); // 全解除
getSelectedVoucherEmployees(); // 選択従業員ID取得
previewVouchers(); // API呼び出し・検証
displayVoucherResults(); // 結果表示
showNoDataAlert(); // エラーモーダル表示
exportVouchersCSV(); // CSV生成・ダウンロード

📋 API レスポンス例

成功レスポンス

{
  "status": "success",
  "has_data": true,
  "message": "✓ 成功查詢: 2位従業員有數據",
  "summary": [
    {
      "employee_id": 1,
      "employee_code": "E001",
      "employee_name": "田中太郎",
      "has_salary_data": true,
      "has_bonus_data": false,
      "salary_count": 3,
      "bonus_count": 0,
      "salary_months": ["2026-01", "2026-02", "2026-03"],
      "bonus_months": []
    }
  ],
  "data": {
    "salary": [...],
    "bonus": [...]
  }
}

無データレスポンス

{
  "status": "no_data",
  "has_data": false,
  "message": "選定條件下、沒有找到任何數據。請檢查日期範圍和従業員選擇。"
}

🚀 テスト手順

前提条件

Python 3.12+
PostgreSQL接続済み
backend/requirements.txt に依存パッケージ完備

実行コマンド

# 1. バックエンド起動
cd backend
python -m uvicorn app.main:app --reload --port 8000

# 2. ブラウザアクセス
http://localhost/payroll-calculation.html

# 3. 「📄 账票出力」Tabをクリック
# 4. 従業員・期間・タイプを選択
# 5. プレビュー/CSV出力実行

📊 テスト結果

テスト項目	状態
従業員リスト取得	✅
給与データクエリ	✅
賞与データクエリ	✅
混合データ取得	✅
無データ検出	✅
年跨ぎ対応	✅
API統合	✅
UI表示	✅
CSV出力	✅

🔧 トラブルシューティング

サーバー起動エラー

ModuleNotFoundError: No module named 'app.payroll.vouchers'
→ __init__.py ファイルが存在することを確認

API 404 エラー

POST /payroll/vouchers/export → 404
→ main.py でルーターが include_router() されていることを確認

無データなのにエラーが出ない

→ backend ログを確認
→ SQL クエリが実行されているか確認
→ 従業員ID が有効か確認

📁 ファイル一覧

バックエンド

backend/app/payroll/vouchers/
  ├── __init__.py
  ├── router.py       (85行)
  ├── schemas.py      (140行)
  └── service.py      (275行)

フロントエンド

frontend/
  ├── payroll-calculation.html   (1846行、新Tab追加）
  └── voucher-export-test.html   (テストページ)

ドキュメント

docs/
  └── voucher-export-quickstart.md   (詳細ガイド)

修正ファイル

backend/app/main.py   (+2行、ルーター統合)

✨ 次の実装予定

Phase 2: PDF生成

reportlab による帳票PDF
複数ページ処理
日本語フォント対応

Phase 3: 高度な機能

メール自動配信
一括ダウンロード
アーカイブ保管

💾 コード統計

セクション	行数
バックエンド API	502
フロントエンド UI	555
統合変更	2
ドキュメント	~500
総行数	1,559

📞 サポート

問題が発生した場合：

ブラウザコンソール (F12) でエラーメッセージを確認
バックエンドログ (ターミナル出力) で SQL エラーを確認
ネットワークタブ (F12 → Network) で API リクエスト/レスポンスを確認
データベース で期間内のデータが実際に存在するか確認

実装完了日: 2026年01月15日 ステータス: ✅ 本番環境対応可能

6.1 KiB Raw Blame History Unescape Escape