feat: 技术支持工单/企微权限/开发版本管理/消息推送等迭代

2026-08-04 21:32:13 +08:00
parent c8ea5a3119
commit 9d96c73246
1341 changed files with 0 additions and 195605 deletions
@@ -1,122 +0,0 @@
---
-name: dukang-coding
-description: >-
-  Implements 杜康好客 features following V2/preV1 coding manuals, module OWNER
-  boundaries, and shared-types contracts. Use when coding APIs, pages, Prisma logic,
-  task cards, or fixing bugs — not for PRD/requirements review (use @dukang-project).
-disable-model-invocation: true
---
-
-# 杜康好客 · 编码 Skill
-
-## 何时启用
-
- 实现/修复 `apps/*`、`server/dukang-api`、`packages/*` 功能
- 实现任务卡（`M2-BE-TRD-002`、`P1-M2-002` 等）
- 用户给出任务卡 ID、说「开始 coding」或 @dukang-coding
- 修复 V1 范围 Bug
-
-**不用于**：写 PRD、评审需求、纯文档问答 → 用 @dukang-project 或直接读手册
-
-## 会话启动（按序）
-
-1. 确认阶段：**V3.0** → 读 `杜康好客-v3-PRD.md` + `@dukang-v3`；preV1 → preV1 手册；V2 蓝图 → V2 手册
-2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 表 → **只改本 OWNER 路径**
-3. 有任务卡 ID → 配合 `dukang-task-card` skill 或查 preV1 §9 / V2 §七
-4. UI 任务 → `pages/ROUTE_MAP.md` + 对应 `pages/{端}/` 原型
-5. 编码前过一遍下方 Checklist
-
-**需求变更** → V3.0 只改 `杜康好客-v3-PRD.md`，编码时不改业务规则。
-
-## 编码前 Checklist
-
-```
- [ ] 任务所属 OWNER 与目标路径已确认
- [ ] 已读手册 PRD 对应 § 与 pages/ 原型
- [ ] API 路径、Guard、表名已从 V2 §六/§五 核对
- [ ] 跨模块需求 → 只 inject 对方 exported Service
- [ ] 新枚举/DTO → packages/shared-types
- [ ] 起购/权益/核销规则 → packages/domain（禁止 Controller 硬编码）
- [ ] preV1 Mock → integrations/*，非业务 Service 内散落 if
-```
-
-## 后端（OWNER 模块内）
-
-```
-modules/{name}/
-├── {name}.module.ts    # exports: [XxxService] 唯一出口
-├── {name}.controller.ts
-├── {name}.service.ts   # 仅写本模块 Prisma 表
-└── dto/
-```
-
-Workflow：DTO → Service（本模块表）→ Controller + Guard → 同步 shared-types。
-
-跨模块示例（允许）：
-
-```typescript
-// trade.service.ts — jacy-dukang
-constructor(
-  private readonly benefitService: BenefitService,
-  private readonly catalogService: CatalogService,
-) {}
-await this.benefitService.grantOnOrderPaid(orderId);
-```
-
-跨模块示例（禁止）：
-
-```typescript
-// redeem.service.ts — ❌ 禁止
-await this.prisma.order.update({ ... });
-```
-
-## 前端（单 App 内）
-
-1. 路由对照 `pages/ROUTE_MAP.md`
-2. `src/lib/api.ts` 统一 fetch + `X-Client-App`
-3. 类型从 `@dukang/shared-types` import
-4. preV1 App：`h5-user` / `h5-shop` / `h5-partner` / `admin-web`
-5. C 端订单 Tab（V3.0）：`待付款 | 已付款 | 已完成`
-
-## 数据库变更
-
-1. 改 `server/dukang-api/prisma/schema.prisma` 对齐手册 §五
-2. 迁移需 OWNER Review（store/redeem 表 → 刘景尧）
-3. 初始化 SQL：`server/dukang-api/prisma/init_v3.sql`
-
-## 核心业务（packages/domain）
-
-```typescript
-const benefitAmount = product.benefitAmount ?? product.price;
-// 核销：直接核销按全部 ACTIVE 权益总余额；带单据核销按该单据可用金额
-// 同城 min 2 瓶 / 跨城 min 6 瓶
-
-// 支付成功 → log_third_party + user_order.pay_status=PAID
-// → user_benefit_coupon + common_event(BENEFIT_LEDGER, GRANT)
-// 埋点 → log_user_analytics；业务审计 → common_event
-```
-
-## 核销并发（M3+）
-
- Redis `redeem:token:{token}` EX 300
- 事务 + `user_benefit_coupon.version` 乐观锁
- 写 `user_redeem_record` + `store_payout`(PENDING) + `common_event(BENEFIT_LEDGER, REDEEM)`
-
-## 资源上传
-
-`POST /common/resources/upload-token` → OSS 直传 → `POST /common/resources`
-
-## 完成定义
-
- 任务卡验收项全部满足
- 无跨模块 Prisma 直写
- `packages/domain` 相关单测通过
- `pnpm lint` 无新增错误
- 改了 API/表 → 同步手册与 shared-types
-
-## 延伸阅读
-
- 模块/表/路由：[reference-backend.md](reference-backend.md)
- 页面↔API 速查：[reference-frontend.md](reference-frontend.md)
- preV1 Mock：`dukang-prev1` skill
- 详细清单：根目录 `skills.md`