Agent Rules
- 新增或修改代码前，必须阅读并遵循
docs/clean-code-contract.md。
- 后端新增或修改业务功能前，必须阅读
docs/backend-feature-development.md。
- 后端代码必须遵循
Controller -> ApplicationService -> Model -> db Service/Mapper 的组织方式。
- 不要把业务规则写在 Controller。
- 不要让 Controller 直接调用 Mapper。
- 不要直接把 Entity 或 DO 返回给前端。
- 复杂查询结果对象可以使用
XxxDO，放在 db 包下，并由 ApplicationService 转换为 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().dictionaryList 或 dictionaryMap，不要硬编码状态文本和值。
