docs: 27 mp home 主题卡过滤 + group list 补 category

- 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) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-04-27 12:03:00 +08:00
父节点 378a1bb703
当前提交 c6314d8c25
共有 2 个文件被更改,包括 72 次插入0 次删除

查看文件

@ -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` 立即生效(已处理)。

查看文件

@ -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 端展示层加过滤