失敗を最もコストの低い段階へ
マスターデータのミスがライブでの事故になる前に止められるよう、サーバー起動時の検証を拡充し、コンパイル時、さらにデータリポジトリのCIへと検証を段階的に前倒ししました。
状況
プランナーがExcelで管理するゲームデータ(マスターデータ)は、protobufに変換されてサーバーに読み込まれます。参照切れや期間の逆転といった入力ミスは、ライブ環境で「誰も入手できないアイテム」のような事故につながります。データを修正するのは、ほとんどがエンジニアではない人たちです。
判断
サーバー起動時の検証:同僚が作った起動時バリデーターに、入社1か月目からコンテンツごとのルールと共通ヘルパーを追加し、現在のバリデーターのコードの約3分の1を書きました。新しいルールは実際のデータと照合しており、たとえば確率表のルールは、問題のあった過去のデータを正しく検出できることを確かめてから導入しました。
コンパイル段階:空のidが気づかれないまま0として入り込まないよう、idを検証なしに直接生成できないようにするカスタムWartRemoverルールを作りました。データ全体を走査する方式は、コンパイル時間が延びるため、チームでの議論を経て却下しました。2つのenumの宣言順がずれて等級の比較が逆転したバグのあとには、順序が異なればコンパイルエラーにするScala 3マクロを作り、必要な箇所に適用しました。
データリポジトリのCI:マスターデータのリポジトリに、enumとテーブルの対応や、固定されるべき番号を検査するCIを追加しました。プランナーの作業が増えないように設計し、失敗時のメッセージはプランナーが読みやすい言葉で書きました。
AIによるデータレビュー:他チームが作ったAIレビュー用のアクションをデータリポジトリに組み込み、ドメインごとのプロンプトとSlackでのフィードバックループを運用しました。
結果
ミスが見つかるタイミングが、ライブからサーバー起動時、コンパイル時、データのコミット時へと段階的に前倒しされました。データCIは初回の実行で、実際の漏れを1件見つけました。