SwingCompass 本番修正記録

Redis を使う処理が、すべて AuthenticationError で 500 になっていました。パスキーの challenge 保存（backend/app/routers/passkey.py:165）と、Celery への解析投入です。

Fly の [processes] のコマンドはシェルを通らずに実行されるため、${REDIS_PASSWORD} が展開されません。この文字列そのものが Redis のパスワードになっていました。API と worker の REDIS_URL には本物のパスワードが入っているので、認証が合いませんでした。

• 実測: 文字列 ${REDIS_PASSWORD} で redis-cli -a すると PONG、secret の値では WRONGPASS

@@ -10,11 +10,14 @@ # 起動コマンド+# Fly は process コマンドをシェルを通さず実行し ${VAR} を展開しない。+# 直書きすると "${REDIS_PASSWORD}" という文字列がパスワードになる (2026-10-16 本番で発生)。+# 必ず sh -c で包んで環境変数を展開させる。 [processes]-  app = "redis-server --requirepass ${REDIS_PASSWORD} --appendonly yes --dir /data"+  app = "sh -c 'exec redis-server --requirepass \"$REDIS_PASSWORD\" --appendonly yes --dir /data'"

• Redis を再デプロイした後、API から ping → True
• 文字列 ${REDIS_PASSWORD} での認証 → 失敗
• パスキーのログイン開始（options）→ 200

swing.aicompass-golf.com を初めて開いてログインすると、ボタンが「LOGGING IN...」のまま止まりました。ログインの API 自体は成功していて（トークン保存済み・/auth/me 200）、再読み込みするとダッシュボードが開きました。

ログイン画面が表示されたときに /dashboard を router.prefetch していました。その時点では sca_token cookie が無いので、middleware（frontend/src/middleware.ts:12-16）が先読みを /auth/login?redirect=/dashboard にリダイレクトし、Next.js（15.1.9）がその結果をキャッシュします。ログイン後の router.push('/dashboard') はキャッシュを使って通信せず、ログイン画面に留まります。pending は成功時に戻さない作りなので、ボタンの表示がそのまま残りました。

sequenceDiagram
  participant B as ブラウザ（ログイン画面）
  participant RC as Router のキャッシュ
  participant MW as middleware
  participant API as API
  B->>MW: 表示時に prefetch /dashboard（cookie なし）
  MW-->>RC: /auth/login?redirect=/dashboard へリダイレクト
  Note over RC: この結果を /dashboard 用に保持
  B->>API: POST /auth/login
  API-->>B: 200（トークン）→ cookie sca_token を保存
  B->>RC: router.push('/dashboard')
  RC-->>B: キャッシュを返す → URL は /auth/login のまま

• 本番で再現: cookie なしでログイン画面を開くと、/dashboard への通信は先読みの 1 回（104 ms）だけでした。cookie を戻して push しても 5 秒後にログイン画面のままで、router.refresh() の後に push すると /dashboard に移りました
• next dev は prefetch しないので、ローカルでは起きません

@@ -56,12 +56,6 @@     return raw.startsWith("/") && !raw.startsWith("//") ? raw : "/dashboard";   }, [searchParams]); -  // 遷移先を事前コンパイル/プリフェッチしておき、ログイン直後のちらつきを防ぐ-  useEffect(() => {-    router.prefetch(redirectTo);-    router.prefetch("/dashboard");-  }, [router, redirectTo]);-

// src/middleware.ts の PROTECTED_PATHS と同じconst PROTECTED_PATHS = ["/dashboard", "/sessions", "/admin", "/my-coach"]; it.each([  ["redirect 指定なし", ""],  ["redirect=/sessions/123", "redirect=/sessions/123"],])("ログイン前に保護ページを prefetch しない (%s)", (_label, search) => {  mockSearch = search;  // render は act で包まれるので、戻った時点でマウント時の effect は実行済み  render(<LoginPage />);  expect(prefetchedProtectedPaths()).toEqual([]);});

• 回帰テスト: 修正前のコードで 2 件とも失敗（受け取った値 ["/sessions/123", "/dashboard"]）→ 修正後に通過。frontend の jest は 67 件すべて通過
• Codex レビュー: 指摘 0 件
• 本番（Vercel の production、commit b9a2c57）: cookie なしでログイン画面を開いて 3 秒間、/dashboard への通信は 0 件。cookie を戻して push すると、5 秒後に /dashboard
• 利用者として、ログアウト → パスキーでログインしてダッシュボードまで移れた

変わる点: ログイン後の /dashboard の読み込みは、ボタンを押した後に始まります。その間は「LOGGING IN...」の表示が続きます。