Ops Web
運用管理Webアプリケーション（ops-web）について説明します。
概要
ops-webは、Bazbiiシステムの運用管理を行うためのWebアプリケーションです。運営チームがシステムの健全性を監視し、パートナーやユーザーのサポートを行うためのダッシュボードを提供します。
技術スタック
- フレームワーク: Next.js 15.5.4
- UI: React 19.1.0, Tailwind CSS 4
- TypeScript: 5.x
アクセス
- 開発環境:
http://localhost:3001（PORT_OPS環境変数で設定） - 本番環境:
https://ops.bazbii.app（将来実装）
主要機能
1. KPIダッシュボード
システムの健全性とビジネス指標をリアルタイムで監視します。
2. ヘルスステータス監視
API、Gateway、データベースなどの依存リソースの稼働状況を可視化します。
3. パートナー管理
パートナーの情報管理、公式クレームの承認、サポート対応を行います。
4. ユーザーサポート
ユーザーからの問い合わせ対応、アカウント管理を行います。
監視すべき項目
0. System Health / SLO（システム健全性）
システム全体の健全性を監視する基本的な指標です。
| 指標 | 単位 | 説明 | 目標値 |
|---|---|---|---|
| RPS (Total) | req/s | API+Gatewayの合計リクエスト数 | - |
| Error Rate | % | 5xxエラー / 全体リクエスト | < 1% |
| p95 Latency (API) | ms | API Serverの95パーセンタイルレイテンシ | < 500ms |
| p95 Latency (Gateway) | ms | Gatewayの95パーセンタイルレイテンシ | < 200ms |
| Deps Health (DB/Cache) | - | 依存リソース（DB、キャッシュ）の稼働率 | > 99.9% |
| Trace Sampling | % | OpenTelemetry→Tempoへのトレース送信率 | 10-100% |
アラート設定:
- Error Rate > 1%: 警告
- Error Rate > 5%: 緊急
- p95 Latency (API) > 500ms: 警告
- p95 Latency (Gateway) > 200ms: 警告
- Deps Health < 99%: 緊急
1. Product Immediacy（プロダクト即時性）
位置情報とソーシャル機能の活性度を監視します。
| 指標 | 単位 | 説明 | 目標値 |
|---|---|---|---|
| 近傍投稿レート | /min | 現在地周辺への投稿頻度 | > 10/min |
| ソーシャル投稿レート | /min | タイムラインへの投稿頻度 | > 20/min |
| 重複表示率 | % | 近傍タイムラインとソーシャルタイムラインの重複率 | 20-40% |
| 近接度中央値 | m | 閲覧者と投稿地点の距離の中央値 | < 500m |
| H3アクティブセル数 | cells | アクティブなH3セルの数 | > 100 |
| カバレッジ | % | アクティブ地域 / 全地域 | > 50% |
アラート設定:
- 近傍投稿レート < 5/min: 警告（地域の活性度が低下）
- H3アクティブセル数 < 50: 警告（地理的カバレッジが低下）
- カバレッジ < 30%: 警告（サービスエリアの縮小）
2. Experience Quality（体験品質）
フィード機能の品質とパフォーマンスを監視します。
| 指標 | 単位 | 説明 | 目標値 |
|---|---|---|---|
| Timeline p95 (現在地) | ms | 現在地ベースフィードの95パーセンタイルレイテンシ | < 300ms |
| Timeline p95 (ソーシャル) | ms | ソーシャルタイムラインの95パーセンタイルレイテンシ | < 500ms |
| Queue 滞留 | items | fanout/集約キューに滞留しているアイテム数 | < 100 |
| レコメンド命中率 | % | ユーザーに表示されたレコメンドのクリック率 | > 5% |
アラート設定:
- Timeline p95 (現在地) > 500ms: 警告
- Timeline p95 (ソーシャル) > 1000ms: 警告
- Queue 滞留 > 1000: 緊急（バックログの蓄積）
3. Engagement（エンゲージメント）
ユーザーのエンゲージメント指標を監視します。
| 指標 | 単位 | 説明 | 目標値 |
|---|---|---|---|
| DAU/MAU | % | 日次アクティブユーザー / 月次アクティブユーザー | > 20% |
| 投稿作成率 | % | アクティブユーザーの中で投稿を作成した割合 | > 10% |
| フィード閲覧率 | % | アクティブユーザーの中でフィードを閲覧した割合 | > 80% |
| セッション時間 | min | ユーザーの平均セッション時間 | > 5min |
アラート設定:
- DAU/MAU < 15%: 警告（リテンションの低下）
- 投稿作成率 < 5%: 警告（コンテンツ生成の低下）
4. Business Metrics（ビジネス指標）
ビジネスの健全性を監視する指標です。
| 指標 | 単位 | 説明 | 目標値 |
|---|---|---|---|
| 有料パートナー数 | 社 | 有料プランを契約しているパートナー数 | - |
| パートナーリテンション率 | % | 月次パートナーリテンション率 | > 80% |
| ARPU | ¥/月 | ユーザーあたり平均収益 | ¥50-200/月 |
| CAC | ¥ | 顧客獲得コスト | LTV/CAC > 3:1 |
| 新規ユーザー獲得数 | 人/日 | 1日あたりの新規ユーザー登録数 | - |
パートナーの公式クレーム承認フロー
フロー概要
パートナーが公式アカウントとして認定されるための承認プロセスです。
承認基準
一次審査（自動）
以下の条件をすべて満たす必要があります：
-
企業情報
- 法人名が正確に入力されている
- 所在地が実在する
- 連絡先（メールアドレス、電話番号）が有効
-
必須書類
- 法人登記情報（または事業者登録証）
- 代表者の本人確認書類
-
アカウント情報
- プロフィール情報が充実している（説明文、画像など）
- 最低1件の投稿がある
二次審査（手動）
運営チームが以下の項目を確認します：
-
事業内容の確認
- 申請内容と実際の事業内容が一致しているか
- 不正利用のリスクがないか
-
認定基準
- 地域コミュニティへの貢献が期待できる事業か
- プラットフォームの価値と一致しているか
-
過去の実績
- 既存パートナーの場合、過去の利用実績を確認
承認ステータス
| ステータス | 説明 | 次のアクション |
|---|---|---|
| pending | 申請受付済み | 一次審査を実行 |
| under_review | 審査中 | 運営チームによる審査 |
| approved | 承認済み | 公式アカウントとして有効化 |
| rejected | 却下 | 却下理由を通知 |
| pending_correction | 修正待ち | パートナーからの修正待ち |
承認後の効果
公式アカウントに認定されると：
- 公式バッジ表示: アカウントに公式バッジが表示される
- 検索優先表示: 検索結果で優先的に表示される
- プロモーション機能: プロモーション投稿が可能になる
- 詳細アナリティクス: 詳細な分析データにアクセス可能
却下理由の例
- 企業情報の不整合
- 必須書類の不足
- 事業内容がプラットフォームの趣旨に合わない
- 過去の利用規約違反
再申請
却下された場合、理由を修正してから再申請が可能です。再申請は最大3回まで可能です。
ダッシュボードに表示すべきKPI
メインダッシュボード構成
1. ヘッダーセクション
- システム全体のヘルスステータス: 正常/警告/緊急のインジケーター
- 最終更新時刻: データの最終更新時刻を表示
2. System Health / SLO
カードレイアウト:
- RPS (Total): 数値表示（色分け: 正常=緑、警告=黄、緊急=赤）
- Error Rate: パーセンテージ表示 + グラフ（時系列）
- p95 Latency (API): 数値表示 + グラフ（時系列）
- p95 Latency (Gateway): 数値表示 + グラフ（時系列）
- Deps Health: アイコン表示（正常=緑、異常=赤）
- Trace Sampling: パーセンテージ表示
3. Product Immediacy
カードレイアウト:
- 近傍投稿レート: 数値表示 + トレンドグラフ
- ソーシャル投稿レート: 数値表示 + トレンドグラフ
- 重複表示率: パーセンテージ表示 + バーグラフ
- 近接度中央値: 数値表示 + ヒストグラム
- H3アクティブセル数: 数値表示 + マップ可視化
- カバレッジ: パーセンテージ表示 + 進捗バー
4. Experience Quality
カードレイアウト:
- Timeline p95 (現在地): 数値表示 + グラフ（時系列）
- Timeline p95 (ソーシャル): 数値表示 + グラフ（時系列）
- Queue 滞留: 数値表示 + グラフ（時系列、アラート表示）
- レコメンド命中率: パーセンテージ表示 + トレンドグラフ
5. Engagement
カードレイアウト:
- DAU/MAU: パーセンテージ表示 + トレンドグラフ
- 投稿作成率: パーセンテージ表示 + トレンドグラフ
- フィード閲覧率: パーセンテージ表示 + トレンドグラフ
- セッション時間: 数値表示 + ヒストグラム
6. Business Metrics
カードレイアウト:
- 有料パートナー数: 数値表示 + トレンドグラフ
- パートナーリテンション率: パーセンテージ表示 + トレンドグラフ
- ARPU: 数値表示 + トレンドグラフ
- CAC: 数値表示 + LTV/CAC比率表示
- 新規ユーザー獲得数: 数値表示 + 日次グラフ
ダッシュボードの更新頻度
- リアルタイム指標: 5秒ごとに更新（RPS、Error Rate、Latencyなど）
- 集計指標: 1分ごとに更新（投稿レート、エンゲージメント指標など）
- ビジネス指標: 5分ごとに更新（ARPU、CAC、パートナー数など）
アラート表示
ダッシュボード上で以下のアラートを表示します：
- 緊急アラート: 画面右上に赤色のバッジ表示
- 警告アラート: 該当KPIカードを黄色でハイライト
- アラート履歴: サイドバーに最近のアラート一覧を表示
実装状況
Phase 1: MVP（完了）
- ✅ 基本的なKPIダッシュボードの実装
- ✅ System Healthセクションの実装
- ✅ Product Immediacyセクションの実装
- ✅ Experience Qualityセクションの実装
- ✅ Engagementセクションの実装
Phase 2: 機能拡張（予定）
- ⏳ パートナー管理機能
- ⏳ 公式クレーム承認フローの実装
- ⏳ ユーザーサポート機能
- ⏳ アラート機能の実装
- ⏳ カスタムダッシュボード機能
Phase 3: 高度な機能（予定）
- ⏳ 予測分析機能
- ⏳ 自動レポート生成
- ⏳ データエクスポート機能
- ⏳ 通知設定機能