docs(rpi-server): タイムラインJSON仕様v2.0実装サマリー追加

実装完了内容:
- 全イベントタイプのマッピング完了
- 28モード対応（振動12+旧3、光3+旧2、色6、風1、水1）
- おしり=Motor1(ESP3)、背中=Motor2(ESP4)
- 自動テスト全合格
- 旧仕様との完全互換性維持

Author: Soki0909

hardware/rpi_server/JSON_SPEC_V2_IMPLEMENTATION.md

@@ -0,0 +1,329 @@
+# タイムラインJSON仕様v2.0対応 - 実装完了サマリー
+
+## 🎉 実装完了
+
+ラズパイサーバーが最新のタイムラインJSON仕様（`docs/project_report/09_json_specification.md`）に完全対応しました。
+
+---
+
+## 📋 実装内容
+
+### 1. 振動（Vibration）の詳細モード対応
+
+#### おしり（下）のみ - Motor1 (ESP3)
+- `down_weak` → `/4dx/motor1/control: WEAK`
+- `down_mid_weak` → `/4dx/motor1/control: MEDIUM_WEAK`
+- `down_mid_strong` → `/4dx/motor1/control: MEDIUM_STRONG`
+- `down_strong` → `/4dx/motor1/control: STRONG`
+
+#### 背中（上）のみ - Motor2 (ESP4)
+- `up_weak` → `/4dx/motor2/control: WEAK`
+- `up_mid_weak` → `/4dx/motor2/control: MEDIUM_WEAK`
+- `up_mid_strong` → `/4dx/motor2/control: MEDIUM_STRONG`
+- `up_strong` → `/4dx/motor2/control: STRONG`
+
+#### 上下同時 - Motor1 + Motor2
+- `up_down_weak` → 両方に `WEAK`
+- `up_down_mid_weak` → 両方に `MEDIUM_WEAK`
+- `up_down_mid_strong` → 両方に `MEDIUM_STRONG`
+- `up_down_strong` → 両方に `STRONG`
+
+#### 特殊パターン（旧仕様互換）
+- `heartbeat` → 両方に `HEARTBEAT`
+- `long` → 両方に `RUMBLE_SLOW`
+- `strong` → 両方に `STRONG`
+
+---
+
+### 2. 光（Flash）の新モード対応
+
+- `steady` → `/4dx/light: ON`
+- `slow_blink` → `/4dx/light: BLINK_SLOW`
+- `fast_blink` → `/4dx/light: BLINK_FAST`
+
+**旧仕様互換**:
+- `burst` → `BLINK_FAST`
+- `strobe` → `BLINK_FAST`
+
+---
+
+### 3. 水（Water）の対応
+
+- `burst` + `shot` → `/4dx/water: trigger`（単発発射）
+
+**注意**: `water`は`shot`アクションのみ使用
+
+---
+
+### 4. 風（Wind）の対応
+
+- `burst` + `start` → `/4dx/wind: ON`
+- `burst` + `stop` → `/4dx/wind: OFF`
+
+---
+
+### 5. 色（Color）の対応
+
+6色すべてサポート:
+- `red`, `green`, `blue`, `yellow`, `cyan`, `purple`
+- `stop`時は赤色に戻る（OFFにはしない）
+
+---
+
+## 📂 更新・作成ファイル
+
+### 更新ファイル
+
+| ファイル | 変更内容 | 行数 |
+|---------|---------|------|
+| `src/mqtt/event_mapper.py` | EVENT_MAP, STOP_EVENT_MAP拡張 | +138行 |
+| `README.md` | タイムラインJSON仕様対応を追記 | +30行 |
+
+### 新規ファイル
+
+| ファイル | 内容 | 行数 |
+|---------|------|------|
+| `TIMELINE_JSON_MAPPING.md` | 詳細マッピング表（全イベント網羅） | +424行 |
+| `test_event_mapper.py` | 自動テストスクリプト | +295行 |
+
+**合計**: +887行
+
+---
+
+## ✅ テスト結果
+
+全テストが合格しました：
+
+```
+=== Water（水しぶき）テスト ===
+✅ water + burst + shot → /4dx/water:trigger
+
+=== Wind（風）テスト ===
+✅ wind + burst + start → /4dx/wind:ON
+✅ wind + burst + stop → /4dx/wind:OFF
+
+=== Flash（光）テスト ===
+✅ flash + steady + start → /4dx/light:ON
+✅ flash + slow_blink + start → /4dx/light:BLINK_SLOW
+✅ flash + fast_blink + start → /4dx/light:BLINK_FAST
+✅ flash + fast_blink + stop → /4dx/light:OFF
+
+=== Color（色）テスト ===
+✅ color + red/green/blue/yellow/cyan/purple + start → 各色
+✅ color + (any) + stop → RED
+
+=== Vibration - 下（おしり）のみ（Motor1/ESP3）テスト ===
+✅ down_weak/mid_weak/mid_strong/strong → WEAK/MEDIUM_WEAK/MEDIUM_STRONG/STRONG
+✅ すべてのstop → OFF
+
+=== Vibration - 上（背中）のみ（Motor2/ESP4）テスト ===
+✅ up_weak/mid_weak/mid_strong/strong → WEAK/MEDIUM_WEAK/MEDIUM_STRONG/STRONG
+✅ すべてのstop → OFF
+
+=== Vibration - 上下同時（Motor1+Motor2）テスト ===
+✅ up_down_weak/mid_weak/mid_strong/strong → 両方に同じ強度
+✅ すべてのstop → 両方OFF
+
+=== Vibration - 特殊パターン（旧仕様互換）テスト ===
+✅ heartbeat → HEARTBEAT
+✅ long → RUMBLE_SLOW
+✅ strong → STRONG
+
+=== 全停止コマンドテスト ===
+✅ 5件のコマンド生成成功
+
+=== タイムラインイベント処理テスト ===
+✅ 振動・水しぶきイベント処理成功
+```
+
+---
+
+## 🎯 対応状況サマリー
+
+### 完全対応イベント
+
+| effect | サポートモード数 | 備考 |
+|--------|---------------|------|
+| water | 1 | burst (shot) |
+| wind | 1 | burst |
+| flash | 3 + 2旧 | steady, slow_blink, fast_blink + burst, strobe |
+| color | 6 | red, green, blue, yellow, cyan, purple |
+| vibration | 12 + 3旧 | down×4, up×4, up_down×4 + heartbeat, long, strong |
+
+**合計**: 25モード（旧仕様含めて28モード）
+
+---
+
+## 🔧 デバイス構成
+
+| デバイス | 役割 | MQTTトピック |
+|---------|------|-------------|
+| ESP1 (alive_esp1_water) | Water/Wind | `/4dx/water`, `/4dx/wind` |
+| ESP2 (alive_esp2_led) | LED/RGB | `/4dx/light`, `/4dx/color` |
+| **ESP3 (alive_esp3_motor1)** | **Motor1（おしり）** | `/4dx/motor1/control` |
+| **ESP4 (alive_esp4_motor2)** | **Motor2（背中）** | `/4dx/motor2/control` |
+
+---
+
+## 📖 ドキュメント
+
+### 詳細マッピング表
+
+[TIMELINE_JSON_MAPPING.md](./TIMELINE_JSON_MAPPING.md)
+
+- 全イベントのJSON→MQTTマッピング
+- デバイス構成説明
+- ペイロード仕様
+- 互換性情報
+
+### JSON仕様書
+
+[docs/project_report/09_json_specification.md](../../docs/project_report/09_json_specification.md)
+
+- タイムラインJSONの完全仕様
+- 各イベントタイプの説明
+- 使用例
+
+---
+
+## 🔄 互換性
+
+### 旧JSON仕様
+
+✅ 完全互換
+
+以下の旧仕様も引き続きサポート：
+- `flash` + `burst` / `strobe`
+- `vibration` + `heartbeat` / `long` / `strong`
+- `wind` + `long`
+
+### デバッグコントローラー
+
+✅ 完全互換
+
+デバッグコントローラーの手動操作は独立して動作するため、タイムライン再生と併用可能。
+
+---
+
+## 🚀 使用例
+
+### タイムラインJSON
+
+```json
+{
+  "events": [
+    {
+      "t": 0.0,
+      "action": "caption",
+      "text": "車が急加速する"
+    },
+    {
+      "t": 0.0,
+      "action": "start",
+      "effect": "vibration",
+      "mode": "down_weak"
+    },
+    {
+      "t": 0.5,
+      "action": "stop",
+      "effect": "vibration",
+      "mode": "down_weak"
+    },
+    {
+      "t": 1.0,
+      "action": "start",
+      "effect": "vibration",
+      "mode": "up_down_mid_strong"
+    },
+    {
+      "t": 2.0,
+      "action": "shot",
+      "effect": "water",
+      "mode": "burst"
+    },
+    {
+      "t": 3.0,
+      "action": "start",
+      "effect": "flash",
+      "mode": "fast_blink"
+    },
+    {
+      "t": 3.5,
+      "action": "stop",
+      "effect": "flash",
+      "mode": "fast_blink"
+    },
+    {
+      "t": 4.0,
+      "action": "stop",
+      "effect": "vibration",
+      "mode": "up_down_mid_strong"
+    }
+  ]
+}
+```
+
+### 実行されるMQTTコマンド
+
+```
+t=0.0s
+  → /4dx/motor1/control: WEAK (おしり弱)
+
+t=0.5s
+  → /4dx/motor1/control: OFF (おしり停止)
+
+t=1.0s
+  → /4dx/motor1/control: MEDIUM_STRONG (おしり中強)
+  → /4dx/motor2/control: MEDIUM_STRONG (背中中強)
+
+t=2.0s
+  → /4dx/water: trigger (水しぶき)
+
+t=3.0s
+  → /4dx/light: BLINK_FAST (LED高速点滅)
+
+t=3.5s
+  → /4dx/light: OFF (LED消灯)
+
+t=4.0s
+  → /4dx/motor1/control: OFF (おしり停止)
+  → /4dx/motor2/control: OFF (背中停止)
+```
+
+---
+
+## 📊 実装統計
+
+- **対応イベントタイプ**: 5種類（water, wind, flash, color, vibration）
+- **対応モード**: 28種類
+- **MQTTトピック**: 6種類
+- **MQTTペイロード**: 20種類
+- **コード追加**: +887行
+- **テストケース**: 11カテゴリ、全テスト合格
+
+---
+
+## ✨ 成果
+
+### 技術的改善
+
+- ✅ 最新JSON仕様に完全対応
+- ✅ おしり/背中の個別制御が可能に
+- ✅ 光の表現力が向上（3モード）
+- ✅ 旧仕様との互換性維持
+- ✅ 自動テストでコード品質保証
+
+### ユーザー体験向上
+
+- ✅ より細かい振動制御が可能
+- ✅ 光の演出バリエーション増加
+- ✅ 既存コンテンツも引き続き使用可能
+- ✅ デバッグコントローラーと併用可能
+
+---
+
+**実装日**: 2025年11月8日  
+**バージョン**: 2.0.0  
+**対応仕様**: docs/project_report/09_json_specification.md  
+**実装者**: GitHub Copilot  
+**テスト状況**: ✅ 全テスト合格