init

2026-06-30 10:33:56 +08:00
commit 6e047dc0a5
607 changed files with 65966 additions and 0 deletions
@@ -0,0 +1,84 @@
+# 杜康好客 preV1
+
+三端 H5 + NestJS Mock 联调版。完整规格见 `杜康好客-V2编码手册.md`，preV1 裁剪见 `杜康好客-preV1编码手册.md`。
+
+## 快速启动
+
+### 1. 基础设施
+
+```bash
+cd deploy
+docker compose up -d
+```
+
+### 2. 安装依赖
+
+```bash
+pnpm install
+```
+
+### 3. 数据库
+
+```bash
+cp server/dukang-api/.env.example server/dukang-api/.env
+pnpm db:generate
+cd server/dukang-api
+npx prisma db push
+pnpm prisma:seed
+```
+
+### 4. 启动服务
+
+```bash
+# 终端 1 - API
+pnpm dev:api
+
+# 终端 2~4 - 三端 H5
+pnpm dev:user    # http://localhost:5173
+pnpm dev:shop    # http://localhost:5174
+pnpm dev:partner # http://localhost:5175
+```
+
+## 测试账号（验证码均为 123456）
+
+| 端 | 手机号 |
+|----|--------|
+| C端用户 | 13800000001 |
+| 门店 | 13900000001 |
+| 合伙人 | 13700000001 |
+
+## 主链路冒烟
+
+```bash
+node scripts/smoke-prev1.mjs
+```
+
+## 目录结构
+
+- `apps/h5-user` · `apps/h5-shop` · `apps/h5-partner` — 三端 H5（Vite + React）
+- `packages/shared-types` · `packages/domain` — 共享契约与纯函数
+- `server/dukang-api` — NestJS 单体 API
+- `pages/` — UI 原型（从 Stitch「4端1.0版本」同步）
+  - `pages/user/` · `pages/shop/` · `pages/partner/` — 各端 screen 的 `code.html` + `screen.png`
+  - `pages/ROUTE_MAP.md` — screen ↔ 路由对照
+  - `pages/stitch_4_1.0/DESIGN.md` — 设计系统
+- `packages/shared-ui` — 三端共享设计令牌与组件
+
+## 同步 Stitch 原型
+
+从 Google Stitch 共享项目「4端1.0版本」拉取最新 HTML/截图：
+
+```bash
+# 设置 API Key（或使用 ~/.cursor/mcp.json 中的 stitch 配置）
+set STITCH_API_KEY=your-key
+pnpm sync:stitch
+# 强制重新下载
+pnpm sync:stitch -- --force
+```
+
+## Mock 开关（`.env`）
+
+- `MOCK_SMS=true` — 固定验证码 123456
+- `MOCK_PAY=true` — 同步支付成功并发券
+- `MOCK_DELIVERY_AUTO=true` — BullMQ 自动推进配送状态
+- `AUTO_APPROVE_STORE=true` — 合伙人录店自动审核通过