# 05_employee_management/05_02_employee_list.md

版：v1.2　実装の状況は `work_order_db_migration.md`（作業書）を見る

## 1. 概要
従事者一覧（一般用）。
**閲覧専用**であり、登録・編集ボタンは設置しない。
拠点ごとの一覧またはツリー表示で閲覧する。

## 2. 画面構成
- ファイルパス: `employees/index.html`
- ヘッダー: TOPへ戻るリンク、タイトル「従事者一覧」、ユーザー名
- ツールバー: 件数表示、**CSV出力ボタン**
- 表示形式: 拠点ごとのツリー（折りたたみ可能）または拠点別一覧（タブ切替）
- テーブル項目: 従事者ID、氏名、所属（会社ごとの契約、職務ポジション、管轄拠点またはサテライト）、稼働状況
- 写真: 一覧には表示しない

## 3. API仕様
- エンドポイント: `GET /employees/api/load_employee_list.php`
- 権限要件: `profile_view_self` / `profile_view_branch` / `profile_view_all`
- レスポンス例:
```json
{
  "success": true,
  "employees": [
    { "SPS_ID": "SPS01-99999", "氏名": "テスト 太郎", "所属": [{ "会社": "SPS", "契約CD": "C06", "職務ポジションCD": "P013", "管轄拠点": null, "サテライト": "S01" }], "稼働状況": "常勤" }
  ]
}
```

## 4. 動作仕様
- `spsSessionReady` イベント発火後、APIを呼び出し一覧を描画する。
- ユーザーの閲覧権限（self/branch/all）に応じて、返却するデータをサーバー側で絞り込む。
- 行をクリックすると、簡易モーダルで基本情報（氏名・所属・拠点・職務・稼働状況）を表示する。
- CSV出力ボタン押下時、表示中の一覧をCSV形式でダウンロードする。

## 5. 制約
- **登録・編集・削除ボタンは一切設置しない**。
- localStorage / sessionStorage 使用禁止。
- 権限チェックは `window.hasPermission()` で行う。

## 6. 改訂履歴
| 日付 | 版 | 担当 | 内容 |
|------|----|------|------|
| 2026-10-26 | 1.0 | Deepseek | 初版作成 |
| 2026-10-29 | 1.1 | 全体管理者（14代目） | 例の人名・IDをテスト用に差し替え |
| 2026-10-30 | 1.2 | 全体管理者（14代目） | 一覧の項目と例を、会社ごとの所属に変更（`02_01` v2.1） |