# 製品仕様書 — 打ち出の小槌 Mobile

> 作成日：2026-04-22　バージョン：1.0　ステータス：Draft

---

## 1. 対応OS・技術基盤

| 項目 | 仕様 |
|---|---|
| iOS | iOS 16.0 以上（iPhone 12以降を最適化対象） |
| Android | Android 12 以上（Android 13推奨） |
| フレームワーク | React Native 0.74（クロスプラットフォーム） |
| API通信 | REST API + WebSocket（リアルタイム通知） |
| 認証 | OAuth 2.0 / SAML 2.0（既存本体SSO連携） |
| データ暗号化 | AES-256（保存時）/ TLS 1.3（転送時） |

---

## 2. 機能要件（5画面詳細）

### 画面1：ホームダッシュボード

**概要**：起動直後に表示されるメイン画面。本日・当週・当月のKPIを一覧表示する。

**表示コンポーネント**

| コンポーネント | 内容 |
|---|---|
| KPIサマリーカード | 売上／注文数／客単価／CV率（前日比バッジ付き） |
| AIアクション推奨バナー | 最優先アクション1件をハイライト表示、1タップ実行ボタン |
| アラートリスト | 離脱リスク顧客数・売上急落アラートの件数バッジ |
| ショートカットグリッド | よく使う機能への4〜6個のクイックアクセスボタン |

**機能詳細**

- KPIの粒度は「本日 / 当週 / 当月 / 当年」でスワイプ切替
- 各KPIカードをタップすると詳細分析画面へドリルダウン
- プルトゥリフレッシュでリアルタイムデータを再取得（最大遅延30秒）
- AIバナーは機械学習スコアに基づき1日最大3件をローテーション

---

### 画面2：顧客セグメント＆配信管理

**概要**：既存の打ち出の小槌本体で作成済みのセグメントを閲覧・配信実行する画面。

**表示コンポーネント**

| コンポーネント | 内容 |
|---|---|
| セグメント一覧 | 顧客数・最終配信日・配信成果（開封率/CV率）表示 |
| 配信チャネル選択 | メール・LINE・プッシュ通知をトグルで選択 |
| 配信スケジューラー | 即時送信 or 日時指定（カレンダーUI） |
| 承認ワークフロー | 上長への承認リクエスト送信・承認・差し戻し |

**機能詳細**

- セグメント作成はモバイル非対応（本体PC画面で実施）
- 配信前プレビュー：実際の配信コンテンツをモバイル画面でレンダリング確認
- 送信後：リアルタイムで開封数・クリック数のライブカウンターを表示
- 承認は最大3段階ワークフローに対応（設定は本体側で管理）

---

### 画面3：LTV分析

**概要**：顧客コホート別のライフタイムバリューを可視化し、収益貢献シミュレーションを提供する。

**表示コンポーネント**

| コンポーネント | 内容 |
|---|---|
| コホートヒートマップ | 初回購入月×経過月のリテンション率グリッド |
| LTVトレンドチャート | 直近12か月の平均LTV推移折れ線グラフ |
| セグメント別LTV比較 | 棒グラフで上位5セグメントを比較 |
| シミュレーター | 施策実行時の期待LTV増分を試算するインタラクティブUI |

**機能詳細**

- チャートはピンチズームに対応
- CSVエクスポートはモバイルアプリ内で完結（メール添付 or クラウドストレージ保存）
- シミュレーターは「リピート促進施策を全顧客に適用した場合」等の定型テンプレート5種を用意

---

### 画面4：AIアクション推奨

**概要**：機械学習モデルが生成した優先施策リストを表示し、モバイルから即実行できる画面。

**表示コンポーネント**

| コンポーネント | 内容 |
|---|---|
| アクションカードリスト | スコア順に並んだ推奨施策カード（最大20件） |
| 期待効果タグ | 「+¥1.2M売上見込み」「離脱防止 230名」等のバッジ |
| 実行ステータス | 実行済 / 保留 / スキップのステータス管理 |
| フィードバックUI | 「役立った」「関係ない」の2択フィードバックで精度向上 |

**機能詳細**

- アクションは「配信実行」「クーポン発行」「チームへの共有」の3種に分類
- 1タップ実行後は確認ダイアログを表示（誤操作防止）
- 実行ログは本体システムに自動同期

---

### 画面5：通知・アラートセンター

**概要**：システム全体のアラートを一元管理するインボックス型画面。

**表示コンポーネント**

| コンポーネント | 内容 |
|---|---|
| アラートリスト | 優先度（緊急/警告/情報）別の色分けバッジ |
| フィルター | チャネル別・期間別・対応ステータス別で絞り込み |
| アクションショートカット | アラートからそのまま配信・分析画面へ遷移 |
| 既読管理 | スワイプで既読・アーカイブ |

**機能詳細**

- プッシュ通知のON/OFFはアラート種別ごとに細かく設定可能
- 静音モード（勤務外時間）の設定に対応
- アラート履歴は90日間保持

---

## 3. 画面遷移図（概要）

```
ホームダッシュボード（タブ1）
├── KPIカードタップ → LTV分析画面
├── AIバナータップ → AIアクション推奨画面
└── アラートバッジタップ → 通知・アラートセンター

セグメント配信（タブ2）
├── セグメント選択 → 配信設定画面
└── 配信設定 → 承認リクエスト送信

LTV分析（タブ3）
├── コホートセル選択 → 顧客リスト（本体連携）
└── シミュレーター → 施策選択 → AIアクション推奨

AIアクション（タブ4）
└── アクション選択 → 実行確認 → 配信 / クーポン / 共有

通知センター（タブ5 / グローバルアクセス可）
└── アラート選択 → 関連画面へ遷移
```

---

## 4. 非機能要件

### 4-1. パフォーマンス

| 指標 | 目標値 |
|---|---|
| アプリ初回起動時間 | 3秒以内（コールドスタート） |
| ダッシュボード表示 | 1.5秒以内（LTE環境） |
| API レスポンス（p95） | 800ms以内 |
| クラッシュフリーレート | 99.5%以上 |
| フレームレート | 60fps維持 |

### 4-2. セキュリティ

| 項目 | 仕様 |
|---|---|
| 認証 | 生体認証（Face ID / 指紋）+ PINによる多要素対応 |
| セッション管理 | 非アクティブ30分で自動ロック（設定変更可） |
| データ保存 | 端末内キャッシュはKeychain / Android KeyStoreで暗号化 |
| 通信 | 証明書ピンニングによるMitM攻撃対策 |
| ログ | アクセスログを本体システムへ同期、改ざん検知対応 |
| 権限管理 | 本体CRMのロール設定をモバイルに継承 |

### 4-3. オフライン対応

| 機能 | オフライン挙動 |
|---|---|
| ダッシュボード | 最終取得データを表示（タイムスタンプ明示） |
| KPIチャート | キャッシュデータで閲覧可能（最大24時間） |
| 配信実行 | 不可（オンライン復帰後に再試行を促す） |
| アラート閲覧 | キャッシュ済みアラートのみ表示可能 |
| アクション保存 | 下書き保存のみ対応、送信はオンライン時 |

---

## 5. 外部連携

| 連携先 | 方式 | 用途 |
|---|---|---|
| 打ち出の小槌 本体 | REST API v3 | 顧客データ・セグメント・KPI同期 |
| Shopify | Webhook + API | 注文・顧客データリアルタイム取得 |
| ECキューブ | REST API | 注文・商品マスタ取得 |
| Makeshop | CSVインポート + API | 顧客・購買データ連携 |
| Salesforce | OAuth連携 | 商談・顧客データ双方向同期 |
| Firebase | SDK | プッシュ通知（FCM / APNs） |
| Mixpanel | SDK | アプリ内行動ログ分析 |

---

*本仕様書はDraft版です。実装前に改めてレビューを実施します。*