# 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` 页面接入与验收。