運営アドミン / システム運用
運営アドミン / システム運用
本ページは 2 段構成。上段が biz/CS 向け（ユーザー提示可）、下段（
## 🔧 実装詳細以降）が dev 向け。biz/CS がユーザーへ提示・転用してよいのは上段のみ。
概要
運営アドミン向けの「障害対応・整合性メンテナンス・配信の緊急停止」をまとめたシステム運用機能群。通常運用ではなく、トラブル対応・暫定リカバリ・緊急停止スイッチとして利用される運営アドミン専用の機能を扱う。
主な対象操作:
- レビュー強制削除: クレーム対応用に特定ユーザー × 特定講座のレビューを削除
- 助言会社向けファイルコピー: 助言会社へのコンテンツ・トーク差分のエクスポート
- 講座ファイルコピー登録: 上記コピー処理の対象講座マスタへの追加
- コンテンツファイル整合性チェック: ストレージ上のファイル存在を全件チェックして欠損を検出
- 一斉配信の緊急停止スイッチ: 配信誤爆や運用上の停止が必要なときに、配信バッチを一時停止
- ステップ配信の緊急停止スイッチ: 同上のステップ配信版
- バッジ更新ロック解除: バッチ異常停止でロックが残った場合の手動リカバリ
- 無料トライアル履歴の物理削除: 「再度トライアルを許可したい」場合の履歴削除
主な利用想定は、配信誤爆検知時の即時停止、ストレージ整合性破綻の検出・対応、バッチ異常終了の手動リカバリ、CS 案件で不適切レビューを強制削除するケースなど。本機能群はいずれも副作用が大きく、誤操作リスクが高いため運用ガイドの整備が重要。
配信緊急停止スイッチの仕様: 一斉配信・ステップ配信のロックは内部的に 24 時間で自動解除される時限ロック。配信再開時には明示的に解除操作を実行する運用となる。ロック中は配信バッチが起動しても処理をスキップし、新規配信は実行されない。
整合性チェックは検出のみ: ストレージ整合性チェック機能はファイル欠損を検出してレポート出力するのみで、自動修復は行わない。修復は別途手動対応となる。
物理削除の取り消し不可: 無料トライアル履歴の削除は内部的に物理削除として処理されるため、削除後の取り消しはできない。実行時は影響範囲を慎重に確認することが必要。
📝 レビュー観点:
- 目的: 障害対応・整合性メンテナンス・配信の緊急停止
- 誰が使うか: 運営アドミン
- どこで使うか: 運営アドミン汎用ツール経由
- 隣接機能との関係: 一斉配信（
../plan-management/bulk-delivery.md）、ステップ配信（../plan-management/step-delivery.md）、レビュー（../plan-management/reviews.md）- CS 問い合わせで頻発する論点: 「配信誤爆時の緊急停止」「Wasabi の不整合検出」「投資助言コピー」「無料トライアル再付与」
- [本機能特有] 配信ロックは 24h TTL の Redis: 期限切れで自動解除
- [本機能特有] Wasabi チェックは検出のみ: 修復は手動
- [本機能特有] 無料トライアル履歴は物理削除: 取り消し不可
- [本機能特有] バッジ更新ロックは解除のみ: 取得用経路は無し
利用シナリオ
シナリオ 1: 配信誤爆時の緊急停止
一斉配信またはステップ配信の内容に誤りがあると判明した瞬間、運営アドミンが配信ロックを取得して以降のバッチ実行を停止。誤った配信が広がるのを最小限に抑える。誤りを修正した後、ロックを解除して通常運用に戻す。
シナリオ 2: 不適切レビューの強制削除
クレーム対応や規約違反対応で、特定ユーザー × 特定講座のレビューを運営アドミンが削除。論理削除として処理されるため、画面上から見えなくなる。
シナリオ 3: ストレージ整合性チェック
「特定の動画が再生できない」「資料が表示されない」等の障害報告を受けて、運営アドミンが整合性チェックを実行。ストレージ上のファイル欠損を検出してレポート化し、修復対応の起点とする。
シナリオ 4: 助言会社向けファイルコピー
助言会社へのコンテンツ・トーク内容のエクスポート要件に従い、運営アドミンがコピー処理を実行。対象講座は事前に登録された講座マスタに従う。
シナリオ 5: バッジ更新ロックの解除（リカバリ）
バッジ更新バッチが異常停止してロックが残った場合、運営アドミンが手動でロックを解除。次回バッチ実行が再開できるようにする。
シナリオ 6: 無料トライアル履歴の物理削除
「同じユーザーに再度無料トライアルを付与したい」要望に対して、過去のトライアル履歴を物理削除して再付与可能にする。物理削除のため取り消し不可、影響範囲の確認が重要。
よくある失敗ケース
- 既にロック中に再度ロック取得: 重複ロックエラーで弾かれる
- ロック未取得で解除実行: ロックが存在しないエラーで弾かれる
- 存在しないレビューの削除実行: レビューが見つからない旨のエラー
- 存在しないトライアル履歴の削除: 履歴が見つからない旨のエラー
- 物理削除対象の影響範囲: トライアル履歴削除で他処理への波及がないか事前確認が必要
権限別仕様
権限定義は ../user-roles.md 参照。用語は ../terminology.md。
横断軸
| 操作 | 運営アドミン | 受講者 | 講師 |
|---|---|---|---|
| レビュー強制削除 | ○ | × | × |
| 投資助言コピー | ○ | × | × |
| 講座ファイルコピー登録 | ○ | × | × |
| Wasabi 整合性チェック | ○ | × | × |
| 一斉配信ロック取得・解除 | ○ | × | × |
| ステップ配信ロック取得・解除 | ○ | × | × |
| バッジ更新ロック解除 | ○ | × | × |
| 無料トライアル履歴の物理削除 | ○ | × | × |
📝 レビュー観点:
- 全操作が運営アドミン専用、副作用大の経路が多いので CS の運用ガイド整備が重要
機能詳細（ふるまい）
レビュー強制削除
- 指定講座 × 指定ユーザーのレビューを論理削除
- 削除後はレビューが画面上から見えなくなる
- 該当レビューが存在しない場合はエラー
助言会社向けファイルコピー
- 助言会社向けにコンテンツファイルとトーク差分の CSV を出力
- 対象講座は事前登録された講座マスタに従う
- 重い処理のためバッチ性が高い
- ファイルサイズエラー等の一部失敗時は処理継続 + 内部通知、その他のエラーは処理停止
講座ファイルコピー登録
- 助言会社向けコピー処理の対象講座マスタを追加
- 「どの講座をどの会社向けに出すか」を登録
- 講座 ID と対象会社 ID で 1 件登録
コンテンツファイル整合性チェック
- 全コンテンツのファイルがストレージ上に存在するかを走査
- 見つからないファイル名の一覧を結果として返却
- 検出のみで自動修復は行わない（修復は別経路で手動対応）
- 通常運用での監視・障害発生時の影響範囲特定に利用
一斉配信 / ステップ配信の緊急停止スイッチ
- 配信ロックを取得すると、対応する配信バッチが起動しても処理がスキップされる
- ロックは内部的に 24 時間で自動解除される時限ロック
- 解除操作で明示的に解除可能（緊急停止後の運用再開時）
- 既にロック中に再度ロック取得しようとするとエラー、未ロック状態で解除しようとするとエラー
- ロックが長時間残ったままの場合、内部通知で運用担当者へアラート
バッジ更新ロック解除
- バッジ更新バッチが異常終了してロックが残ったときの手動リカバリ用
- 取得経路は提供しておらず、解除のみが運営アドミン経路で行える
- 通常運用ではバッチ側が自動的にロックを取得・解除する
無料トライアル履歴の物理削除
- 指定講座 × 指定ユーザーの無料トライアル履歴を内部的に完全削除
- 削除後は同ユーザーに対する再度のトライアル付与が可能になる
- 物理削除のため取り消し不可
- 関連処理への影響可能性があるため、実行前の影響確認が重要
📝 レビュー観点:
- 入力 → 処理 → 出力: 経路入力 → 即時実行 → 一部はバッチ処理（投資助言コピー）
- エッジケース: 既ロック・未ロック・対象データ不在
- エラー表示:
review.not.exist、一斉配信バッチは既にロックされています、一斉配信バッチのロックが存在しません、trial.contract.user.history.not.exist- [本機能特有] 副作用大の経路が多い: 物理削除・配信停止・大量ファイルコピーなど
admin 操作
本ページ全体が運営アドミン操作の集約。
該当なし / 実装されていない
- バッチ手動実行の汎用経路: 未実装（一斉/ステップ配信ロックは緊急停止用のみ）
- 整合性チェックの修復経路: Wasabi チェックはレポート出力のみ
- 無料トライアル履歴の論理削除: 未実装（物理削除のみ）
📝 レビュー観点:
- 整合性チェック自動修復の必要性
- 配信ロックの操作ガード（誤操作防止）
品質 / 約束事項
- 応答性: 即時。投資助言コピーは長時間処理（バッチ性）
- 信頼性: バッチは Redis ロックで二重起動防止。投資助言コピーは失敗時 Slack 通知
- 制限値:
- 配信ロック TTL: 24 時間（自動解除）
- 配信ロック警告: 1 時間超ロック残存で内部 Slack 通知
- データ保持: 無料トライアル履歴は物理削除（取り消し不可）
📝 レビュー観点:
- [本機能特有] 物理削除の取り消し不可: 操作ガード必要
- [本機能特有] 一斉配信ロックの整合: 別経路（誤爆停止）と通常運用の干渉
変更履歴（リリースノート候補）
v2.29.2: 2026-05-04（PSD 初版）
- [PSD 追加] 本ドキュメント初版作成。v2.29.2 時点の実装を起こし。機能追加・変更は含まない
📝 レビュー観点:
- 過去の主要変更（配信ロック導入 / Wasabi チェック導入 / 投資助言コピー追加 等）
関連ドキュメント
- 権限定義:
../user-roles.md - 用語辞書:
../terminology.md - 関連 PSD:
../plan-management/bulk-delivery.md— 一斉配信../plan-management/step-delivery.md— ステップ配信../plan-management/reviews.md— レビュー閲覧