172 lines
5.3 KiB
Markdown
172 lines
5.3 KiB
Markdown
# 給与システム - クイックスタートガイド
|
||
|
||
## セットアップ手順
|
||
|
||
### 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` を参照してください。
|