整理开发文档

2026-08-19 16:20:33 +08:00
parent 233ed0af3b
commit 62353a6800
21 changed files with 0 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 杜康好客 · preV1 编码手册（Mock 联调）
+
+> **非 V3 验收标准**。核销等规则以 [`杜康好客-v3编码手册.md`](./杜康好客-v3编码手册.md) 为准。  
+> 原则：**同 V2 库表与 API 路径**，用 Mock/Flag/Seed 跳过外部依赖。
+
+## 六条裁剪
+
+| # | 裁剪 | 替代 |
+|---|------|------|
+| 1 | 无 HQ 前端 | `/admin/*` 脚本或后续 admin-web |
+| 2 | 三端均 H5 | `h5-user` / `h5-shop` / `h5-partner` |
+| 3 | 登录 | 手机号 + 固定码 `999888` |
+| 4 | 支付 | Mock 即时成功 |
+| 5 | 配送 | Mock 状态推进 |
+| 6 | 短信 | Mock |
+
+## Feature Flag（`.env`）
+
+| Flag | 作用 |
+|------|------|
+| `MOCK_SMS` | 验证码 999888 |
+| `MOCK_PAY` | 支付同步成功 |
+| `MOCK_DELIVERY` | 配送 Mock 推进 |
+
+## 启动验证
+
+```bash
+pnpm dev:api && pnpm dev:user && pnpm dev:shop && pnpm dev:partner
+node scripts/smoke-prev1.mjs
+```
+
+## 与 V2 差异速查
+
+| 项 | preV1 | V2/V3 |
+|----|-------|-------|
+| 客户端 | 三 H5 | 小程序 + H5 |
+| 总部 | 无 UI | admin-web |
+| 微信 | 无 | JSAPI/OAuth |
+| 表结构 | v3.1 同左 | 同左 |
+
+升级：逐项关 Mock → 接真实集成 → 补 admin-web / mini-user。