# 11_case_mail.md

# メール送信機能仕様

## 1. 概要

本仕様書は、案件管理システムにおけるメール送信機能を定義する。

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

---

## 2. 権限

| 権限キー | 説明 | 主な対象 |
|---------|------|---------|
| `case_contact_owner` | 担当者にメール連絡できる | 電話対応担当 |

---

## 3. 画面イメージ

```
┌─────────────────────────────────────────────────────────────────┐
│ 案件: L01R0702001A（黒瀬 憲一）                                 │
├─────────────────────────────────────────────────────────────────┤
│ 【担当者に連絡】                                                 │
│                                                                 │
│ 相手の名前: [中川 龍也________________]                          │
│ 相手の電話番号: [075-748-7050__________]                        │
│ 問い合わせ内容:                                                  │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 報告書の納期について問い合わせがありました。                │ │
│ └─────────────────────────────────────────────────────────────┘ │
│                                                                 │
│ [メール送信]                                                     │
│                                                                 │
│ 【送信履歴】                                                    │
│ 2026-03-26 10:00 中川龍也様からの問い合わせを真柴直也様に送信  │
└─────────────────────────────────────────────────────────────────┘
```

---

## 4. メール送信仕様

### 4.1 送信元
- システム用メールアドレス：`system@scsps.jp`

### 4.2 送信先
- 担当者の社内メールアドレス（`employees.json` の `email` フィールド）

### 4.3 件名
```
【SPS案件管理】問い合わせ連絡
```

### 4.4 本文（テンプレート）
```
案件: [案件番号]（[依頼者名]）
相手: [相手の名前]
電話: [相手の電話番号]
内容: [問い合わせ内容]

※ このメールはシステムから自動送信されています。
```

---

## 5. API仕様

### 5.1 メール送信API

**エンドポイント**: `POST /master/api/send_case_mail.php`

**リクエスト**:
```json
{
  "case_id": "L01R0702001A",
  "to_employee_id": "00001",
  "contact_name": "中川 龍也",
  "contact_phone": "075-748-7050",
  "message": "報告書の納期について問い合わせがありました。"
}
```

**レスポンス（成功）**:
```json
{
  "success": true,
  "contact_log_id": "contact_001"
}
```

**レスポンス（エラー）**:
```json
{
  "success": false,
  "error": "メール送信に失敗しました"
}
```

---

## 6. 送信履歴の保存

### 6.1 保存先
- 案件JSONの `contact_logs` 配列

### 6.2 データ構造
```json
{
  "contact_logs": [
    {
      "id": "contact_001",
      "sent_at": "2026-03-26T10:00:00+09:00",
      "sent_by": "00010",
      "sent_by_name": "電話対応担当A",
      "to_employee_id": "00001",
      "to_employee_name": "真柴 直也",
      "to_email": "mashiba@scsps.jp",
      "subject": "【SPS案件管理】問い合わせ連絡",
      "body": "案件: L01R0702001A（黒瀬 憲一）\n相手: 中川龍也\n電話: 075-748-7050\n内容: 報告書の納期について問い合わせがありました。",
      "status": "sent"
    }
  ]
}
```

---

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

| エラー | 表示メッセージ | 対応 |
|--------|--------------|------|
| 担当者のメールアドレス未設定 | 「担当者のメールアドレスが設定されていません」 | 管理者に連絡 |
| メール送信失敗 | 「メール送信に失敗しました。しばらく経ってから再試行してください」 | 再試行ボタン表示 |
| 権限なし | 「この操作を行う権限がありません」 | ボタンを非表示 |

---

## 8. 受信設定（運用）

各担当者は社内メール（scsps.jp）をGmailで受信設定すること。

- POP3設定を推奨（Xサーバーにメールを残さないため）
- 設定方法は別途運用ドキュメント参照

---

## 9. 関連仕様書

| # | 仕様書 | 内容 |
|---|--------|------|
| 1 | `01_case_management.md` | 案件管理全体設計 |
| 2 | `02_case_data_structure.md` | 案件データ構造（contact_logs） |
| 4 | `04_case_input_screens.md` | 入力画面設計（担当者連絡機能） |
| 8 | `08_case_permission.md` | 権限設計（case_contact_owner） |
```
## 改訂履歴

| 日付 | 版 | 担当 | 内容 | 理由・影響範囲 |
|------|----|------|------|--------------|
| 2026-03-27 | 1.0 | 案件管理担当 | 初版作成 | 電話対応時の担当者連絡機能実装のため |