From c6314d8c2509590117a687bf696e69521e302ba6 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 27 Apr 2026 12:03:00 +0800 Subject: [PATCH] =?UTF-8?q?docs:=2027=20mp=20home=20=E4=B8=BB=E9=A2=98?= =?UTF-8?q?=E5=8D=A1=E8=BF=87=E6=BB=A4=20+=20group=20list=20=E8=A1=A5=20ca?= =?UTF-8?q?tegory?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 27_fix_mp-home_offline-line-card-filter.md (PR #1462) /mp/home.productLines 现要求产品线下有 PUBLISHED 产品才返回主题卡 - 27_fix_mp-group-list_add-category.md (PR #1464) /mp/product/group/list 新增 category 字段对齐 CORE 链路 Co-Authored-By: Claude Opus 4.7 (1M context) --- .../27_fix_mp-group-list_add-category.md | 40 +++++++++++++++++++ ...27_fix_mp-home_offline-line-card-filter.md | 32 +++++++++++++++ 2 files changed, 72 insertions(+) create mode 100644 changelogs/2026-04/27_fix_mp-group-list_add-category.md create mode 100644 changelogs/2026-04/27_fix_mp-home_offline-line-card-filter.md diff --git a/changelogs/2026-04/27_fix_mp-group-list_add-category.md b/changelogs/2026-04/27_fix_mp-group-list_add-category.md new file mode 100644 index 0000000..82b3178 --- /dev/null +++ b/changelogs/2026-04/27_fix_mp-group-list_add-category.md @@ -0,0 +1,40 @@ +# /mp/product/group/list 返回补 category 字段 + +**日期**: 2026-04-27 +**PR**: #1464 (Closes #1463) +**影响端**: 小程序 mp + +## 接口变化 + +`GET /mp/product/group/list` 返回项**新增 `category` 字段**: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `category` | String | 产品分类（字典 `product_category`: `family`/`honeymoon`/`photography`/`experience`/`driving`） | + +## 修复内容 + +之前 CORE 产品走 `/mp/product-line/{lineId}/products` 用 `BeanUtil.toBean` 自动 copy 全字段，正确下发 `category`；GROUP 产品走专用 `/mp/product/group/list`，后端用手写 `setXxx` 装配 9 个字段，**漏 setCategory**，且 v2 internal + mp BFF 双 VO 也均无该字段定义。 + +修复后 GROUP list 与 CORE list 在 `category` 字段上行为一致。 + +## 验收实证 (测试服 2026-04-27) + +``` +GET /mp/product/group/list +[ + { "productId":"2047224617403117570", "name":"小秘密", "category":"family", "tags":["亲子","研学","露营"], ... }, + { "productId":"2044306857534636034", "name":"冻干粉发短信给", "category":"family", "tags":["亲子","研学","露营"], ... } +] +``` + +DB raw `category` 与 response 一致。 + +## 前端建议 + +- 「小蒙马专题页」分类筛选下拉可读 `category` 字段做前端筛选 +- `tags` 字段一直正确（之前用户感受是"标签也不对"实际是误会，本 PR 不动 tags） + +## 缓存 + +`@MpCache prefix=product:group:list:* TTL 10min` 后端缓存。部署后等 10 分钟自然过期，或后端手动 `redis-cli DEL` 立即生效（已处理）。 diff --git a/changelogs/2026-04/27_fix_mp-home_offline-line-card-filter.md b/changelogs/2026-04/27_fix_mp-home_offline-line-card-filter.md new file mode 100644 index 0000000..9134dad --- /dev/null +++ b/changelogs/2026-04/27_fix_mp-home_offline-line-card-filter.md @@ -0,0 +1,32 @@ +# mp 首页 productLines 过滤产品全下架的主题 + +**日期**: 2026-04-27 +**PR**: #1462 (Closes #1461) +**影响端**: 小程序 mp + +## 行为变化 + +`GET /mp/home` 返回的 `data.productLines` 字段过滤逻辑增强： + +- **之前**: 只校验 `product_line.status == ACTIVE` 即返回主题卡片 +- **现在**: 还要求该产品线下至少有 1 个 `status == PUBLISHED` 且未软删的产品 + +也就是说：产品线下产品全部下架/草稿/软删后，**主题卡片不再展示在首页**。点进空主题再看到「该主题下产品列表空」的情况不会再发生。 + +## 验收实证 (测试服 2026-04-27) + +| lineId | name | published_cnt | response 中是否出现 | +|---|---|---|---| +| 2045765580526387201 | 2026小蒙马 | 0 | ❌ 不出现（被过滤）| +| 2044248925572919297 | 阿斯蒂芬撒点 | 1 | ✅ 出现 | +| 2047223431551741953 | 123 | 1 | ✅ 出现 | + +## 前端注意 + +- 列表页/首页直接消费 `data.productLines`，无需改前端 +- 如果前端缓存过 lines 列表（含 0 PUBLISHED 的），需要重新拉 + +## 后台行为 + +- admin 后台「产品线列表」`/admin/product/line/list` **不受影响**（管理端要看到全部主题包括 0 产品的） +- 仅 mp 端展示层加过滤