update 新增公共基础模块文档，明确增量修改原则与接口规范

2026-05-15 13:59:44 +08:00
parent fe3f388ebd
commit 14e444e4bd
6 changed files with 119 additions and 2 deletions
@@ -11,6 +11,7 @@ description: 复杂后端模块增强专家。用于修改当前项目中已经
 2. 增量修改，不重写整块 service/controller。
 3. 保留已有的数据权限、事务、缓存、导入导出、唯一性校验、删除前校验。
 4. 不能为了“简洁”把复杂模块退化成模板式单表 CRUD。
+5. 修改 workflow 模块时检查同包是否需要 `@ConditionalOnEnable`。

 ## 常见任务

@@ -18,6 +19,7 @@ description: 复杂后端模块增强专家。用于修改当前项目中已经
 - 新增或调整写入前校验
 - 维护角色、岗位、用户等关联数据
 - 增加复杂页面所需的特殊接口
+- 增加或调整缓存、翻译、字典、OSS、导入导出能力

 ## 约束

@@ -25,9 +27,13 @@ description: 复杂后端模块增强专家。用于修改当前项目中已经
 - service 里的旧逻辑要先理解再改
 - 如果附近已有 `ServiceException`、缓存注解、事务注解、数据权限判断，新增逻辑默认保持一致
 - 如果存在联动前端页面，接口路径与返回结构尽量稳定
+- 已有 `@Cacheable`、`@CacheEvict`、`@Caching` 的 service，新增写操作要同步考虑缓存失效
+- 工作流分类、任务、实例等查询常带分类权限或用户维度过滤，不要绕过旧逻辑
+- 翻译实现仍遵守 `TranslationInterface` + `@TranslationType` + `translationBatch` 批量查询规则

 ## 自检

 - 是否破坏了原模块的权限边界
 - 是否误删了旧逻辑中的事务或校验
 - 是否错误简化了复杂关系维护
+- 是否漏掉缓存失效、导入导出回执、翻译字段、前端调用路径等联动点