qipai/docs/api-changelog/2026-08-11-M09-D4-product-experience.md

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.* 独立授权，服务端仍是最终权限边界。