# 03_ui_design/03_04_screen_map.md

# 画面導線表

**保存先**: `public_html/docs/03_ui_design/03_04_screen_map.md`
**作成日**: 2026-10-26
**作成**: 全体管理者（13代目）
**改訂**: Deepseek（5代目）、全体管理者（14代目）

---

## 1. 目的

画面（html）ごとに、「どこから入れるか（リンク元）」「誰が入れるか（権限）」「状態」を、1か所で管理する。

- `01_folder_structure.md`（ツリー）が管理するのは、ファイルの有無だけである。
- 本書は、入口を管理する。次の2つの不具合を防ぐ。
  - 画面はあるのに、入口がない（実装済の画面に、どこからも入れない）
  - 入口はあるのに、画面がない（押すと404になる）

## 2. 運用ルール

1. 画面の新設・削除・リンクの追加・変更をしたときは、本書の該当の行を追加・更新する。**本書に行がない画面は、完了とみなさない。**
2. 本書は仕様書として扱う。`03_development_rules.md` 2節の順序（仕様書 → 承認 → ツリー → 承認 → 実装）に従い、仕様書の修正と同時に、本書を更新する。
3. 担当は、完了報告に、追加・変更した行を含める（担当名を記載）。
4. 表示条件は、`window.hasPermission()` の権限IDで書く。複数ある場合は「いずれか」か「すべて」かを明記する。
5. 改訂履歴には、必ず担当名を記載する。

### 状態の定義

| 状態 | 意味 |
|---|---|
| 実装済 | ファイルが存在する（ツリーまたは実物で確認） |
| 未設置 | ファイルがまだ無い |
| 不在 | リンクはあるが、ファイルが無いことを確認した（死にリンク） |
| 未確認 | ファイルの有無を確認できていない |

### 本書の対象範囲

TOP、管理メニュー、人事・組織、労務、業務管理。案件管理・営業管理・会計・顧客（`clients/`）は、各担当の確認後に追加する。

---

## 3. TOP（`index.html`）

| カード | リンク先 | 表示条件（現状の実装） | 行き先の状態 | 備考 |
|---|---|---|---|---|
| 案件管理 | `private/cases/index.html`（SPS）／`corporate/cases/index.html`（SCSPS） | `case_list_view`／`case_detail_view_all`／`case_detail_view_own`／`case_phone_duty` のいずれか | 実装済 | |
| 営業管理 | `private/sales/index.html`／`corporate/sales/index.html` | `case_create_from_sales` または案件閲覧のいずれか | 実装済 | |
| 会計 | `common/accounting/index.html`（SPS）／`corporate/accounting/corporate.html`（SCSPS） | `accounting_view`／`accounting_edit` のいずれか | 実装済 | |
| 書庫・資料 | `common/archive/index.html` | 常時表示 | 未確認 | `common/archive/` フォルダは存在する。`index.html` の有無は未確認 |
| 人事・組織 | `hr/index.html`（現状） | `profile_view_branch`／`profile_view_all` のいずれか | **不在**（現状 `hr/index.html`、未変更） | `employees/menu.html` へ変更予定 |
| マイページ | `common/mypage.html` | 常時表示 | **不在**（2026-10-26 `common/` に無いことを確認） | ユーザーメニューの「マイページ」も同じリンク先 |
| 事業者情報 | `master/company_info.html` | `company_info_view` | 実装済 | |
| 労務関係 | `master/labor/social_insurance_export.html`（直リンク） | `labor_social_insurance_export` | 実装済 | 労務メニュー（`master/labor/index.html`）は未設置（7節） |
| 管理者 | `master/index.html` | `permission_assign` または `profile_view_all` | 実装済 | 遷移先は `permission_assign` が無いとTOPに戻す（4節）。条件が食い違っている |

**TOP の実装上の注意（2026-10-27 時点）**
- `session.js` を読み込んでいない。権限を `permissions.xxx === true` で直接判定している。全権キー `supreme_access`（旧 `master_access`）は通らないため、全権キーのみを持つ従事者には、カードが表示されない。タイムアウト警告帯も表示されない。

---

## 4. 管理メニュー（`master/index.html`）

ページ自体のアクセス条件：`permission_assign`（無い場合は、TOP `index.html` へ戻す）

| カード | リンク先（`master/` 以降） | 行き先の状態 |
|---|---|---|
| 拠点マスタ | `branch_edit.html` | **不在**（2026-10-26 確認） |
| 部署マスタ | `department_edit.html` | **不在** |
| 職務マスタ | `position_edit.html` | **不在** |
| 契約マスタ | `contract_edit.html` | **不在** |
| 権限マスタ | `permission_edit.html` | **不在** |
| メンテナンス | なし（「準備中」表示） | — |

- `03_02_master_management.md` 8.3節は、従事者マスタ管理の入口を人事管理メニューに一本化したため、本画面からの導線はない。
- ヘッダーのユーザーメニューの「マイページ」は `/mypage.html`（TOPの `common/mypage.html` とパスが違う）。どちらも実物を未確認。

---

## 5. 人事メニュー（`employees/menu.html`）

メニュー：`employees/menu.html`（`05_01_menu.md`）。TOPの「人事・組織」からのリンク先とする。

| ボックス | リンク先 | 表示に必要な権限 | 行き先の状態 |
|---|---|---|---|
| 従事者一覧 | `employees/index.html` | `profile_view_self`／`profile_view_branch`／`profile_view_all` のいずれか | 実装済 |
| 担当者一覧 | `employees/directory.html` | `employee_directory_view` | 未設置 |
| 従事者名簿 | `employees/audit_list.html` | `employee_audit_view` | 未設置 |
| 人事考課 | `employees/evaluation.html` | `hr_evaluation_manage` | 未設置 |
| 人事異動履歴 | `employees/transfer_history.html` | `hr_transfer_history_view` | 未設置（閲覧専用。変更履歴と出来事を時系列で表示。`05_08`） |
| 人事管理 | `employees/admin_menu.html` | `profile_edit_self`／`profile_edit_branch`／`profile_edit_all`／`permission_assign` のいずれか | 未設置 |
| 変更履歴の確認 | `master/history_review.html`（案。ツリー承認で確定） | `change_history_review` | 未設置 |

---

## 6. 人事管理メニュー（`employees/admin_menu.html`）

メニュー：`employees/admin_menu.html`（`05_09_admin_menu.md`）。人事メニューの「人事管理」からのリンク先とする。

| ボックス | リンク先 | 表示に必要な権限 | 行き先の状態 |
|---|---|---|---|
| 従事者登録 | `employees/register.html` | `profile_edit_all`／`permission_assign` | 未設置 |
| 身分証発行 | `employees/id_card.html` | `employee_id_card_issue` | 未設置 |
| 従事者マスタ管理 | `employees/edit.html` | `profile_edit_self`／`profile_edit_branch`／`profile_edit_all` のいずれか | 実装済 |
| 部署マスタ管理 | `master/department_edit.html` | `permission_assign` | 不在 |
| 職務マスタ管理 | `master/position_edit.html` | `permission_assign` | 不在 |
| 契約マスタ管理 | `master/contract_edit.html` | `permission_assign` | 不在 |

---

## 7. 労務（`master/labor/`）

メニュー：`master/labor/index.html`（未設置。`04_02_02_labor_menu.md`）

| ボックス | リンク先 | 表示に必要な権限 | 行き先の状態 | 現状の入口 |
|---|---|---|---|---|
| 給与・報酬計算 | `master/labor/payroll.html` | `labor_payroll_calculate` | 未設置 | なし |
| 勤怠管理 | `master/labor/attendance.html` | `labor_attendance_manage` | 未設置 | なし |
| 社会保険CSV出力 | `master/labor/social_insurance_export.html` | `labor_social_insurance_export` | 実装済 | TOP「労務関係」から直リンク |
| 年末調整（管理） | `master/labor/year_end_adjustment.html` | `labor_year_end_adjustment` | 実装済 | **なし**（どこからも入れない） |

---

## 8. 業務管理（`private/business/`、`corporate/business/`）

| 画面 | 状態 | 現状の入口 |
|---|---|---|
| `private/business/index.html`、`corporate/business/index.html`（業務管理TOP） | 実装済 | **なし**（TOPに「業務管理」のカードが無い） |
| `daily_report.html`、`work_report.html`、`expense.html` | 未設置 | なし |

---

## 9. 入口がない画面・死にリンク（2026-10-27 更新）

### 入口がない画面（実装済なのに、どこからも入れない）
| 画面 | 状況 |
|---|---|
| `employees/index.html`、`employees/edit.html` | TOPの導線が未変更（`hr/index.html`）のため、現状は入れない。TOPが変更されたら、この行を削除する |
| `master/labor/year_end_adjustment.html` | 労務メニューが未設置で、TOPにも直リンクが無い |
| `private/business/index.html`、`corporate/business/index.html` | TOPにカードが無い |

### 入口はあるが、行き先がない（不在）
| 入口 | 行き先 |
|---|---|
| TOP「人事・組織」 | `hr/index.html` |
| TOP「マイページ」、TOPのユーザーメニュー | `common/mypage.html` |
| `master/index.html` の5つのカード | `branch_edit.html`、`department_edit.html`、`position_edit.html`、`contract_edit.html`、`permission_edit.html` |
| `employees/admin_menu.html` の「部署マスタ管理」「職務マスタ管理」「契約マスタ管理」 | `master/department_edit.html`、`master/position_edit.html`、`master/contract_edit.html`（いずれも未設置） |

---

## 10. 未決事項

1. 未実装のリンク先に、最終のURLで「準備中」の仮ページを置く規則を設けるか。
2. マイページの実体の置き場（`common/mypage.html` か `/mypage.html` か）。
3. `common/archive/index.html` の有無。
4. TOPの `session.js` 読み込みと `window.hasPermission()` への置き換え。

---

## 11. 改訂履歴

| 日付 | 版 | 担当 | 内容 | 理由・影響範囲 |
|------|----|------|------|--------------|
| 2026-10-26 | 1.0 | 全体管理者（13代目） | 初版作成。TOP・管理メニュー・人事・組織・労務・業務管理の導線と、入口がない画面・死にリンクを記録 | ツリーだけでは、入口の有無が管理できず、「画面はあるが入口がない」「入口はあるが画面がない」が発生していたため（真柴さん承認）。影響範囲：全担当（画面を追加・変更するときの完了条件） |
| 2026-10-27 | 1.1 | Deepseek（5代目） | 人事メニューのボックス名変更（担当者一覧、従事者名簿）と、人事管理サブメニュー（admin_menu.html）の追加を反映。5節・6節を新設し、7節以降の節番号を繰り下げ。9節の死にリンク一覧を更新 | 人事・組織（従事者管理）の第2段階仕様確定に伴う反映 |
| 2026-10-27 | 1.2 | Deepseek（5代目） | 差し戻し指示（14代目）2.2節の反映。TOP「人事・組織」の状態を「不在」に修正、運用ルールの順序を修正、9節の死にリンクと入口がない画面を修正、先頭の担当表記を修正、4節の記述を8.3節の入口一本化に合わせて修正 | 差し戻し指示（全体管理者14代目）2.2節#1〜#6の反映。影響範囲：本書全般 |
| 2026-10-27 | 1.3 | 全体管理者（14代目） | 3節の注意書きの権限キー表記を、全権キー `supreme_access`（旧 `master_access`）に修正 | 権限キー改名（真柴さん決定）への整合。現行の `session.js` は旧名を判定しているため、旧名の併記が必要。影響範囲：本書3節のみ |
| 2026-10-29 | 1.4 | 全体管理者（14代目） | 4節に「履歴の確認」画面（未設置、案）を追加。5節の「人事異動履歴」に、変更履歴との関係が未決である旨を追記。10節に未決事項5を追加 | 変更履歴仕様（00_10 v1.0、真柴さん承認）の反映。影響範囲：本書4・5・10節 |
| 2026-10-29 | 1.5 | 全体管理者（14代目） | 「履歴の確認」画面の入口を、管理メニュー（4節。`permission_assign` が必要）から、人事メニュー（5節の「変更履歴の確認」ボックス。`change_history_review`）に移した | `change_history_review` だけを持つ確認者が入れるようにするため。05_01 v1.3 と同時。影響範囲：本書4・5節 |
| 2026-10-29 | 1.6 | 全体管理者（14代目） | 人事異動履歴は閲覧専用に確定（`05_08` v2.0）。10節の未決事項5を削除 |