feat(M09-D4): 完成商品选购与运营工作台

2026-08-11 08:06:13 +08:00
parent 60264cbd11
commit e91b979128
32 changed files with 1065 additions and 60 deletions
@@ -0,0 +1,12 @@
+# 2026-08-11 M09-D4 商品体验 API
+
+## 新增顾客目录接口
+
+- `GET /app-api/stores/:storeId/product-catalog`
+- 要求有效顾客访问令牌；tenantId 仅取自已验证会话，禁止由客户端传入。
+- 返回门店当前销售开关、分类、在售商品、履约方式、寄存能力与公开 SKU 售价；复用 M09-D1 的目录仓储，不建立第二套商品数据。
+- 未登录返回 401；非法门店参数返回 400；目录业务错误继续使用统一商品错误映射。
+
+## 既有接口的前端接入
+
+M09-D4 未改变商品订单、库存和寄存写契约。小程序复用 `/app-api/product-orders`、`/app-api/product-storages` 顾客接口；Vue 后台复用 `/admin-api/product-listings`、`inventory/stocks`、`product-orders` 与 `product-storages` 既有管理接口。后台菜单与页面按 `product.catalog.*`、`inventory.*`、`goods.order.*`、`goods.storage.*` 独立授权，服务端仍是最终权限边界。