dachui/affiliate_dash
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(catalog): 废弃 LEWAN_ 镜像，统一英文 SKU 与积分价，商品图按 SKU 缓存

Browse Source 
对外目录只保留英文主 sku；迁移硬删镜像并校准 1元=100积分；发货页/凭证优先使用 local {sku}.webp。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
yml2213
2026-09-14 20:00:26 +08:00
co-authored by Cursor
parent bf9614569e
commit df1a170d44
57 changed files with 1052 additions and 171 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/商品列表.md
+2 -37
View File
@@ -1,37 +1,2 @@
商品 sku
套装-Alan Walker suit_alan_walker
套装-暗影哥特 suit_shadow_gothic
黑色高级特训官上衣 top_black_elite_trainer
M416-仓鼠灰灰 m416_hamster_gray
萌熊伴侣背包 bag_cute_bear
套装-双彩绵绵 suit_dual_fluffy
套装-糯粉咩咩 suit_pink_sheep
套装-恋恋初桃 suit_first_peach
套装-浪漫天命 suit_romantic_destiny
西部牛仔大礼包 pack_western_cowboy
烟雾弹-糯粉咩咩 smoke_pink_sheep
破片手榴弹-糯粉咩咩 frag_pink_sheep
套装-仓鼠灰灰 suit_hamster_gray
套装-萌熊伴侣 suit_cute_bear
糯粉咩咩背包 bag_pink_sheep
糯粉咩咩头盔 helmet_pink_sheep
仓鼠灰灰背包 bag_hamster_gray
仓鼠灰灰头盔 helmet_hamster_gray
套装-西部谜踪 suit_western_mystery
国宝胖达头盔 helmet_panda_treasure
套装-胖达圆圆 suit_panda_round
套装-胖达团团 suit_panda_tuan
熔岩游骑兵礼包 pack_lava_ranger
套装-狂沙舞者 suit_sand_dancer
星际漫游服装礼包 pack_star_roam_outfit
星际漫游枪械礼包 pack_star_roam_weapon
套装-绵云熊熊 suit_cloud_bear
荣耀勋章2个 honor_medal_x2
荣耀勋章30个 honor_medal_x30
荣耀勋章90个 honor_medal_x90
幸运币2个 lucky_coin_x2
幸运币30个 lucky_coin_x30
幸运币90个 lucky_coin_x90
商品目录已合并到 docs/商品目录.md（含中英文 SKU、价格、履约与图片缓存约定）。
本文件仅保留历史速查，请以商品目录为准。
docs/商品目录.md
+120
View File
@@ -0,0 +1,120 @@
# 商品目录（权威快照）
> 更新时间：2026-09-14
> 数据来源：自营商户开放/后台商品列表（`merchant_id=1`，共 **36** 条）
> **积分比例：1 元 = 100 积分**（`price_amount` / `cost_amount` 单位均为积分）
> 本地图片缓存：`frontend/public/images/products/{sku}.webp`（按商户 SKU 命名）
## 约定
| 字段 | 说明 |
|------|------|
| 中文名 | `display_name` / 目录 `product.name` |
| 英文 SKU | 对外主 sku，下单、映射、图片文件名均用此值 |
| 目录编码 | `product.code`，与英文 SKU 一致 |
| 售价/成本 | 积分；展示元时 ÷100 |
| 履约 | `fulfillment_config`：`dlc` / `lewan` / `priority`；空配置表示尚未挂乐玩，默认走 DLC 内置 GoodID |
| 图片 | 优先本地 `/images/products/{sku}.webp` |
**不要再使用 `LEWAN_*` 镜像 sku 对外下单。**
## 全量目录
| 中文名 | 英文 SKU | 分类 | 售价(积分) | 成本(积分) | 约合人民币 | 履约模式 | DLC GoodID | 乐玩 Product ID |
|--------|----------|------|------------|------------|------------|----------|------------|-----------------|
| 套装-花面小丑 | `suit_jester_face` | 套装 | 20000 | 20000 | ¥200.00 | lewan | — | `b3891176-5ffa-40cb-8c58-7e46eac3f381` |
| 套装-沙丘之歌 | `suit_dune_song` | 套装 | 10200 | 10200 | ¥102.00 | lewan | — | `f3b83b85-c664-4440-94ac-a4b0cd7cf0f3` |
| 龙宫之主大礼包 | `pack_dragon_palace` | 礼包 | 80000 | 80000 | ¥800.00 | lewan | — | `46524a53-068d-4bee-97ff-d5e7873818e0` |
| 幸运币90个 | `lucky_coin_x90` | 道具 | 9000 | 9000 | ¥90.00 | priority | `682ef39ca8f40c4234c59f42` | `518e3bec-f9f2-483b-89ae-d826c9cf14e5` |
| 幸运币30个 | `lucky_coin_x30` | 道具 | 3000 | 3000 | ¥30.00 | priority | `682ef39ca8f40c4234c59f44` | `b1c64119-d164-41e6-a1dc-0d8167dd09de` |
| 幸运币2个 | `lucky_coin_x2` | 道具 | 200 | 200 | ¥2.00 | priority | `682ef39ca8f40c4234c59f46` | `d5dfa4e3-675b-4187-8163-8aa04727c6e4` |
| 荣耀勋章90个 | `honor_medal_x90` | 道具 | 9000 | 9000 | ¥90.00 | priority | `682ef39ca8f40c4234c59f41` | `779857c7-e6db-40e3-9f4f-4eb5eca350e1` |
| 荣耀勋章30个 | `honor_medal_x30` | 道具 | 3000 | 3000 | ¥30.00 | priority | `682ef39ca8f40c4234c59f43` | `a09d18ce-4a55-4313-925b-6de66d96154b` |
| 荣耀勋章2个 | `honor_medal_x2` | 道具 | 200 | 200 | ¥2.00 | priority | `682ef39ca8f40c4234c59f45` | `ed57398a-a470-4d85-abc4-761c81274d9f` |
| 套装-绵云熊熊 | `suit_cloud_bear` | 套装 | 13480 | 13480 | ¥134.80 | dlc(默认) | `682ef39ca8f40c4234c59f40` | — |
| 星际漫游枪械礼包 | `pack_star_roam_weapon` | 礼包 | 51600 | 51600 | ¥516.00 | dlc(默认) | `682ef39ca8f40c4234c59f3f` | — |
| 星际漫游服装礼包 | `pack_star_roam_outfit` | 礼包 | 83600 | 83600 | ¥836.00 | dlc(默认) | `682ef39ca8f40c4234c59f3e` | — |
| 套装-狂沙舞者 | `suit_sand_dancer` | 套装 | 8400 | 8400 | ¥84.00 | dlc(默认) | `682ef39ca8f40c4234c59f3d` | — |
| 熔岩游骑兵礼包 | `pack_lava_ranger` | 礼包 | 9600 | 9600 | ¥96.00 | dlc(默认) | `682ef39ca8f40c4234c59f3c` | — |
| 套装-胖达团团 | `suit_panda_tuan` | 套装 | 23400 | 23400 | ¥234.00 | dlc(默认) | `682ef39ca8f40c4234c59f3b` | — |
| 套装-胖达圆圆 | `suit_panda_round` | 套装 | 23400 | 23400 | ¥234.00 | dlc(默认) | `682ef39ca8f40c4234c59f3a` | — |
| 国宝胖达头盔 | `helmet_panda_treasure` | 头盔 | 23400 | 23400 | ¥234.00 | dlc(默认) | `682ef39ca8f40c4234c59f39` | — |
| 套装-西部谜踪 | `suit_western_mystery` | 套装 | 11500 | 11500 | ¥115.00 | dlc(默认) | `682ef39ca8f40c4234c59f35` | — |
| 仓鼠灰灰头盔 | `helmet_hamster_gray` | 头盔 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f54` | — |
| 仓鼠灰灰背包 | `bag_hamster_gray` | 背包 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f55` | — |
| 糯粉咩咩头盔 | `helmet_pink_sheep` | 头盔 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4e` | — |
| 糯粉咩咩背包 | `bag_pink_sheep` | 背包 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4f` | — |
| 套装-萌熊伴侣 | `suit_cute_bear` | 套装 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4b` | — |
| 套装-仓鼠灰灰 | `suit_hamster_gray` | 套装 | 12800 | 12800 | ¥128.00 | dlc(默认) | `682ef3c5a8f40c4234c59f53` | — |
| 破片手榴弹-糯粉咩咩 | `frag_pink_sheep` | 投掷物 | 4880 | 4880 | ¥48.80 | dlc(默认) | `682ef3c5a8f40c4234c59f51` | — |
| 烟雾弹-糯粉咩咩 | `smoke_pink_sheep` | 投掷物 | 4880 | 4880 | ¥48.80 | dlc(默认) | `682ef3c5a8f40c4234c59f50` | — |
| 西部牛仔大礼包 | `pack_western_cowboy` | 礼包 | 32000 | 32000 | ¥320.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4c` | — |
| 套装-浪漫天命 | `suit_romantic_destiny` | 套装 | 3600 | 3600 | ¥36.00 | priority | `682ef39ca8f40c4234c59f38` | `b1fff090-e389-4c6c-9c51-32751582239d` |
| 套装-恋恋初桃 | `suit_first_peach` | 套装 | 9880 | 9880 | ¥98.80 | dlc(默认) | `682ef3c5a8f40c4234c59f48` | — |
| 套装-糯粉咩咩 | `suit_pink_sheep` | 套装 | 18800 | 18800 | ¥188.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4d` | — |
| 套装-双彩绵绵 | `suit_dual_fluffy` | 套装 | 11240 | 11240 | ¥112.40 | dlc(默认) | `682ef3c5a8f40c4234c59f49` | — |
| 萌熊伴侣背包 | `bag_cute_bear` | 背包 | 28800 | 28800 | ¥288.00 | dlc(默认) | `682ef3c5a8f40c4234c59f4a` | — |
| M416-仓鼠灰灰 | `m416_hamster_gray` | 枪械 | 16800 | 16800 | ¥168.00 | dlc(默认) | `682ef3c5a8f40c4234c59f52` | — |
| 黑色高级特训官上衣 | `top_black_elite_trainer` | 上衣 | 3600 | 3600 | ¥36.00 | priority | `682ef39ca8f40c4234c59f37` | `8621502c-e355-455c-9b74-a7e642a40cfe` |
| 套装-暗影哥特 | `suit_shadow_gothic` | 套装 | 8880 | 8880 | ¥88.80 | priority | `682ef39ca8f40c4234c59f36` | `8eed3610-7238-4b89-8010-6713268f7cd3` |
| 套装-Alan Walker | `suit_alan_walker` | 套装 | 3600 | 3600 | ¥36.00 | dlc(默认) | `682ef3c5a8f40c4234c59f47` | — |
## 中英文速查
| 中文名 | 英文 SKU |
|--------|----------|
| 套装-Alan Walker | suit_alan_walker |
| 套装-暗影哥特 | suit_shadow_gothic |
| 黑色高级特训官上衣 | top_black_elite_trainer |
| M416-仓鼠灰灰 | m416_hamster_gray |
| 萌熊伴侣背包 | bag_cute_bear |
| 套装-双彩绵绵 | suit_dual_fluffy |
| 套装-糯粉咩咩 | suit_pink_sheep |
| 套装-恋恋初桃 | suit_first_peach |
| 套装-浪漫天命 | suit_romantic_destiny |
| 西部牛仔大礼包 | pack_western_cowboy |
| 烟雾弹-糯粉咩咩 | smoke_pink_sheep |
| 破片手榴弹-糯粉咩咩 | frag_pink_sheep |
| 套装-仓鼠灰灰 | suit_hamster_gray |
| 套装-萌熊伴侣 | suit_cute_bear |
| 糯粉咩咩背包 | bag_pink_sheep |
| 糯粉咩咩头盔 | helmet_pink_sheep |
| 仓鼠灰灰背包 | bag_hamster_gray |
| 仓鼠灰灰头盔 | helmet_hamster_gray |
| 套装-西部谜踪 | suit_western_mystery |
| 国宝胖达头盔 | helmet_panda_treasure |
| 套装-胖达圆圆 | suit_panda_round |
| 套装-胖达团团 | suit_panda_tuan |
| 熔岩游骑兵礼包 | pack_lava_ranger |
| 套装-狂沙舞者 | suit_sand_dancer |
| 星际漫游服装礼包 | pack_star_roam_outfit |
| 星际漫游枪械礼包 | pack_star_roam_weapon |
| 套装-绵云熊熊 | suit_cloud_bear |
| 荣耀勋章2个 | honor_medal_x2 |
| 荣耀勋章30个 | honor_medal_x30 |
| 荣耀勋章90个 | honor_medal_x90 |
| 幸运币2个 | lucky_coin_x2 |
| 幸运币30个 | lucky_coin_x30 |
| 幸运币90个 | lucky_coin_x90 |
| 龙宫之主大礼包 | pack_dragon_palace |
| 套装-沙丘之歌 | suit_dune_song |
| 套装-花面小丑 | suit_jester_face |
## 图片缓存
- **正式目录（按 SKU）**：`frontend/public/images/products/{sku}.webp`
- **运行时兜底**：`data/uploads/products/` 仅给 `image-proxy` 缓存未知外链（哈希文件名），正式商品图不要放这里
- 同步命令：
```bash
cd backend && go run ./cmd/sync_product_images
```
- 前端：`resolveProductImage({ sku, url })` / `resolveProductImageBySku(sku)` 一律优先 SKU 本地文件
- 使用处：发货页 `Delivery.tsx`、电子凭证 `voucher.ts`
## 维护说明
1. 以后以本表（或同结构的最新导出）为准更新价格与履约挂接。
2. 新增商品：先定英文 SKU → 写目录/挂履约 → 跑图片同步。
3. order_site 映射只填英文 SKU，不要填 `LEWAN_*`。
docs/商品英文名对照.md
+7
View File
@@ -1,3 +1,7 @@
# 商品英文名对照
权威全表（含价格、履约、图片约定）见：[商品目录.md](./商品目录.md)
| 中文名 | 英文名 |
|--------|--------|
| 套装-Alan Walker | suit_alan_walker |
@@ -33,3 +37,6 @@
| 幸运币2个 | lucky_coin_x2 |
| 幸运币30个 | lucky_coin_x30 |
| 幸运币90个 | lucky_coin_x90 |
| 龙宫之主大礼包 | pack_dragon_palace |
| 套装-沙丘之歌 | suit_dune_song |
| 套装-花面小丑 | suit_jester_face |