Ranking Dashboard と内蔵 wiki がどう公開され、どのルートが誰に委譲され、どこで認証・セッション・キャッシュ・DB を跨ぐかを整理したページです。
中心は WebDataServer です。ここで Spark の静的配信と動的ルート登録が同居し、ランキング画面・管理画面・チャット・ラグ分析・Wiki 入口がまとめて公開されます。チャットや協力イベントの一部だけは WebCoopSpark 側へ委譲され、認証周りは AuthService が補助します。
まず コンストラクタ で何を立ち上げるかを確認し、次に setupRoutes で公開 URL の全体像を掴みます。その後に currentMcid と管理・チャット系の POST 処理を追うと、Cookie から DB、レスポンス返却までの境界が見えます。最後に startStatePublisher と startEventMaintenance を見れば、運用中の定期同期まで理解できます。
この層の特徴は、静的 wiki 配信 と 動的ランキング API が同じ公開面に乗っていることです。今回追加した wiki ページ群も src/main/resources/public/wiki から配信されるため、別サーバを立てずに JAR 単体で完結します。
Wiki タブは Spark 上の /wiki へ飛び、そこから staticFileLocation("/public") で同梱 HTML をそのまま返します。今回の追加ページもこの流れに乗っています。
見た目のページでも、途中で DB へ直接落ちるものと短TTLキャッシュを返すものが混在します。表示の遅さを見るときは route ごとの差を分けて考えると追いやすいです。
読むだけの route と違って、書き込み系では Cookie 解決・権限確認・DB 更新・表示更新が一続きになります。権限不整合や 403/429 まわりはこの段を重点的に見ると切り分けしやすいです。