# 01_code_definition/01_07_positions.md
# 職務ポジション

版：v2.1（承認待ち）　実装の状況は `work_order_db_migration.md`（作業書）を見る

## 1. 概要
従事者の職務ポジション（旧称：役職・職務）を管理する。保存先は次のテーブル（`schema_master.sql`）。
| テーブル | 内容 |
|---------|------|
| `positions` | 職務ポジションの本体（コード、名称、略称、カテゴリ） |
| `position_companies` | その職務ポジションを使える会社 |
| `position_default_permissions` | 職務ポジションを選んだときの初期権限 |
| `position_rates` | 業務委託の報酬の率（期間つき） |

職務ポジションは、従事者×会社ごとに持つ（`employee_companies.position_cd`）。顧客側の担当者の肩書き（`client_contacts.role`）は「役職」と呼び、これとは別のもの。

## 2. コード一覧（`positions`）
| コード | 職務ポジション名 | カテゴリ |
|-------|-----------------|---------|
| P001 | 代表取締役 | 役員 |
| P002 | 取締役 | 役員 |
| P003 | 監査役 | 役員 |
| P004 | 経理スタッフ | 管理職 |
| P005 | 所長 | 管理職 |
| P006 | 調査チーフマネージャー | 管理職 |
| P007 | 営業チーフマネージャー | 管理職 |
| P008 | 事務管理 | 管理職 |
| P009 | 上級管理職 | 管理職 |
| P010 | 調査マネージャー | 調査職 |
| P011 | 調査主任 | 調査職 |
| P012 | 上級調査員 | 調査職 |
| P013 | 中級調査員 | 調査職 |
| P014 | 初級調査員 | 調査職 |
| P015 | 研修員 | 調査職 |
| P016 | 調査事務 | 調査職 |
| P017 | 下級調査員 | 調査職 |
| P020 | 経理部マネージャー | 経理職 |
| P021 | 経理部主任 | 経理職 |
| P022 | 上級経理職 | 経理職 |
| P023 | 中級経理職 | 経理職 |
| P024 | 初級経理職 | 経理職 |
| P025 | 経理研修員 | 経理職 |
| P030 | 営業マネージャー | 営業職 |
| P031 | 営業主任 | 営業職 |
| P032 | 上級営業職 | 営業職 |
| P033 | 中級営業職 | 営業職 |
| P034 | 初級営業職 | 営業職 |
| P035 | 営業研修員 | 営業職 |
| P036 | 営業事務 | 営業職 |
| P040 | 総務部マネージャー | 事務職・総務 |
| P041 | 総務部主任 | 事務職・総務 |
| P042 | 上級事務職 | 事務職・総務 |
| P043 | 中級事務職 | 事務職・総務 |
| P044 | 初級事務職 | 事務職・総務 |
| P045 | 事務研修員 | 事務職・総務 |
| P050 | SE | システム |
| P060 | 法務 | 法務（将来拡張。`active` は偽） |

### 2.1 コード体系
- 頭文字：Position の P。連番：001〜（3桁）。
- カテゴリごとに、番号のブロックを割り当てる。
  - 001〜003：役員
  - 004〜009：管理職
  - 010〜017：調査職
  - 020〜025：経理職
  - 030〜036：営業職
  - 040〜045：事務職・総務
  - 050：システム
  - 060：法務
- 区分のコード（DB の値）は `HP`（人事・労務の職務ポジション。`01_10`）。
- 略称（`abbr`）は、CEO や SI など。現行データにある。

## 3. 使える会社（`position_companies`）
職務ポジションごとに、使える会社（SPS、SCSPS）を決める。従事者の所属の職務ポジションは、その会社で使えるものから選ぶ。取り込み時は、現行の職務ポジションをすべて両社で使えるものとして登録し、あとで直す。

## 4. 初期権限（`position_default_permissions`）
職務ポジションごとに、初期の権限を持つ。
- 従事者に職務ポジションを設定したとき、そのポジションの初期権限を、従事者の権限（`employee_permissions`）に入れる。
- 入れたあとの権限は、個人ごとに増減できる（最終的な権限は個人に付与する、という考え方は変えない）。職務ポジションを変えたときに、初期権限を入れ直すかどうかは、保存の画面で選ぶ（入れ直さない場合は、今の権限のまま）。
- 初期権限の設定は、権限の付与画面（`06_01`）と同じ、説明文つきのチェックボックスで行う。
- 旧仕様書の「本マスタには権限情報を含めない」を、この節で置き換える。（要確認：初期権限の仕組みを使う方針。作業書 E-07）

### 4.1 案件を見られる範囲（`position_case_access`）
職務ポジションごとに、案件を見られる範囲・直せる範囲の既定を持つ（調査内容と金額まわり、自拠点と他拠点）。一覧と考え方は `04_01_08_case_permission.md` 3〜4節。個人の例外は `employee_case_access`。管理画面での編集は、このマスタの管理画面（`03_02`）に含める。

## 5. 報酬の率（`position_rates`）
業務委託（C06）の報酬は、職務ポジションで決まる（`04_03` 3.3節）。SPS と SCSPS で共通。
| 項目 | 備考 |
|------|------|
| `position_code` | 職務ポジション |
| `investigator_rate` | 調査員の比率（%。調査費Aに対する割合） |
| `mentor_rate` | 指導者配分率（%） |
| `lodging_allowance` | 宿泊日当（円） |
| `document_level` | 作成レベル |
| `valid_from`、`valid_to` | 適用期間。空の `valid_to` は現在有効 |

- 率を変えるときは、新しい行を足し、前の行の `valid_to` に終了日を入れる。上書きしない。
- 案件には、確定時点の率を固定して保存する（`04_03` 1節）。あとで率を変えても、過去の案件の計算は変わらない。
- 個人ごとの率は設けない。直接雇用の給与は `01_08` の `salaries`。
- 閲覧・編集の権限：給与・報酬に関わるため、専用の権限を設ける（未登録。作業書 I-10）。

## 6. 管理画面での追加・編集
- マスタ管理画面（`03_02`）から、職務ポジションを追加・編集できる。
- 追加のとき、次を同時に登録する：名称、略称、カテゴリ、使える会社、初期権限、報酬の率（業務委託で使う場合）。コードは、カテゴリのブロックの次の番号を自動で付ける（`id_counters`）。
- 職務ポジションは削除しない。使わなくなったら `active` を偽にする。

## 7. 保存先
`positions`、`position_companies`、`position_default_permissions`、`position_case_access`（`schema_cases.sql`）、`position_rates`。

## 変更履歴
| 日付 | 版 | 担当 | 変更内容 | 備考 |
|------|----|------|----------|------|
| 2026-03-30 | 1.0 | マスタ管理担当 | 初版作成 | |
| 2026-10-30 | 2.0 | 全体管理者（14代目） | DB前提に書き直し。名称を「職務ポジション」に。使える会社、初期権限、報酬の率、管理画面での追加を追記。「権限情報を含めない」の記述を置き換え | 真柴さんの指示。影響範囲：`02_01`、`04_03`、`06_01`、`03_02`、`schema_master.sql` |
| 2026-10-31 | 2.1 | 全体管理者（14代目） | 4.1節：案件を見られる範囲（`position_case_access`）を追加。7節の保存先に追記 | 真柴さんの指示（`04_01_08` v2.0） |