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,42 @@
+---
+description: NestJS 模块依赖与 Prisma 写权限 — 后端 OWNER 边界
+globs: server/dukang-api/src/**/*.ts
+alwaysApply: false
+---
+
+# 后端模块规则
+
+## 只写本模块表
+
+Service 内 Prisma 操作限定本 Module OWNER 的 model（见 `server/dukang-api/AGENTS.md`）。
+
+## 禁止依赖（示例）
+
+```typescript
+// ❌ redeem.service.ts
+await this.prisma.order.update(...)
+
+// ✅ redeem.service.ts
+await this.benefitService.deduct(dto)
+await this.settlementService.createStorePayout(recordId)
+```
+
+```typescript
+// ❌ benefit.module.ts imports TradeModule
+// ❌ store.service.ts imports TradeService
+```
+
+## 模块结构
+
+- `exports: [XxxService]` — 唯一对外能力
+- 禁止 export Repository / 裸 Prisma 访问
+- Controller 不可被其他 Module import
+
+## 回调与任务
+
+- 微信/配送回调 **仅** `callbacks/` 入口
+- BullMQ 消费者在 `jobs/`，调用 OWNER Service
+
+## 响应格式
+
+`{ code: 0, message: 'ok', data }` + 对应 Guard（User/Store/Partner/HQ）
@@ -0,0 +1,33 @@
+---
+description: 杜康好客全局约束 — 文档优先级、OWNER 边界、禁止跨模块直写表
+alwaysApply: true
+---
+
+# 杜康好客 · 核心规则
+
+## 文档
+
+- 业务事实源：`杜康好客-V2编码手册.md`
+- preV1 裁剪：`杜康好客-preV1编码手册.md`
+- 协作：`conventions.md` · AI 入口：`AGENTS.md`
+
+## 边界（2 人团队）
+
+| 负责人 | 路径 |
+|--------|------|
+| jacy-dukang | `apps/h5-user/`, `apps/admin-web/`, `packages/`, `callbacks/`, `jobs/`, `common/`, `integrations/`, `modules/{iam,trade,benefit,analytics,catalog,settlement,ops}/` |
+| 刘京尧 | `apps/h5-partner/`, `apps/h5-shop/`, `modules/{store,redeem}/` |
+
+- 跨模块只 inject **exported Service**，禁止 `prisma` 写他人表
+- `apps/*` 禁止 import `server/*`
+- Mock 只在 `integrations/*`，不在业务 Service 散落
+
+## 共享契约
+
+- 枚举/DTO → `packages/shared-types`
+- 纯规则 → `packages/domain`
+
+## 提交
+
+- Conventional Commits：`feat(trade):` 等
+- 不提交 `.env`
@@ -0,0 +1,34 @@
+---
+description: 三端 H5 + admin-web 前端边界与 API 请求规范
+globs: apps/**/*.{ts,tsx}
+alwaysApply: false
+---
+
+# 前端 App 规则
+
+## 隔离
+
+- 禁止 import 其他 `apps/*` 或 `server/*`
+- 类型从 `@dukang/shared-types`；组件从 `@dukang/shared-ui`
+
+## 请求
+
+- Base: `/api/v1`
+- Headers: `Authorization`, `X-Client-App`（USER_H5 | SHOP_H5 | PARTNER_H5）
+
+## UI 约束
+
+- C 端订单 **5 Tab**（含 pending_ship）
+- 门店列表仅展示 `OPEN` 状态
+- 原型 `pages/` 只读参照，不在此目录改业务代码
+
+## App 归属（2 人团队）
+
+| App | 负责人 | 勿改他端页面 |
+|-----|--------|--------------|
+| h5-user | jacy-dukang | shop 核销、partner 录店 |
+| h5-shop | 刘京尧 | user 出码、admin 报表 |
+| h5-partner | 刘京尧 | user 下单、admin 开城 |
+| admin-web | jacy-dukang | 非 V2 小程序规格 |
+
+路由对照：`pages/ROUTE_MAP.md`
@@ -0,0 +1,28 @@
+---
+description: packages 共享契约 — shared-types 与 domain 变更策略
+globs: packages/**/*
+alwaysApply: false
+---
+
+# packages 规则
+
+## shared-types
+
+- 前后端唯一 DTO/枚举来源
+- **加法优先**：新字段 optional；删除/改名先 deprecated
+- 改 API 必须同步 V2 手册 §六
+
+## domain
+
+- 纯函数，无 IO（无 Prisma/Redis/HTTP）
+- 起购 2/6 瓶、权益 `benefitAmount ?? price`、核销 ¥500 上限在此实现
+- 变更必须有单元测试
+
+## shared-ui
+
+- 跨 App 组件；禁止 import 特定 App 代码
+- 设计令牌与 preV1 三 H5 共用
+
+## 破坏性改动
+
+需通知 jacy-dukang 与 刘京尧（若影响 partner/shop API）并在 PR 说明影响面。
@@ -0,0 +1,29 @@
+---
+description: Prisma schema 变更需对齐 V2 手册 §五 并经表 OWNER Review
+globs: server/dukang-api/prisma/**
+alwaysApply: false
+---
+
+# Prisma / 数据库规则
+
+## 事实源
+
+V2 手册 §五（v3.1，28 表）。schema 与手册保持一致。
+
+## 变更流程
+
+1. 确认受影响 Module OWNER（见 `server/dukang-api/AGENTS.md` 表映射）
+2. 修改 `schema.prisma`
+3. `pnpm db:validate`
+4. PR 需对应 OWNER + Lead Review
+
+## 关键约定
+
+- 无 `payments` / `user_order_item` / `redeem_tokens` 表
+- 核销码仅 Redis 5 分钟
+- 支付流水 → `log_third_party` + `user_order.pay_*`
+- 业务事件 → `common_event`；埋点 → `log_user_analytics`
+
+## preV1
+
+不删表、不改 V2 字段语义。Seed：`prisma/seed-v31.ts`