发布商品，商品图片使用oss服务器地址

2026-07-06 08:53:03 +08:00
parent a0466f023e
commit 5ba69eb935
60 changed files with 2776 additions and 157 deletions
@@ -0,0 +1,52 @@
+# V3 验收清单
+
+> 业务事实源：[杜康好客-v3编码手册.md](./杜康好客-v3编码手册.md)  
+> 自动化：`node scripts/smoke-v3.mjs`（Mock 环境）  
+> 历史回归：`node scripts/smoke-prev1.mjs`（preV1 单链路）
+
+## 必过主链路
+
+| # | 验收项 | Owner | API / 页面 | 自动化 |
+|---|--------|-------|------------|--------|
+| 1 | C 端手机号登录 | jacy | `POST /auth/login/sms` · h5-user `/login` | smoke-v3 |
+| 2 | 首页郑州 4 商品 | jacy | `GET /catalog/products?cityCode=` · h5-user `/` | smoke-v3 |
+| 3 | 同城 1 瓶失败 | jacy | `POST /trade/orders/preview` | smoke-v3 |
+| 4 | 同城 2 瓶成功 | jacy | `POST /trade/orders` | smoke-v3 |
+| 5 | 跨城 5/6 瓶边界 | jacy | preview + create | smoke-v3 |
+| 6 | 支付后发权益 | jacy | pay + benefit | smoke-v3 |
+| 7 | 直接核销（无 couponId） | jacy + 刘京尧 | `POST /redeem/tokens` | smoke-v3 |
+| 8 | 单据核销 cap | jacy + 刘京尧 | `POST /redeem/tokens` + couponId | smoke-v3 |
+| 9 | 门店扫码确认 | 刘京尧 | `POST /shop/redeem/confirm` · h5-shop | smoke-v3 |
+| 10 | store_payout 生成 | jacy | settlement | smoke-v3 |
+| 11 | 关闭门店不可核销 | 刘京尧 | store status + redeem | smoke-v3 |
+| 12 | 录店审核后 C 端可见 | 刘京尧 + jacy | admin stores audit · h5-partner | 手动 |
+| 13 | 配送推进完成 | jacy | jobs / delivery callback | smoke-v3 |
+| 14 | 退款工单一致 | jacy | tickets + benefit void | smoke-v3 |
+| 15 | 门店 T+1 打款确认 | jacy | admin store-payouts | smoke-v3 |
+| 16 | 合伙人 T+30 账单 | jacy | admin partner-bills | smoke-v3 |
+
+## 必过后台链路
+
+| # | 验收项 | 页面 |
+|---|--------|------|
+| 1 | WebAdmin 登录 | admin-web `/login` |
+| 2 | 商品 CRUD | `/products` |
+| 3 | 审核门店 | `/stores` |
+| 4 | 订单与配送 | `/orders` · `/deliveries` |
+| 5 | 权益/核销/打款 | `/benefit/*` · `/redeem-records` · `/store-payouts` |
+| 6 | 退款/补发工单 | `/tickets` |
+| 7 | 第三方日志 | `/third-party-logs` |
+| 8 | 财务导出 | `/partner-bills` export |
+
+## 环境矩阵
+
+| 环境 | MOCK_SMS | MOCK_PAY | MOCK_DELIVERY_AUTO | 说明 |
+|------|----------|----------|-------------------|------|
+| 本地开发 | true | true | true | 固定验证码 123456 |
+| 测试沙箱 | false | false | false | 微信/配送沙箱 |
+| 生产 | false | false | false | 真实第三方 |
+
+## 合伙人端交接（刘京尧）
+
+Jacy 侧交付：`/partner/*` 后端 API、shared-types DTO、smoke 断言。  
+刘京尧负责：`apps/h5-partner` 页面接入与验收。