[YunfanGoForIt]

⚠️ 提交说明 / PR Notice

Note

本 PR 由 AI 助手（Kimi Code）在维护者指挥下生成并验证，提交者 yunfan 并非仓库历史核心开发者。描述为人工要求下的结构化整理。

📝 变更描述 / Description

把词来首页（自定义 HomePageContent）的套餐 / 流量包 / 大肥鱼专区商品卡从「静态 HTML 烘焙」迁移到「运行时读取 DB 商品目录」。

后端

• 新增 GET /api/subscription/public/catalog：复用 pricing 模块开关（HeaderNavModuleAuth("pricing")，默认匿名可达），返回精简 StorefrontCatalogItemDTO（product_id/title/subtitle/price_amount/currency/duration/total_amount/category/sort_order/model_scope/enabled/preview/display_metadata），不含任何成本字段；进程内缓存 60s，与 GetPricing 同款 mutex+时间戳模式。
• 收录规则：listed = true 或 display_metadata.preview = true（坏 JSON 不提升草稿）。
• SubscriptionPlan 新增 display_metadata 列（text）；admin 写入路径校验其为 ≤16KiB 的 JSON 对象；InvalidateSubscriptionPlanCache 级联失效目录缓存。

前端（web/）

• 新增 src/features/storefront/：LandingStorefront 组件在自定义首页的 shadow root 中找到 [data-storefront="plans|packs|zones"] 挂载点，用 React Query（staleTime 60s）拉目录并 createPortal 渲染三类卡片（class 与 home.html 静态样式同名）。
• 可购买判定 enabled && !preview：可购买 → <a href="/checkout?product_id=...">；preview/禁用 → disabled 按钮（文案取 display_metadata.button_label，缺省 t('Not on sale yet')）。
• 图片仅允许站内相对路径（/branding/*.webp）。
• 点击事件从 RichContent 移到包裹 div，使 portal 内购买锚点的点击能冒泡到既有登录拦截逻辑。
• 删除死代码 features/payment-display/lib/purchase-catalog.ts（读取已退役的 /purchase-catalog.json）。

配套运维改动（landing-page.json 退役静态商品段、迁移脚本、staging 清理）在姊妹仓库 iflink-token-platform 的同名分支 PR。

🚀 变更类型 / Type of change

• ✨ 新功能 (New feature)
• ⚡ 性能优化 / 重构 (Refactor)

🔗 关联任务 / Related Issue

• 姊妹 PR：IF-Link-Tech-Team/iflink-token-platform feat/storefront-catalog-20261021（draft）

✅ 提交前检查项 / Checklist

• 变更理解: 已理解这些更改的工作原理及可能影响。
• 范围聚焦: 本 PR 未包含任何与当前任务无关的代码改动（未触碰 deploy/）。
• 本地验证: 已在本地运行并通过测试或手动验证，维护者可以据此复核结果。
• 安全合规: 代码中无敏感凭据，且符合项目代码规范。

📸 运行证明 / Proof of Work

GOWORK=off go build ./...                       # OK
GOWORK=off go vet ./model ./controller ./router # OK
GOWORK=off go test ./model ./controller         # ok model 13.6s / ok controller 1.1s
cd web && bun run typecheck                     # OK（tsgo -b 无输出）
cd web && bun run test                          # 49 files passed, 0 failed
cd web && bun run build                         # OK，dist 中无 purchase-catalog 残留

新增 Go 测试 controller/subscription_storefront_catalog_test.go 4 个用例：匿名可达且成本字段不泄露；preview 草稿收录 / 未 listed 且无 preview 排除 / 坏 metadata 排除；缓存 60s 内直写不可见、Invalidate 后可见；admin 写入拒绝坏 metadata。CI postgres-accounting 矩阵正则已追加 TestStorefrontCatalog。

新增 web 测试：storefront-catalog.test.ts（6 个：防御解析、可购买判定、mount 分配、价格/有效期格式化、图片路径 sanitize）与 landing-storefront.test.tsx（3 个：portal 渲染、购买锚点冒泡、preview 禁用态）。

[YunfanGoForIt]

维护者评审通过(2026-10-21):公共目录 DTO 裁剪合规(成本/渠道字段不出边界)、preview 预告机制与 checkout 闸门正交、rebase 后 CI 5/5 绿。AI 辅助实现,维护者已核对。