給与管理システム新規作成

docs/payroll_quickstart.md

@@ -0,0 +1,171 @@
+# 給与システム - クイックスタートガイド
+
+## セットアップ手順
+
+### 1. データベーススキーマの適用
+
+```powershell
+# PostgreSQLに接続（環境に応じて認証情報を変更）
+$env:PGPASSWORD = "your_password"
+psql -U your_user -d your_database -f backend/sql/payroll_schema.sql
+```
+
+または、既存のデータベース接続を使用している場合:
+
+```powershell
+# Pythonスクリプトで実行する場合
+cd backend
+python -c "
+from app.core.database import get_connection
+with open('sql/payroll_schema.sql', 'r', encoding='utf-8') as f:
+    sql = f.read()
+with get_connection() as conn:
+    with conn.cursor() as cur:
+        cur.execute(sql)
+    conn.commit()
+print('給与システムのスキーマを適用しました')
+"
+```
+
+### 2. サーバーの起動
+
+```powershell
+cd backend
+uvicorn app.main:app --reload
+```
+
+### 3. ブラウザでアクセス
+
+http://localhost:8000/static/payroll.html
+
+## 初期データのセットアップ
+
+### 1. 保険料率の確認
+
+システムには以下の初期保険料率が登録されています（2026 年度）:
+
+- 健康保険: 10.00% (労使折半 各 5.00%)
+- 厚生年金: 18.30% (労使折半 各 9.15%)
+- 雇用保険: 1.55% (従業員 0.6% + 事業主 0.95%)
+- 労災保険: 0.30% (事業主のみ)
+
+必要に応じて「税率・保険料設定」画面で更新してください。
+
+### 2. 所得税率表のインポート
+
+サンプル CSV ファイルが `backend/income_tax_sample.csv` に用意されています。
+
+1. 「税率・保険料設定」画面を開く
+2. 「所得税率表」タブを選択
+3. 「CSV インポート」ボタンをクリック
+4. `income_tax_sample.csv` を選択
+5. 適用開始日を入力（例: 2026-01-01）
+
+### 3. 従業員の登録
+
+1. 「従業員管理」画面を開く
+2. 「新規登録」タブを選択
+3. 必要な情報を入力:
+   - 従業員コード（必須）
+   - 氏名（必須）
+   - 入社日（必須）
+   - その他の情報（任意）
+4. 「登録」ボタンをクリック
+
+### 4. 扶養家族の登録（必要な場合）
+
+1. 「従業員管理」画面で従業員を選択
+2. 従業員詳細画面の「扶養家族」セクションで追加
+
+### 5. 給与設定の登録
+
+1. 「給与設定」画面を開く
+2. 従業員を選択
+3. 「新規設定追加」ボタンをクリック
+4. 給与情報を入力:
+   - 基本給（必須）
+   - 雇用形態（必須）
+   - 支給形態（必須）
+   - 通勤手当（任意）
+   - 適用開始日（必須）
+5. 「保存」ボタンをクリック
+
+## 給与計算の実行
+
+### 月次給与計算の手順
+
+1. 「月次給与計算」画面を開く
+2. 「新規計算」ボタンをクリック
+3. 給与計算情報を入力:
+   - 従業員を選択
+   - 対象年月
+   - 支給日
+   - 勤怠情報（出勤日数、勤務時間、残業時間など）
+   - その他（住民税、その他控除など）
+4. 「計算実行」ボタンをクリック
+5. 給与明細を確認
+6. 問題なければ「承認」ボタンをクリック
+
+### 給与明細の見方
+
+**支給項目**
+
+- 基本給: 設定された基本給（欠勤がある場合は控除後）
+- 残業手当: 残業時間 × 時給 × 1.25
+- 休日手当: 休日出勤時間 × 時給 × 1.35
+- 通勤手当: 設定された通勤手当
+- その他手当: 入力されたその他手当
+- **総支給額**: 上記の合計
+
+**控除項目**
+
+- 健康保険: 総支給額 × 5.00%
+- 厚生年金: 総支給額 × 9.15%
+- 雇用保険: 総支給額 × 0.60%
+- 所得税: 所得税率表に基づいて計算
+- 住民税: 入力された金額
+- その他控除: 入力された金額
+- **総控除額**: 上記の合計
+
+**差引支給額** = 総支給額 - 総控除額
+
+## よくある質問
+
+### Q1: 給与を再計算するには？
+
+A: 給与明細画面で「再計算」ボタンをクリックしてください。ただし、承認済みの給与は再計算できません。
+
+### Q2: 承認済みの給与を修正するには？
+
+A: 承認済みの給与は変更できません。給与を削除して新規に計算し直す必要があります。
+
+### Q3: 時給制の従業員の給与計算は？
+
+A: 給与設定で「支給形態: 時給」を選択し、時給を入力してください。基本給は「時給 × 勤務時間」で自動計算されます。
+
+### Q4: 所得税が 0 円になる
+
+A: 所得税率表が登録されていない可能性があります。「税率・保険料設定」画面で所得税率表を確認してください。
+
+### Q5: 扶養家族の人数が所得税に反映されない
+
+A: 扶養家族の「有効期間」を確認してください。計算対象月に有効な扶養家族のみがカウントされます。
+
+## トラブルシューティング
+
+### エラー: 「給与設定が見つかりません」
+
+→ 「給与設定」画面で該当従業員の給与設定を登録してください
+
+### エラー: 「保険料率が見つかりません」
+
+→ 「税率・保険料設定」画面で保険料率を確認・登録してください
+
+### 所得税が正しく計算されない
+
+→ 所得税率表が正しくインポートされているか確認してください
+→ 扶養家族の有効期間が正しく設定されているか確認してください
+
+## サポート
+
+詳細なドキュメントは `docs/payroll_system.md` を参照してください。