整理上下文
This commit is contained in:
@@ -1,55 +0,0 @@
|
|||||||
---
|
|
||||||
description: 杜康好客全局约束 — Monorepo 布局、文档优先级、2 人 OWNER 边界
|
|
||||||
alwaysApply: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# 杜康好客 · 核心规则
|
|
||||||
|
|
||||||
## Monorepo 布局
|
|
||||||
|
|
||||||
- `apps/` — preV1:`h5-user`、`h5-shop`、`h5-partner`、`admin-web`
|
|
||||||
- `packages/` — `shared-types`、`domain`、`shared-ui`
|
|
||||||
- `server/dukang-api/` — NestJS 单体 API
|
|
||||||
- `pages/` — UI 原型(**只读参照**)
|
|
||||||
|
|
||||||
> V2 目标为 Taro 四端(`mini-user` 等),编码以 **当前实际目录** 为准。
|
|
||||||
|
|
||||||
## 文档
|
|
||||||
|
|
||||||
- **V3.0 业务事实源**:`杜康好客-v3-PRD.md`
|
|
||||||
- V3 实现验收:`杜康好客-v3编码手册.md`
|
|
||||||
- V2 蓝图:`杜康好客-V2编码手册.md`(与 V3 冲突时 V3 PRD 优先)
|
|
||||||
- preV1 裁剪:`杜康好客-preV1编码手册.md`
|
|
||||||
- 协作:`conventions.md` · AI 入口:`AGENTS.md`
|
|
||||||
|
|
||||||
**禁止**:编码时修改业务规则;需求变更只改 `杜康好客-v3-PRD.md`。
|
|
||||||
|
|
||||||
## 边界(2 人团队)
|
|
||||||
|
|
||||||
> **临时(2026-07)**:刘京尧任务由 `jacy-dukang` 代管,B+D 路径可改。
|
|
||||||
|
|
||||||
| 负责人 | 路径 |
|
|
||||||
|--------|------|
|
|
||||||
| jacy-dukang | `apps/*`, `packages/`, `callbacks/`, `jobs/`, `common/`, `integrations/`, 全部 `modules/*` |
|
|
||||||
| ~~刘京尧~~ | ~~`apps/h5-partner/`, `apps/h5-shop/`, `modules/{store,redeem}/`~~(暂代管) |
|
|
||||||
|
|
||||||
- 跨模块只 inject **exported Service**,禁止 `prisma` 写他人表
|
|
||||||
- `apps/*` 禁止 import `server/*` 或其他 app
|
|
||||||
- Mock 只在 `integrations/*`,不在业务 Service 散落
|
|
||||||
|
|
||||||
## 共享契约
|
|
||||||
|
|
||||||
- 枚举/DTO → `packages/shared-types`
|
|
||||||
- 纯规则 → `packages/domain`(无 IO)
|
|
||||||
|
|
||||||
## 核心业务常量
|
|
||||||
|
|
||||||
- 权益额 = `benefit_amount ?? price`
|
|
||||||
- 核销:直接核销 `0 < amount ≤ 全部 ACTIVE 权益总余额`;带单据核销 `0 < amount ≤ 该单据可用金额`;Redis 码 3 分钟
|
|
||||||
- 订单 Tab(V3.0):`待付款 | 已付款 | 已完成`
|
|
||||||
- API:`/api/v1`,响应 `{ code, message, data }`
|
|
||||||
|
|
||||||
## 提交
|
|
||||||
|
|
||||||
- Conventional Commits:`feat(trade):` 等
|
|
||||||
- 不提交 `.env`
|
|
||||||
@@ -1,33 +1,11 @@
|
|||||||
---
|
---
|
||||||
description: Git 提交与 PR 协作规范
|
description: 杜康提交 scope 与发版默认(生产)
|
||||||
alwaysApply: true
|
alwaysApply: true
|
||||||
---
|
---
|
||||||
|
|
||||||
# Git 规范
|
# Git / 发版(杜康专属)
|
||||||
|
|
||||||
## 提交格式
|
- Conventional Commits,scope = 端或模块:`feat(trade):`、`fix(redeem):`
|
||||||
|
- 只说「发布/发版」→ 生产(`main` + `deploy-prod.sh`);明确说「发测试」才 staging。流程见 `/dukang-release`
|
||||||
Conventional Commits,scope = 端或模块名:
|
- 改 API/表 → 同步 v3-PRD + v3编码手册 + `shared-types`
|
||||||
|
- Prisma 迁移须 Review
|
||||||
```
|
|
||||||
feat(trade): add order preview API
|
|
||||||
fix(redeem): validate redeem amount against balance
|
|
||||||
chore(shared-types): add OrderStatus enum
|
|
||||||
```
|
|
||||||
|
|
||||||
## 禁止提交
|
|
||||||
|
|
||||||
- `.env`、`.env.local` 等敏感配置
|
|
||||||
- `node_modules/`、`dist/`(已在 .gitignore)
|
|
||||||
|
|
||||||
## PR 与 Review
|
|
||||||
|
|
||||||
- feature 分支 + 小步 PR
|
|
||||||
- 跨模块改动需相关双 Owner Review
|
|
||||||
- Prisma 迁移必须多 Owner Review
|
|
||||||
|
|
||||||
## Agent 行为
|
|
||||||
|
|
||||||
- **仅用户明确要求时** 才执行 git commit / push
|
|
||||||
- 不 amend 已推送的 commit,不 force push main/master/dev
|
|
||||||
- 发版:`dev`→测试(staging),`main`→生产;用户只说「发布/发版」默认发**生产**(见 dukang-release skill);明确说「发测试」才发 staging
|
|
||||||
|
|||||||
@@ -21,7 +21,7 @@ disable-model-invocation: true
|
|||||||
## 会话启动(按序)
|
## 会话启动(按序)
|
||||||
|
|
||||||
1. 确认阶段:**V3.0** → 读 `杜康好客-v3-PRD.md` + `@dukang-v3`;preV1 → preV1 手册;V2 蓝图 → V2 手册
|
1. 确认阶段:**V3.0** → 读 `杜康好客-v3-PRD.md` + `@dukang-v3`;preV1 → preV1 手册;V2 蓝图 → V2 手册
|
||||||
2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 表 → **只改本 OWNER 路径**
|
2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 段 + 对应 `apps/` 或 `server/dukang-api/AGENTS.md` → **只改本 OWNER 路径**
|
||||||
3. 有任务卡 ID → 配合 `dukang-task-card` skill 或查 preV1 §9 / V2 §七
|
3. 有任务卡 ID → 配合 `dukang-task-card` skill 或查 preV1 §9 / V2 §七
|
||||||
4. UI 任务 → `pages/ROUTE_MAP.md` + 对应 `pages/{端}/` 原型
|
4. UI 任务 → `pages/ROUTE_MAP.md` + 对应 `pages/{端}/` 原型
|
||||||
5. 编码前过一遍下方 Checklist
|
5. 编码前过一遍下方 Checklist
|
||||||
|
|||||||
@@ -5,6 +5,7 @@ description: >-
|
|||||||
MOCK_SMS/MOCK_PAY/MOCK_DELIVERY flags, Seed data, and V2 upgrade path.
|
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-*,
|
Use when working on Mock providers, feature flags, preV1 task cards P1-*,
|
||||||
or smoke tests — not for V2 WeChat/payment production integration.
|
or smoke tests — not for V2 WeChat/payment production integration.
|
||||||
|
disable-model-invocation: true
|
||||||
---
|
---
|
||||||
|
|
||||||
# 杜康好客 · preV1 Mock Skill
|
# 杜康好客 · preV1 Mock Skill
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ description: >-
|
|||||||
杜康好客发布流程:dev→测试(staging),main→生产;同机双栈。
|
杜康好客发布流程:dev→测试(staging),main→生产;同机双栈。
|
||||||
Use when the user says 发布、上传、deploy、上线、发版、发测试、发生产,
|
Use when the user says 发布、上传、deploy、上线、发版、发测试、发生产,
|
||||||
or @杜康发布 / @dukang-release.
|
or @杜康发布 / @dukang-release.
|
||||||
|
disable-model-invocation: true
|
||||||
---
|
---
|
||||||
|
|
||||||
# 杜康发布
|
# 杜康发布
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ description: >-
|
|||||||
Executes Dukang Haoke task cards (P1-M* or M0-M6) one at a time with DoD
|
Executes Dukang Haoke task cards (P1-M* or M0-M6) one at a time with DoD
|
||||||
verification. Use when the user provides a task ID like P1-M2-002 or M2-FE-U-003,
|
verification. Use when the user provides a task ID like P1-M2-002 or M2-FE-U-003,
|
||||||
or asks to start/implement a milestone card from the coding manuals.
|
or asks to start/implement a milestone card from the coding manuals.
|
||||||
|
disable-model-invocation: true
|
||||||
---
|
---
|
||||||
|
|
||||||
# 杜康好客 · 任务卡 Skill
|
# 杜康好客 · 任务卡 Skill
|
||||||
|
|||||||
Reference in New Issue
Block a user