# 01_case_management.md（完全版）

# 案件管理システム設計書

## 1. 概要

本システムは、SPS（個人事業）および総合調査SPS株式会社（法人）の調査案件を一元管理する。

会計システムと連動し、経費・売上の自動転記を行う。

**本設計書の対象範囲：**
- 案件基本情報管理
- 説明書（聴取項目）管理
- 証拠資料管理（写真、ドライブレコーダ画像、現場図）
- 調査分析（物理的証拠、科学的分析、矛盾点分析）
- 近隣確認管理
- 調査経過管理
- 経費管理
- 報告書自動生成
- 権限管理
- 営業管理連携
- メール送信機能

---

## 2. 案件ステータス定義

| ステータス | 説明 | 経費計上 | 売上計上 | 備考 |
|-----------|------|---------|---------|------|
| **受託** | 依頼受付、見積書発行済 | - | - | 個人（K）・新規法人格（H）案件は、この状態で入金待ちとなる |
| **調査中** | 調査実施中、経費発生 | ✅ 都度計上 | - | 入金確認後、手動でステータス変更 |
| **報告書完了** | 調査終了、報告書作成済 | ✅ | - | 成果物チェックリスト満了時に自動判定 |
| **請求書発行** | 請求書発行済 | ✅ | オプション | |
| **入金待ち** | 請求済み未入金 | ✅ | - | |
| **入金完了** | 入金確認 | ✅ | ✅ | 手動でステータス変更 |

※ ステータス変更はすべて手動（ボタンクリック）で行う
※ 「報告書完了」は成果物チェックリスト全項目完了時に自動判定される

---

## 3. 案件番号自動採番ルール

`[顧客区分] + [受託拠点] + [和暦] + [月] + [月間連番(3桁)] + [着手回数]`

### 顧客区分（法人/SCSPS用）
| コード | 区分 |
|-------|------|
| S | 損害保険会社 |
| A | 損保代理店 |
| L | 弁護士 |
| C | 法人・個人事業 |
| G | 団体 |
| D | 調査会社 |
| E | その他 |

### 顧客区分（個人事業/SPS用）
| コード | 区分 |
|-------|------|
| K | 個人 |
| H | 法人・法人格 |

### 構成要素
| 要素 | 内容 | 例 |
|------|------|-----|
| 顧客区分 | 上記参照 | S / K |
| 受託拠点 | 01:本社, 02:京都, 03:大阪 | 01 |
| 和暦 | R02:令和2年, R03:令和3年 | R02 |
| 月 | 01〜12 | 03 |
| 連番 | 001〜999（月ごと） | 001 |
| 着手回数 | A:初回, B:再着手 | A |

例：
- 法人案件：`S01R0203001A`（損保・本社・令和2年3月・最初の案件・初回着手）
- 個人事業案件：`K01R0203001A`（個人・本社・令和2年3月・最初の案件・初回着手）

---

## 4. 案件種別マスタ

| 種別コード | 種別名 | 説明 | 使用する聴取形式 |
|-----------|--------|------|-----------------|
| ACC | 事故調査 | 車対車、車対歩行者等 | 12項目（基本フォーマット） |
| INJ | 受傷疑義 | むち打ち等、加害者/被害者調査 | 12項目（加害者/被害者別） |
| HAR | 嫌がらせ調査 | ストーカー、嫌がらせ被害 | 自由Q&A |
| ASS | 資産確認調査 | 車両所有者確認、陸運局訪問 | 簡易 |
| GEN | 一般調査 | 行動確認、所在確認等 | 自由Q&A |
| OTH | その他 | 上記以外 | 自由Q&A |

詳細は `03_case_type_master.md` 参照。

---

## 5. 説明書（聴取項目）管理

### 5.1 基本方針
- 調査前に「説明書（聴取項目リスト）」を作成する
- 会社は事故形態ごとに基本フォーマットを用意する
- 調査員は案件に応じてフォーマットを選択し、項目の追加・修正・削除ができる
- 全く同じ事故はないため、柔軟なカスタマイズを必須とする
- 説明書は「聴取メモ」ではなく、案件によっては「証拠書類」として扱う

### 5.2 基本フォーマット（12項目）

| # | 項目 | 説明 |
|---|------|------|
| ① | 事故前の目的地、出発地、目的 | 行動経路、状況把握 |
| ② | 天気、路面状況 | 環境要因の確認 |
| ③ | 事故現場の状況（道路状況、交通量） | 現場環境の把握 |
| ④ | 相手に対する見通し | 視界条件、障害物の有無 |
| ⑤ | 相手を発見する前の速度と状況 | 事前状態の把握 |
| ⑥ | 相手を最初に発見した地点と速度、相互の距離 | 危険認知時点の特定 |
| ⑦ | 危険を感じた時の対応 | 回避行動の有無・内容 |
| ⑧ | 衝突地点と双方の停止位置 | 事故後の状況 |
| ⑨ | 車両の衝突損傷箇所 | 物理的証拠 |
| ⑩ | 怪我等 | 人的被害、法定事項 |
| ⑪ | 事故原因についての見解 | 当事者の認識 |
| ⑫ | その他 | 補足情報 |

詳細は `03_case_type_master.md` 参照。

---

## 6. 案件一覧表示の役割分担

### 6.1 システムのindex（進捗管理ダッシュボード）

| 項目 | 内容 |
|------|------|
| ファイル | `/index.html` |
| 目的 | 電話対応、進捗確認 |
| 表示対象 | 権限に応じた案件一覧（終了案件以外） |
| 表示項目 | 案件番号、依頼元、担当、進捗状況、予定期限、遅延フラグ |
| クリック | 小窓で詳細表示（編集不可） |
| 新規登録 | なし |

### 6.2 案件管理のindex（案件管理画面）

| 項目 | 内容 |
|------|------|
| ファイル | `/cases/index.html` |
| 目的 | 案件管理作業（編集、経費入力、報告書出力等） |
| 表示対象 | 権限に応じた案件一覧（全件 or 担当案件） |
| 表示項目 | 案件番号（リンク）、受託日、依頼元、調査種目、主担当、状態、請求金額、入金日、報告書有無、経費計上状況、ロック状態 |
| クリック | 案件詳細画面へ遷移（編集可） |
| 新規登録 | あり（未ロック） |
| 検索 | 案件ID検索 |
| 印刷 | 案件一覧印刷 |

### 6.3 案件管理のindexの表示項目（現行Excelベース）

| 項目 | 現行Excel | システム化 |
|------|----------|-----------|
| 案件番号（リンク） | B列 | ✅ |
| 受託日 | C列 | ✅ |
| 依頼元 | D列 | ✅ |
| 調査種目 | H列 | ✅ |
| 主担当 | I列 | ✅ |
| ステータス | （なし） | ✅ 新規 |
| 請求金額 | Q列 | ✅ |
| 入金日 | S列 | ✅ |
| 報告書有無 | （なし） | ✅ 新規 |
| 経費計上状況 | （なし） | ✅ 新規 |
| ロック状態 | （なし） | ✅ 新規 |

---

## 7. 画面遷移図

```
【システムのindex】
    ↓ 「案件管理へ」ボタン
【案件管理のindex（cases/index.html）】
    ├─ 案件一覧表示（権限に応じた案件）
    ├─ 新規案件登録ボタン（未ロック）
    ├─ 案件ID検索
    └─ 印刷ボタン
         ↓ 案件番号クリック
【案件詳細画面（view.html）】
    ├─ 基本情報タブ
    ├─ 聴取内容タブ
    ├─ 経費タブ
    ├─ 経過タブ
    ├─ 近隣確認タブ
    ├─ 証拠資料タブ
    └─ 分析タブ
         ↓ 「編集」ボタン
【案件入力画面（input.html）】
    ├─ 各タブ編集モード
    └─ 保存

【営業管理のindex】
    ↓ 「新規案件登録」ボタン（mode=sales）
【案件入力画面（input.html）】
    ├─ 営業担当ID自動入力
    ├─ 自動ロック
    └─ 保存
```

詳細は `04_case_input_screens.md` 参照。

---

## 8. 新規案件登録の2つの入口

| 入口 | 対象者 | 営業担当ID | ロック |
|------|--------|-----------|--------|
| 営業管理から | 営業担当、上級調査職 | 自動入力（ログインユーザー） | **自動ロック** |
| 案件管理から | 事務職、管理者 | プルダウン選択 | **未ロック** |

詳細は `12_case_sales_link.md` 参照。

---

## 9. ロック機能（本登録）

### 9.1 目的
- 営業担当が案件情報を確認した証
- 個人情報保護の証
- ロック後は担当者ID（営業担当/主担当/副担当/管理者）は編集不可（権限者のみ）

### 9.2 ロック状態

| 状態 | 説明 | 調査開始 | ID編集 |
|------|------|---------|--------|
| 未ロック | 営業確認待ち | ✅ 可 | 可（権限者のみ） |
| ロック済 | 営業確認済 | ✅ 可 | 不可（管理者のみ） |

### 9.3 ペナルティ
- ロックしないとシステムに記録（人事評価に反映）

詳細は `02_case_data_structure.md`、`08_case_permission.md` 参照。

---

## 10. 写真/画像報告書

### 10.1 概要
- 現場写真、ドライブレコーダ画像をアップロード
- 説明文を付与
- 自動レイアウトでPowerPoint報告書を生成

詳細は `06_case_photo_report.md` 参照。

---

## 11. 現場図連携

### 11.1 方針
- 現場図はシステム外（Visio、Illustrator、CAD等）で作成
- 作成したPDFをアップロード
- 案件に紐付けて保存
- 報告書に自動埋め込み

詳細は `06_case_photo_report.md` 参照。

---

## 12. 調査分析

### 12.1 物理的証拠分析
| 項目 | 入力形式 |
|------|---------|
| 損傷箇所（自車/相手車） | 図示（画像上にマーキング）＋自由記述 |
| 入力痕の方向 | 角度入力 |
| スリップ痕の有無・形状 | 自由記述＋図示 |
| 分析結果 | 自由記述 |

### 12.2 科学的分析
| 項目 | 計算方法 |
|------|---------|
| 空走距離 | 速度(km/h) × 0.75 × 1000/3600 |
| 制動距離 | 速度² / (2 × 摩擦係数 × 重力加速度) |
| 停止距離 | 空走距離 + 制動距離 |
| 回避可能性 | 実際の停止距離と理論値の比較 |

### 12.3 矛盾点分析
| 項目 | 入力形式 |
|------|---------|
| 相手方主張 | 自由記述 |
| 客観的事実 | 自由記述 |
| 分析結果 | 自由記述 |

詳細は `02_case_data_structure.md`、`04_case_input_screens.md` 参照。

---

## 13. 近隣確認

### 13.1 機能要件
- 複数行入力（住民ごとの聞き込み）
- 「集約」ボタン（重複・類似内容をまとめる）
- 項目別整理
- 集約結果の編集機能

詳細は `02_case_data_structure.md`、`04_case_input_screens.md` 参照。

---

## 14. 報告書自動生成

### 14.1 出力物一覧

| 出力物 | 形式 | 生成方式 |
|--------|------|---------|
| 報告書本文 | Word（.docx）/ PDF | 自動生成 |
| 現場写真報告書 | PowerPoint（.pptx）/ PDF | 自動生成 |
| ドライブレコーダ画像報告書 | PowerPoint（.pptx）/ PDF | 自動生成 |
| 経費明細書 | PDF | 自動生成 |
| 請求書 | PDF | 自動生成 |
| 現場図 | PDF | アップロード（自動埋め込み） |
| 説明書（聴取用） | PDF | 自動生成 |
| 説明書（証拠用） | PDF | 自動生成 |
| 案件一覧 | PDF | 自動生成（印刷用） |

詳細は `07_case_document_generate.md`、`10_case_export.md` 参照。

---

## 15. 経費精算管理

### 15.1 基本方針
- 案件の進行状態と経費精算状態は別管理とする
- 案件未完了であっても、承認済み経費は先行して精算できるものとする
- 調査員は承認済み経費を選択し、会社に対して「精算請求書」を発行できる
- 調査員はマイページで自分の経費精算状況（未払い/支払済）を確認できる

### 15.2 経費精算状態

| 状態 | 説明 | 誰が操作 |
|------|------|---------|
| 未申請 | 経費入力のみ、未承認 | - |
| 申請中 | 承認待ち | 管理者 |
| 承認済 | 承認済み、未精算請求 | 調査員（精算請求可能） |
| 精算請求中 | 精算請求書発行済、未支払 | 管理者/会計 |
| 支払済 | 支払完了 | 調査員（確認のみ） |

詳細は `02_case_data_structure.md`、`09_case_accounting_link.md` 参照。

---

## 16. 請求・売上連動の必須条件（成果物チェックリスト）

| # | 項目 | 必須条件 | 確認方法 |
|---|------|---------|---------|
| 1 | 案件基本情報 | 必須項目すべて入力済 | システム自動チェック |
| 2 | 説明書（聴取項目） | 項目が確定している | システム自動チェック |
| 3 | 聴取内容 | 必要な聴取対象者の入力完了 | 案件種別に応じて |
| 4 | 報告書本文 | 生成可能状態 | システム自動チェック |
| 5 | 写真/画像 | 必要枚数登録完了 | 案件種別に応じて |
| 6 | 現場図 | 必要案件は登録完了 | 案件種別に応じて |
| 7 | 経費 | 経費入力完了 | システム自動チェック |
| 8 | 管理者確認 | 上記すべてを管理者が確認済 | 管理者操作 |

詳細は `02_case_data_structure.md` 参照。

---

## 17. 会計連動設計

### 17.1 連動の基本方針

| 方向 | 対応 |
|------|------|
| 案件管理 → 会計 | ✅ 転記する（一方通行） |
| 会計 → 案件管理 | ❌ 現時点では連動しない |

### 17.2 会計システムでの状態遷移

| status | 意味 | 集計対象 | 編集 | 備考 |
|--------|------|---------|------|------|
| `pending` | 未確認（案件管理から転記） | ❌ 対象外 | ✅ 可能 | 案件管理からの転記データ |
| `confirmed` | 確定済み | ✅ 対象 | ✅ 可能 | 会計担当が確認済み |
| `locked` | 申告済みロック | ✅ 対象 | ❌ 不可 | 確定申告後にロック |

詳細は `09_case_accounting_link.md` 参照。

---

## 18. 権限設計

### 18.1 権限一覧（案件管理用）

| 権限キー | 説明 | 主な対象 |
|---------|------|---------|
| `case_list_view` | 案件一覧を表示できる | 全従事者 |
| `case_detail_view_own` | 自案件の詳細を表示できる | 調査員、営業 |
| `case_detail_view_all` | 全案件の詳細を表示できる | 管理者、会計 |
| `case_edit_basic` | 案件基本情報を編集できる（自案件） | 管理者、営業 |
| `case_edit_basic_all` | 全案件の基本情報を編集できる | 管理者 |
| `case_edit_hearing` | 説明書（聴取項目）を編集できる（自案件） | 調査員 |
| `case_edit_hearing_all` | 全案件の説明書を編集できる | 管理者 |
| `case_edit_analysis` | 調査分析を入力・編集できる（自案件） | 調査員、管理者 |
| `case_edit_analysis_all` | 全案件の調査分析を編集できる | 管理者 |
| `case_edit_nearby` | 近隣確認を入力・編集できる（自案件） | 調査員 |
| `case_edit_nearby_all` | 全案件の近隣確認を編集できる | 管理者 |
| `case_edit_expense_own` | 自案件の経費を入力・編集できる | 調査員、営業 |
| `case_edit_expense_all` | 全案件の経費を編集できる | 管理者、会計 |
| `case_expense_approve_own` | 自案件の経費を承認できる | 管理者 |
| `case_expense_approve_all` | 全案件の経費を承認できる | 管理者 |
| `case_edit_progress` | 調査経過を入力・編集できる（自案件） | 調査員 |
| `case_edit_progress_all` | 全案件の調査経過を編集できる | 管理者 |
| `case_upload_evidence_own` | 自案件に証拠資料をアップロードできる | 調査員 |
| `case_upload_evidence_all` | 全案件に証拠資料をアップロードできる | 管理者 |
| `case_generate_document_own` | 自案件の報告書を生成できる | 調査員、管理者 |
| `case_generate_document_all` | 全案件の報告書を生成できる | 管理者、会計 |
| `case_invoice_issue_own` | 自案件の請求書を発行できる | 管理者、会計 |
| `case_invoice_issue_all` | 全案件の請求書を発行できる | 管理者、会計 |
| `case_reimbursement_request` | 承認済み経費の精算請求ができる | 調査員 |
| `case_reimbursement_approve` | 精算請求を承認し支払処理ができる | 管理者、会計 |
| `case_readiness_confirm` | 成果物チェックリストの管理者確認ができる | 管理者 |
| `case_contact_owner` | 担当者にメール連絡できる | 電話対応担当 |
| `case_create_from_sales` | 営業管理から新規案件登録できる（自動ロック） | 営業担当、上級調査職 |
| `case_create_from_cases` | 案件管理から新規案件登録できる（未ロック） | 事務職、管理者 |
| `case_lock` | 案件をロックできる | 営業担当、管理者 |
| `case_edit_locked` | ロック済み案件の基本情報を編集できる | 管理者 |
| `my_expense_view` | 自分の経費精算状況をマイページで確認できる | 全従事者 |

詳細は `08_case_permission.md` 参照。

---

## 19. 出力仕様

### 19.1 印刷仕様
- `02_print_spec.md` に準拠する

### 19.2 日付表示
- `03_ui_design/01_design_guideline.md` の日付表記ルールに準拠する

### 19.3 UIデザイン
- `03_ui_design/01_design_guideline.md` に準拠する

詳細は `10_case_export.md` 参照。

---

## 20. メール送信機能

### 20.1 概要
- 電話対応担当が問い合わせを受けた際、担当者にメールで連絡する
- システムから担当者の社内メールアドレス宛にメールを送信する
- 送信履歴は案件データに保存する

### 20.2 権限
- `case_contact_owner` 権限を持つユーザーのみ利用可能

### 20.3 受信設定
- 各担当者は社内メール（scsps.jp）をGmailで受信設定すること
- POP3設定を推奨（Xサーバーにメールを残さないため）

詳細は `11_case_mail.md` 参照。

---

## 21. 営業管理連携

### 21.1 基本方針
- 案件入力画面は案件管理担当が実装する
- 営業管理のindexには案件入力画面へのリンクを設置する
- リンクには `mode=sales` パラメータを付与する

### 21.2 連携方法
- 営業管理のindex → `/cases/input.html?mode=sales`
- 案件管理のindex → `/cases/input.html`（パラメータなし）

詳細は `12_case_sales_link.md` 参照。

---

## 22. AI活用に関する基本方針

### 22.1 現時点の対応
- システム内にAI機能は実装しない
- 文章整形、判例検索等はユーザーが任意の外部ツール（ChatGPT等）を利用する
- 判断・分析・所見はすべて調査員が行う

### 22.2 将来の拡張性
- AI機能を追加できる設計とする
- API連携を想定したインターフェースを確保する
- 実装時期は未定

### 22.3 禁止事項
- AIによる判断・分析・所見作成機能は実装しない
- 過失割合の自動判定機能は実装しない
- 報告書の自動生成は入力データのテンプレート流し込みに限定する

詳細は `05_case_ai_conversion.md` 参照。

---

## 23. 警察監査対応

### 23.1 案件単位で保存すべき情報
- 依頼者の本人確認書類有無
- 第7条確認書（有/無、保存場所）
- 第8条1項説明書（有/無）
- 第8条2項契約書（有/無）
- 調査報告書（PDF保存）
- 経費明細（自動保存）
- 説明書（聴取項目）と回答内容
- 署名・捺印済み証拠書類（該当案件のみ）
- 写真/画像報告書
- 現場図

### 23.2 監査ビュー
- 「警察監査モード」ボタン
- 選択した案件の必要書類一覧を表示
- 不足書類をハイライト
- ワンクリックで書類PDFを開く

---

## 24. 関連仕様書

| # | 仕様書 | 内容 |
|---|--------|------|
| 1 | `02_case_data_structure.md` | 案件データ構造（JSONスキーマ） |
| 2 | `03_case_type_master.md` | 案件種別マスタ設計 |
| 3 | `04_case_input_screens.md` | 入力画面設計 |
| 4 | `05_case_ai_conversion.md` | AI補助機能設計（将来拡張用） |
| 5 | `06_case_photo_report.md` | 写真/画像報告書生成設計 |
| 6 | `07_case_document_generate.md` | 報告書自動生成設計 |
| 7 | `08_case_permission.md` | 権限設計 |
| 8 | `09_case_accounting_link.md` | 会計連動設計 |
| 9 | `10_case_export.md` | 出力仕様 |
| 10 | `11_case_mail.md` | メール送信機能仕様 |
| 11 | `12_case_sales_link.md` | 営業管理連携仕様 |

---

## 25. 改訂履歴

| 日付 | 版 | 担当 | 内容 |
|------|----|------|------|
| 2026-03-12 | 1.0 | - | 初版作成 |
| 2026-03-24 | 1.1 | 全体管理者 | 着任手順・辞退条件・全体管理者指示・着任テンプレートを追記 |
| 2026-03-24 | 1.2 | 案件管理担当 | 案件種別対応、聴取内容定型化、写真報告書、現場図連携を追記 |
| 2026-03-24 | 1.3 | 案件管理担当 | AI活用に関する基本方針を追加 |
| 2026-03-24 | 1.4 | 案件管理担当 | 経費精算管理、成果物チェックリスト、会計連動条件を統合 |
| 2026-03-24 | 1.5 | 案件管理担当 | 説明書（聴取項目）管理、心理的効果、証拠化を追記 |
| 2026-03-26 | 1.6 | 案件管理担当 | 案件一覧の役割分担、営業管理連携、ロック機能、メール送信機能を追記 |
| 2026-03-26 | 1.7 | 案件管理担当 | 印刷仕様・日付表示・UIデザインを共通仕様参照に修正 |