Files

T

jacy 71f508e02b feat: multi-module iteration

2026-08-04 21:38:49 +08:00

4.0 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
dukang-coding	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).	true

杜康好客 · 编码 Skill

何时启用

实现/修复 apps/*、server/dukang-api、packages/* 功能
实现任务卡（M2-BE-TRD-002、P1-M2-002 等）
用户给出任务卡 ID、说「开始 coding」或 @dukang-coding
修复 V1 范围 Bug

不用于：写 PRD、评审需求、纯文档问答 → 用 @dukang-project 或直接读手册

会话启动（按序）

确认阶段：V3.0 → 读 杜康好客-v3-PRD.md + @dukang-v3；preV1 → preV1 手册；V2 蓝图 → V2 手册
读 AGENTS.md OWNER 表 → 只改本 OWNER 路径
有任务卡 ID → 配合 dukang-task-card skill 或查 preV1 §9 / V2 §七
UI 任务 → pages/ROUTE_MAP.md + 对应 pages/{端}/ 原型
编码前过一遍下方 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。

跨模块示例（允许）：

// trade.service.ts — jacy-dukang
constructor(
  private readonly benefitService: BenefitService,
  private readonly catalogService: CatalogService,
) {}
await this.benefitService.grantOnOrderPaid(orderId);

跨模块示例（禁止）：

// redeem.service.ts — ❌ 禁止
await this.prisma.order.update({ ... });

前端（单 App 内）

路由对照 pages/ROUTE_MAP.md
src/lib/api.ts 统一 fetch + X-Client-App
类型从 @dukang/shared-types import
preV1 App：h5-user / h5-shop / h5-partner / admin-web
C 端订单 Tab（V3.0）：待付款 | 已付款 | 已完成

数据库变更

改 server/dukang-api/prisma/schema.prisma 对齐手册 §五
迁移需 OWNER Review（store/redeem 表 → 刘景尧）
初始化 SQL：server/dukang-api/prisma/init_v3.sql

核心业务（packages/domain）

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

4.0 KiB Raw Blame History Unescape Escape