12_fix custom-canedit-after-order (PR HL#2085)

changelogs/2026-05/12_fix_admin_product-v2-custom-canedit-after-order.md

@@ -0,0 +1,57 @@
+# 后端 fix 通知 — CUSTOM 私人定制产品已下单时 canEdit 强制 false
+
+**日期**: 2026-05-12
+**类型**: 后端修复 (PR #2085, merge commit `72ef5693`)
+**模块**: 产品 V2 管理端列表/详情 → `canEdit` 字段语义增强
+**通知**: @mmg
+**前端是否需改动**: **不需要** — 前端继续按 `canEdit` 决定"修改/删除"按钮显示, 后端语义自动收紧
+**严重性**: P2(防数据不一致)
+
+---
+
+## 背景
+
+私人定制 (CUSTOM) 产品本质上是为单一客户量身设计的方案, 一旦客户下单付费即代表方案已被接受。继续允许编辑产品本身会导致订单 `productSnapshot` 与产品现状失配, 客户拿到的合同/小程序回显 ≠ 实际购买的方案。
+
+## 改动
+
+### `canEdit` 新规则
+
+| 场景 | 旧 canEdit | 新 canEdit |
+|------|-----------|-----------|
+| 未认证 | false | false (不变) |
+| CUSTOM + 有活跃订单 (status NOT IN CANCELLED/REFUNDED) | 超管=true / 创建人=true | **false (强制覆盖)** |
+| CUSTOM + 0 活跃订单 (或仅 CANCELLED/REFUNDED) | 超管=true / 创建人=true | 不变 |
+| CORE / GROUP | 超管=true / 创建人=true | 不变 (此规则不适用) |
+
+### 受影响接口
+
+- `GET /admin/product/item/{id}` (产品详情)
+- `GET /admin/product/item/list` (产品分页列表)
+
+返回的 VO 中 `canEdit` 字段会按上述新规则计算。`isOwner` 字段不受影响 (仍按 `created_by == 当前 adminId` 判定)。
+
+### Swagger 文档已更新
+
+`ProductDetailRespVO.canEdit` / `ProductListRespVO.canEdit` 的 `ApiModelProperty` 已写明完整规则, 前端可从 swagger UI 直接看到。
+
+---
+
+## 前端 mmg 无需改动
+
+前端继续按当前逻辑读 `canEdit` 决定"修改/删除"按钮 disabled / 隐藏即可。CUSTOM 产品被锁的场景下:
+- 按钮自动 disabled (符合现有交互)
+- 鼠标 hover 提示可考虑加一句"产品已被订单引用, 不可修改" — 但**不是必须**, 现有提示也可继续用
+
+---
+
+## 内部新增端点 (前端无关, 仅记录)
+
+`GET /internal/order/count-active-by-products?productIds=...` → `Map<productId, 活跃订单数>`
+供产品列表批量计算 canEdit, 一次 GROUP BY 替代 N+1 调用。仅 product-v2 通过 Feign 调用, 外部访问会被 `X-Internal-Token` 过滤器拦截。
+
+---
+
+## 降级保护
+
+订单服务异常时, `canEdit` 保留原数据权限计算结果 (不强翻 false) — 订单服务抖动不会连带产品列表/详情不可用。日志关键字: `查 CUSTOM 产品活跃订单数失败` / `批量查 CUSTOM 产品活跃订单数失败`。