refactor(claim): 删除自建皮肤领取页,路径式 /claim/<token> 复用现成领取页 + 物品图片

**删掉上一轮自建的领取页**
- `pages/claim-skin/*`、`services/claim-skin.ts`、`types/claim-skin.ts`、`tests/claim-skin.test.ts`
  及其样式(client.css 里 `.claim-skin-*` 整段 254 行)
- 后台我加的展示项:「皮肤自动发货」筛选项、执行器标签、「买家提交信息」卡片

**路径式链接复用现成领取页**
- `utils/claim-path.ts`(中性命名 `isClaimPath` / `resolveClaimToken`)+ 单测
- `App.tsx`:pathname 命中 `/claim/<token>` → 独立 BrowserRouter 渲染**现成的 `ClaimPage`**
  (页面零复制零改动:它只用 `useParams`,不读 hash);`#/claim/:token` 仍走主站 HashRouter,
  两者互不影响,且有用例断言 hash 入口不命中路径判定

**物品图片**
- 后端领取详情的 `product.imageUrl` 接上(内部 SKU 在 `spec_json.code` / `sku_code` /
  `sku_name` 哪个字段都能回退找到图,映射不到返回空串)
- 领取页新增 `ClaimProductImage`:居中大图(宽度 min(220px,62%)、圆角 16px),
  空值或加载失败都降级虚线占位块,不出现破图

`npm run check`:前端 128 / 128 全绿(去掉旧用例 17 个、新增路径与图片用例)
This commit is contained in:
yml2213
2026-10-09 16:13:46 +08:00
parent 4fce07a621
commit 1339c6887e
17 changed files with 171 additions and 1236 deletions
+49
View File
@@ -0,0 +1,49 @@
/**
* 路径式领取链接(`https://<域名>/claim/<token>`,不带 `#`)的路径判定。
*
* 与 `utils/redeem.ts` 同理:把路径解析抽成纯函数,路由与页面只负责调用。
* 刻意不依赖 React / antd,也不使用 `@/` 别名,
* 方便 `node --experimental-strip-types --test` 直接跑单测。
*
* 注意两条领取入口**互不影响**:
* - 路径式(买家分享链接):`https://<域名>/claim/<token>`,`pathname` 为 `/claim/<token>`;
* - hash 式(主站打手领取页):`https://<域名>/#/claim/<token>`,`pathname` 为 `/`,
* 路由由 HashRouter 解析,不会命中本文件的判定。
*
* 两个入口渲染的是**同一个** `pages/claim/ClaimPage`。
*/
/**
* 取路径式领取链接里的 token。
*
* 只认 `/claim/<一段 token>`:
* - `/claim/abc` 命中,结尾多余斜杠容忍(`/claim/abc/`);
* - `/claim`、`/claim/`、`/claim/a/b`、`/redeem`、`/` 都不命中;
* - 查询串 / hash 片段(如 `/claim/abc?x=1`)会被丢弃后取第一段。
*
* 返回**解码后**的 token;不命中时返回空串。
*/
export function resolveClaimToken(pathname: unknown): string {
const normalized = String(pathname ?? '').trim()
if (!normalized.startsWith('/')) return ''
const segments = normalized.split(/[?#]/)[0].replace(/\/+$/, '').split('/').filter(Boolean)
if (segments.length !== 2 || segments[0] !== 'claim') return ''
return decodeTokenSegment(segments[1])
}
/** 是否为路径式领取链接(`/claim/<token>`) */
export function isClaimPath(pathname: unknown): boolean {
return resolveClaimToken(pathname) !== ''
}
function decodeTokenSegment(segment: string): string {
try {
return decodeURIComponent(segment)
} catch {
// 非法百分号编码:退回原始片段,交给后端判定有效性
return segment
}
}