agents 和 skills 上传

2026-07-01 17:12:46 +08:00
parent aeb4ecfc84
commit 9cbd65f8d7
23 changed files with 1276 additions and 34 deletions
@@ -0,0 +1,94 @@
+---
+name: dukang-prev1
+description: >-
+  Guides preV1 Mock integration phase for Dukang Haoke: H5 three-client setup,
+  MOCK_SMS/MOCK_PAY/MOCK_DELIVERY flags, Seed data, and V2 upgrade path.
+  Use when working on Mock providers, feature flags, preV1 task cards P1-*,
+  or smoke tests — not for V2 WeChat/payment production integration.
+---
+
+# 杜康好客 · preV1 Mock Skill
+
+## 定位
+
+preV1 = V2 之上的**裁剪实现**：**不删表、不删 API 路径、不改字段语义**。
+
+权威文档：[`杜康好客-preV1编码手册.md`](../../杜康好客-preV1编码手册.md)
+
+## 六条裁剪（必记）
+
+1. **无 HQ 小程序** → `admin-web` 内部替代；`/admin/*` 保留，前端不暴露 AdminAuth 给 C/B/D 端
+2. **三端均 H5** → `USER_H5` / `SHOP_H5` / `PARTNER_H5`
+3. **无微信登录** → 仅 SMS；wechat 路由返回 501 或 Flag 关闭
+4. **验证码 Mock** → `123456`，`MOCK_SMS=true`
+5. **配送 Mock** → BullMQ 自动推进或合伙人 `mock-advance-delivery`
+6. **支付 Mock** → `POST /trade/orders/:id/pay` 同步成功 + **真实发券**
+
+## 环境变量（`.env.example`）
+
+```bash
+MOCK_SMS=true
+MOCK_SMS_CODE=123456
+MOCK_PAY=true
+MOCK_DELIVERY_AUTO=true
+AUTO_APPROVE_STORE=true
+```
+
+配置加载：`packages/shared-types/src/config.ts` → `loadAppConfig()`
+
+## Mock 代码位置（禁止散落）
+
+```
+server/dukang-api/src/integrations/
+├── sms/sms.interface.ts + sms.mock.provider.ts
+├── pay/pay.interface.ts + pay.mock.provider.ts
+└── delivery/delivery.interface.ts + delivery.mock.provider.ts
+```
+
+业务 Module 只 inject **interface**，由 Nest DI 切换 Mock/Real。
+
+## preV1 必做 vs 跳过
+
+| 必做 | 跳过（V2 补） |
+|------|---------------|
+| 三端 SMS 登录 | 微信登录/支付/退款 |
+| Mock 支付 + 真实发券 | 微信 prepay/回调验签 |
+| 5 Tab 订单 | HQ 小程序 UI |
+| Redis 核销码 + 门店核销 | 真实小飞侠/物流 |
+| 合伙人录店 + AUTO_APPROVE | 总部人工审核 UI |
+| 可选埋点 | 推广码 HQ UI、T+30 真实打款 |
+
+## HQ 能力替代（Seed）
+
+| V2 HQ | preV1 |
+|-------|-------|
+| 开城/商品 CRUD | Seed 固定 + admin-web 或改 seed |
+| 门店审核 | AUTO_APPROVE_STORE=true |
+| 退款/客服 | 跳过 |
+| 结算 | store_payout PENDING；可 Seed 演示账单 |
+
+Seed：`server/dukang-api/prisma/seed-v31.ts`
+
+## 测试账号
+
+| 角色 | 手机号 |
+|------|--------|
+| C 端 | 13800000001 |
+| 门店 | 13900000001 |
+| 合伙人 | 13700000001 |
+
+## 冒烟
+
+```bash
+node scripts/smoke-prev1.mjs
+```
+
+## preV1 → V2 切换检查
+
+按 preV1 手册 §8.2 逐项关闭 Mock Flag，**无需重构表结构**。
+
+## 边界提醒
+
+- preV1 skill **不负责**实现 V2 微信 SDK；遇到真实支付/短信需求 → 停止并切换 V2 手册 §九
+- 改 Mock 行为时 **仍须** 遵守 OWNER 模块边界
+- admin-web 是 preV1 内部工具，勿与 V2 `pages/hq/` 原型混为一谈