agents 和 skills 上传

.cursor/skills/dukang-coding/reference-frontend.md

@@ -0,0 +1,65 @@
+# 前端速查（preV1 三 H5 + admin-web）
+
+> 路由事实源：[`pages/ROUTE_MAP.md`](../../../pages/ROUTE_MAP.md)
+
+## App 配置
+
+| App | Filter | Dev | X-Client-App |
+|-----|--------|-----|--------------|
+| h5-user | @dukang/h5-user | pnpm dev:user | USER_H5 |
+| h5-shop | @dukang/h5-shop | pnpm dev:shop | SHOP_H5 |
+| h5-partner | @dukang/h5-partner | pnpm dev:partner | PARTNER_H5 |
+| admin-web | @dukang/admin-web | pnpm dev:admin | AdminAuth（内部） |
+
+## 共享包
+
+```typescript
+import { OrderStatus, ClientApp } from '@dukang/shared-types';
+import { PageHeader } from '@dukang/shared-ui';
+```
+
+## h5-user 主路由（OWNER A）
+
+| Route | 页面 | 关键 API |
+|-------|------|----------|
+| `/login` | 登录 | POST /auth/sms/send, /auth/login/sms |
+| `/` | 首页 | GET /catalog/products |
+| `/product/:id` | 详情 | GET /catalog/products/:id |
+| `/order/confirm` | 确认订单 | POST /trade/orders/preview, /trade/orders |
+| `/pay` | Mock 支付 | POST /trade/orders/:id/pay |
+| `/orders` | 5 Taber | GET /trade/orders?tab= |
+| `/benefit` | 权益 | GET /benefit/coupons |
+| `/redeem` | 出码 | POST /redeem/token |
+| `/stores` | 门店 | GET /stores（仅 OPEN） |
+
+## h5-shop 主路由（OWNER D）
+
+| Route | 页面 | 关键 API |
+|-------|------|----------|
+| `/login` | 登录 | POST /shop/auth/login/sms |
+| `/redeem` | 核销确认 | POST /shop/redeem/confirm |
+| `/records` | 核销记录 | GET /shop/redeem/records |
+
+## h5-partner 主路由（OWNER B）
+
+| Route | 页面 | 关键 API |
+|-------|------|----------|
+| `/stores/new` | 录店 | POST /partner/stores |
+| `/stores` | 门店管理 | GET /partner/stores |
+| `/orders` | 辖区订单 | GET /partner/orders |
+| — | Mock 推进配送 | POST /partner/orders/:id/mock-advance-delivery |
+
+## UI 硬约束
+
+- C 端订单 **5 Tab**（含 pending_ship）
+- 个人中心无会员等级（V1 不做会员体系）
+- 清香型 4 SKU 可购；酱香/浓香灰态
+- 原型只读：`pages/{端}/*/code.html`，勿改原型目录
+
+## preV1 与 V2 UI 差异
+
+| 项 | preV1 | V2 |
+|----|-------|-----|
+| C/合伙人载体 | H5 | 微信小程序 |
+| 总部 | admin-web 内部 | mini-hq 小程序 |
+| 支付页 | Mock 同步成功 | 微信 JSAPI |