# AI変換機能設計

## 1. 概要

**本機能は現時点では実装しない。将来、必要性が高まった時点で検討する。**

本仕様書は、案件管理システムにおけるAI補助機能の設計を定義する。

- 実装時期：未定
- 判断・分析・所見は行わない
- あくまで調査員の補助ツールとして位置付ける

---

## 2. 対象機能（将来実装時）

| 機能 | 説明 | AIの役割 |
|------|------|---------|
| 文章整形 | 調査メモ（箇条書き・乱文）を自然な文章に整える | 整形のみ。判断・分析はしない |
| 判例検索 | 過去の判例データベースから関連判例を検索 | キーワード検索の補助 |

---

## 3. 文章整形機能（将来実装時の仕様）

### 3.1 概要
- 調査員が入力した調査メモ（箇条書き・乱文）を、自然な文章に整形
- 判断・分析・所見は行わない

### 3.2 入力例
```
松本さん 10/2 17:30 電話
非番で友人宅へ（大原野）
自宅出て右折、京都府道124号へ
速度30km/hくらい
対向車が待機していた
```

### 3.3 出力例
```
事故当日は非番で、大原野にある友人宅へ私用で向かう途中でした。
自宅を出て右折で道路（京都府道124号）に進入し、普段どおり走行していました。
走行速度はおよそ時速30kmでした。
対向車が停止線より4～5メートル手前で停止しており、私の通行を待つ状況でした。
```

---

## 4. 判例検索機能（将来実装時の仕様）

### 4.1 概要
- キーワードから関連判例を検索
- 別冊判例タイムズ等のデータベースと連携

### 4.2 検索条件
| 項目 | 説明 |
|------|------|
| 事故類型 | 車対車 / 車対歩行者 / 交差点 / 追突 等 |
| キーワード | 自由入力 |
| 修正要素 | 夜間 / 高齢者 / 飲酒 / 信号無視 等 |

### 4.3 出力例
```
【検索結果】
別冊判例タイムズNo38 歩行者と四輪車との事故
（2）歩車道の区別のある道路における事故
P118（イ）車道通行が許されていない場合【42】b 車道側端以外の場合
基本割合 車側70%：歩行者側30%
```

---

## 5. 注意事項

- 本機能は**保留**である。現時点では実装しない
- ユーザーは外部AIツール（ChatGPT等）を任意で利用できる
- 実装する場合は、別途仕様書を改訂する
- 実装する場合も、判断・分析・所見は調査員が行うことを明記する

---

## 6. 関連仕様書

| # | 仕様書 | 内容 |
|---|--------|------|
| 1 | `01_case_management.md` | 案件管理全体設計 |
| 2 | `02_case_data_structure.md` | 案件データ構造 |
| 3 | `04_case_input_screens.md` | 入力画面設計 |
---

## 7. エラーハンドリング

| エラー | 表示メッセージ | 対応 |
|--------|--------------|------|
| 調査メモ未入力 | 調査メモを入力してください | 入力チェック |
| APIキー未設定 | AI変換機能が利用できません。管理者に連絡してください | エラーメッセージ表示 |
| API通信エラー | 通信エラーが発生しました。しばらく経ってから再試行してください | リトライ機能（オプション） |
| APIレスポンス不正 | 変換結果の解析に失敗しました | 手動編集を促す |
| タイムアウト | 処理がタイムアウトしました。メモを分割して再試行してください | メモの文字数制限を表示 |

---

## 8. コスト考慮

### 8.1 API利用料金
- ChatGPT API（GPT-4o-mini）: 約$0.15 / 1Mトークン（入力）、$0.60 / 1Mトークン（出力）
- 1回の変換あたりの推定トークン数: 500〜2,000トークン
- 推定コスト: 1件あたり約0.2〜0.8円（日本円）

### 8.2 利用制限（オプション）
- 月間変換回数の上限設定（例：100回/月）
- 1回あたりのメモ文字数制限（例：5,000文字）
- 変換履歴の保存（監査用）

---

## 9. セキュリティ考慮事項

| 項目 | 対策 |
|------|------|
| APIキー漏洩 | サーバー側のみで管理、フロントに露出しない |
| 個人情報 | 変換データはOpenAIに送信されることを明示、利用規約に同意 |
| 入力検証 | XSS対策（エスケープ処理） |
| レート制限 | 同一IPからの過剰リクエストを制限 |

---

## 10. 関連仕様書

| # | 仕様書 | 内容 |
|---|--------|------|
| 1 | `01_case_management.md` | 案件管理全体設計 |
| 2 | `02_case_data_structure.md` | 案件データ構造 |
| 4 | `04_case_input_screens.md` | 入力画面設計 |

---

## 改訂履歴

| 日付 | 版 | 担当 | 内容 | 理由・影響範囲 |
|------|----|------|------|--------------|
| 2026-03-24 | 1.0 | 案件管理担当 | 初版作成 | AI変換機能の定義 |