feat: multi-module iteration

2026-08-04 21:38:49 +08:00
parent 9d96c73246
commit 71f508e02b
1366 changed files with 202004 additions and 0 deletions
@@ -0,0 +1,55 @@
+---
+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`