Merge branch 'master' into feat/game-works-management

src/routing/activeAppPageRoutes.ts

@@ -18,6 +18,16 @@ const STAGE_ROUTE_ENTRIES = [
   ['game-publish', '/games/publish'],
 ] as const satisfies readonly (readonly [SelectionStage, string])[];
 
+/**
+ * 带动态段、需要整体回退 index.html 的对外路由前缀 → 归属 stage。
+ * 例如收银台深链 `/pay/<checkoutToken>`（后端 `payment.rs` 用 `format!("/pay/{}", token)` 生成，
+ * 前端从最后一个路径段读 token）。Nginx 必须按「前缀 + 恰好一个路径段」的锚定形状放行：
+ * 只放行裸前缀会让真实收银台链接落到默认 location 变成 404，放行过宽又会把未知路径吞掉。
+ */
+export const APP_PREFIX_ROUTE_ENTRIES = [
+  ['/pay', 'payment-checkout'],
+] as const satisfies readonly (readonly [string, SelectionStage])[];
+
 export const APP_STAGE_ROUTES: Record<SelectionStage, string> =
   Object.fromEntries(STAGE_ROUTE_ENTRIES) as Record<SelectionStage, string>;
 
@@ -41,10 +51,13 @@ export function normalizeAppPath(pathname: string) {
 export function resolveSelectionStageFromPath(
   pathname: string,
 ): SelectionStage {
-  if (normalizeAppPath(pathname).startsWith('/pay/')) {
-    return 'payment-checkout';
+  const normalizedPath = normalizeAppPath(pathname);
+  for (const [prefix, stage] of APP_PREFIX_ROUTE_ENTRIES) {
+    if (normalizedPath.startsWith(`${prefix}/`)) {
+      return stage;
+    }
   }
-  return ROUTE_STAGE_BY_PATH.get(normalizeAppPath(pathname)) ?? 'platform';
+  return ROUTE_STAGE_BY_PATH.get(normalizedPath) ?? 'platform';
 }
 
 export function resolveInitialSelectionStageFromPath(