# 給与システム - クイックスタートガイド

## セットアップ手順

### 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` を参照してください。