zk
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
---
|
|
inclusion: always
|
|
---
|
|
|
|
# 项目规范执行指引
|
|
|
|
## 方案讨论前
|
|
|
|
必读 `#[[file:.kiro/steering/项目结构说明.md]]`，全面了解：
|
|
- 三层模块职责与依赖关系：`client-api` → `manager` → `common`
|
|
- 所有业务实体及其关联
|
|
- 权限体系设计、邀请模块设计
|
|
- 现有的公共能力（工具类、配置、拦截器），避免重复造轮子
|
|
|
|
方案讨论时：
|
|
- 优先给出简洁的方案思路（涉及哪些模块和实体、新增内容放在哪、核心流程概要），不要一开始就铺开所有细节
|
|
- 用户明确要求时，再给出详细的方案流程（表结构、接口清单、完整逻辑步骤等）
|
|
- 做好解耦，说明与现有模块的关系
|
|
|
|
## 开发方案输出前 / 写代码前
|
|
|
|
必读 `#[[file:.kiro/steering/代码开发风格文档.md]]`，严格遵守：
|
|
- 命名约定、注解与依赖注入规范
|
|
- POJO 分包规则（dto/vo/po/param 按功能模块建子目录）
|
|
- Service 类注释规范（主要功能、依赖服务、使用的表、方法逻辑流程）
|
|
- 接口规范、异常处理、Redis 使用、数据库设计风格、分页规范
|
|
|
|
## 写完代码后
|
|
|
|
涉及新增文件、新增模块或目录结构变更时，必须同步更新 `#[[file:.kiro/steering/项目结构说明.md]]`，保持文档与实际代码一致。 |