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:
@@ -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
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user