soloforge 1.2.1 → 1.2.2

package/templates/knowledge/domain//345/256/241/350/256/241/346/227/245/345/277/227.md

@@ -8,25 +8,24 @@ products: ["*"]
 
 ## 业务规则
 1. 所有关键业务操作（创建、修改、删除、导出、权限变更）必须记录审计日志
-2. 审计日志不可修改和删除，至少保留 3 年
-3. 每条审计日志包含：操作人、操作时间、操作类型、操作对象、变更前后数据
+2. 审计日志不可修改和删除（append-only），至少保留 3 年
+3. 每条审计日志必须包含：操作人、操作时间、操作类型、操作对象、变更前后数据
 4. 敏感操作（删除、权限变更、导出）需额外通知管理员
-5. 审计日志必须记录：操作人、操作时间、操作类型、目标对象、变更前后值
-6. 审计日志禁止被修改或删除（append-only），保证审计链完整性
-7. 审计日志查询必须支持按时间范围、操作人、操作类型、目标对象筛选
+5. 审计日志查询必须支持按时间范围、操作人、操作类型、目标对象筛选
+6. 审计日志必须记录操作来源（Web/API/定时任务/系统），便于问题追溯
+7. 批量操作必须合并为一条审计记录，包含操作数量和关键参数
 
 ## 约束条件
 - 审计日志存储在独立表中（audit_log），不与业务数据混存
 - 通过 AOP 切面自动记录，减少开发人员手动埋点
 - 变更前后数据使用 JSON 格式存储（before/after 字段）
 - 审计日志表不支持 UPDATE 和 DELETE（数据库层权限控制）
-- 审计日志必须独立存储，不能与业务数据混用同一张表
 - 审计日志保留期限必须符合合规要求（如 ≥ 180 天）
 
 ## 例外情况
 - 查询操作（GET）一般不记录审计日志（除导出操作）
+- 系统内部自动任务的操作记录标注为"系统"操作人
 - 批量操作合并为一条审计记录（含数量信息）
-- 查询类操作（GET）通常不记录审计日志，除非有特殊合规要求
 
 ## 关联模式
 参见 logging 模式（日志记录规范）、error-handling 模式（异常处理与审计）

package/templates/knowledge/domain//345/257/274/345/205/245/345/257/274/345/207/272/350/247/204/345/210/231.md

@@ -9,7 +9,7 @@ products: ["*"]
 ## 业务规则
 - 导入必须提供标准模板下载功能，模板字段与校验规则一一对应
 - 导入数据必须全量校验后再入库，禁止边校验边入库（部分成功部分失败难以处理）
-- 校验失败必须返回完整錙误报告（行号 + 字段名 + 錙误原因），禁止只返回"导入失败"
+- 校验失败必须返回完整错误报告（行号 + 字段名 + 错误原因），禁止只返回"导入失败"
 - 超过 1000 条的导入必须走异步处理，返回任务 ID 和进度查询接口
 - 导入更新模式必须明确：新增/覆盖/跳过已存在记录
 - 导出字段必须与导入模板字段对齐，导入的数据可通过导出还原
@@ -17,7 +17,7 @@ products: ["*"]
 - 导入模板必须与当前系统版本一致，字段变更时同步更新模板
 - 导出数据必须遵循数据权限规则，用户只能导出权限范围内的数据
 
-## 约束
+## 约束条件
 - 导入文件大小限制（建议 10MB），超过限制前端拦截不提交
 - 导入文件类型限制（仅允许 .xlsx/.xls/.csv），禁止 .exe/.sh 等可执行文件
 - 导入操作必须有审计日志（操作人、时间、记录数、成功/失败数）
@@ -25,7 +25,7 @@ products: ["*"]
 - 导入文件大小必须限制（如 ≤ 20MB），超过限制拒绝处理
 - 导入操作必须有操作日志，记录导入人、时间、记录数、成功/失败数
 
-## 例外
+## 例外情况
 - 小数据量（< 100 条）可同步导入，直接返回结果
 - 参考数据（字典、配置）导入可简化校验
 - 系统管理员导出数据可以绕过数据权限，但必须有审批流程

package/templates/knowledge/domain//351/200/232/347/224/250/346/234/272/346/242/260/346/235/241/346/254/276.md

@@ -6,19 +6,29 @@ scope: [backend]
 products: ["*"]
 ---
 
-## 常见机械条款
+## 业务规则
+1. 幂等：同一请求多次执行结果必须一致，适用于 PUT/DELETE 接口、支付回调、消息消费等场景
+2. 乐观锁：基于版本号（version 字段）的并发控制，更新时必须校验版本号，冲突时抛出业务异常而非静默覆盖
+3. 软删除：标记删除（is_deleted / deleted_at）而非物理删除，适用于有审计要求或可恢复需求的数据
+4. 硬删除：物理移除数据，仅适用于临时数据、可重建数据、日志明细等无审计要求的场景
+5. 级联：主记录变更自动传递到子记录（如主表状态变更联动子表），必须明确级联范围，禁止无限制级联
+6. 可恢复删除：删除后可在一定窗口内恢复（如回收站机制），窗口期到期后自动物理删除或归档
+7. 补偿：正向操作失败时执行反向操作，用于分布式事务 saga 模式，补偿操作本身也必须幂等
 
-| 条款 | 含义 | 适用场景 |
-|------|------|---------|
-| 幂等 | 同一请求多次执行结果一致 | PUT/DELETE 接口、支付回调 |
-| 乐观锁 | 基于版本号的并发控制 | 编辑保存、状态流转 |
-| 软删除 | 标记删除而非物理删除 | 有审计要求的数据 |
-| 硬删除 | 物理移除数据，不再保留主记录 | 临时数据、可重建数据 |
-| 级联 | 主记录变更自动传递到子记录 | 主从表同步、状态联动 |
-| 可恢复删除 | 删除后可在一定窗口内恢复 | 回收站、误删保护 |
-| 补偿 | 正向操作失败时执行反向操作 | 分布式事务、saga 模式 |
+## 约束条件
+- 需求中出现上述条款时必须明确其在本项目中的具体实现语义，不得假设"大家都懂"
+- 机械条款的选择属于裁决（团队决策），不属于需求事实，必须在需求澄清阶段确认
+- 幂等字段必须建立唯一索引（如支付流水号、消息 ID），依赖数据库约束保证幂等性
+- 乐观锁 version 字段禁止在 DTO 中暴露给前端，仅服务端内部使用
+- 软删除的查询必须全局过滤已删除记录（MyBatis 拦截器或全局 scope），禁止每条 SQL 手动加条件
+- 级联删除必须在 Entity 层配置（如 @OneToMany(cascade = CascadeType.REMOVE)），禁止在 Service 层手动循环删除
 
-## 使用规则
-- 需求中出现上述条款时必须明确其在本项目中的具体实现语义
-- 不得假设"大家都懂"，必须在需求澄清阶段确认
-- 机械条款的选择属于裁决（团队决策），不属于需求事实
+## 例外情况
+- 日志明细、临时文件等可重建数据允许硬删除
+- 数据迁移期间可临时绕过乐观锁，但必须记录变更并事后审计
+- 性能敏感的批量操作（如定时任务清理）可绕过软删除全局过滤，但须显式声明
+
+## 关联模式
+- [[concurrency-control]] 并发控制实现模式
+- [[transaction-pattern]] 事务与补偿模式
+- crud-operation

package/templates/knowledge/procedures//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md

@@ -1,7 +1,7 @@
 ---
 name: hotfix-pipeline
 type: pipeline_procedure
-when: "线上故障紧急修复, 生产事故处理, P0紧急修复, 线上报错紧急处理, hotfix"
+when: "紧急修复管线, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, 线上故障管线"
 scope: [backend, frontend]
 products: ["*"]
 ---

package/templates/knowledge/procedures//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/347/250/213.md

@@ -1,7 +1,7 @@
 ---
 name: hotfix-procedure
 type: procedure
-when: 紧急修复, hotfix, 线上问题修复, 生产事故, 线上报错, 紧急上线, 线上故障, P0, P1, 事故修复
+when: 紧急修复, hotfix, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血
 scope: [backend, frontend]
 products: ["*"]
 ---

package/templates/knowledge/review_rules//345/271/266/345/217/221/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -8,7 +8,7 @@ products: ["*"]
 
 ## CON-01: 共享可变状态无并发保护
 pattern: "synchronized|ReentrantLock|AtomicInteger|volatile"
-severity: warning
+severity: critical
 scope: backend
 description: 涉及金额、库存、计数器的操作必须显式声明并发控制策略。若未使用任何并发控制原语，标记为需人工确认
 

package/templates/knowledge/review_rules//346/200/247/350/203/275/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -8,7 +8,7 @@ products: ["*"]
 
 ## PER-01: 循环内逐条数据库调用（N+1 问题）
 pattern: /(?:for|while)\s*\(.*\)[\s\S]*?\.(?:save|insert|update|delete|query|select|findBy)\s*\(/
-severity: warning
+severity: critical
 scope: backend
 description: 循环内禁止逐条数据库操作，必须使用批量 SQL 或 IN 查询
 

package/templates/knowledge/review_rules//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -20,7 +20,7 @@ description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = E
 
 ## API-03: 接口缺少权限注解
 pattern: "@(PostMapping|PutMapping|DeleteMapping)"
-severity: warning
+severity: critical
 scope: backend
 description: 写接口必须有 @PreAuthorize 或 @Secured 注解，禁止裸露写操作
 

package/templates/knowledge/review_rules//346/236/266/346/236/204/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -20,7 +20,7 @@ description: Controller 返回类型禁止使用 Entity，必须通过 DTO/VO
 
 ## ARC-03: 缺少 @Transactional 注解的写操作
 pattern: /public\s+\w+\s+(?:save|create|update|delete|insert|remove)\w*\s*\(/
-severity: warning
+severity: critical
 scope: backend
 description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
 

package/templates/knowledge/review_rules//350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -32,7 +32,7 @@ description: 服务地址禁止硬编码，必须使用环境变量或配置文
 
 ## QUA-05: catch 块吞掉异常不处理
 pattern: /catch\s*\([^)]*\)\s*\{\s*\}/
-severity: warning
+severity: critical
 scope: [backend, frontend]
 description: 空的 catch 块会隐藏错误，至少需要记录日志或明确注释忽略原因