Files
collab-ledger/AGENTS.md
T
2026-06-17 20:58:00 +08:00

1.1 KiB

Agent Rules

  • 新增或修改代码前,必须阅读并遵循 docs/clean-code-contract.md
  • 后端新增或修改业务功能前,必须阅读 docs/backend-feature-development.md
  • 后端代码必须遵循 Route -> Feature Service -> Prisma/Redis/shared Service 的组织方式。
  • 不要把业务规则堆在 Route。
  • 不要在 Route 中直接扩散 Prisma 原始记录给前端。
  • 复杂查询结果由 Feature Service 转换为稳定 DTO。
  • 字典类需求不要默认创建字典管理表;本项目现有字典数据使用 Enum 和缓存。
  • frontend/web 新增或修改业务功能前,必须阅读 docs/web-feature-development.md
  • Web 前端接口必须通过 @/utils/http 封装调用,不要直接使用 Axios。
  • Web 列表页复杂状态和行为应放在 utils/hook.tsx,不要堆在 index.vue
  • Web 页面私有组件放在当前模块的 components/,多模块复用组件提升到 frontend/web/src/components
  • Web 字典展示优先使用 useUserStoreHook().dictionaryListdictionaryMap,不要硬编码状态文本和值。