|
|
ae74b4752a
|
feat(iot): B3 RuleEngine 执行器（DAG + 链级隔离 + 三层匹配去重）
rule 模块 engine/ 新增 14 个核心类 + 4 个测试：
- RuleEngine / DefaultRuleEngine：对外入口，链级 try-catch 隔离（决议 #3）
- DagExecutor：BFS 遍历，按 relation_type 选 outgoing links，RuntimeException 转 FAILURE
- ChainIndex：三层绑定（subsystem/product/device）4 种 key 匹配 + LinkedHashMap 去重 + priority ASC 排序
- RuleChainCompiler：DO → CompiledRuleChain，含单 Trigger + DAG 无环 + 非法枚举兜底
- NodeProvider / NodeProviderRegistry：SPI + Spring @Component 路由（禁用 ServiceLoader/@SPI）
- RuleContext / NodeResult / CompiledRuleChain/Node/Link / RuleEngineResult / RuleChainException
测试覆盖（42/42 全绿）：
- DagExecutorTest: 线性链 / 分支（TRUE/FALSE）/ 并行动作 / 异常转 FAILURE / metadata 传递 / SKIP 截断 / 缺 Trigger
- ChainIndexTest: 4 种 wildcard 组合 / 去重 / priority 排序 / 租户隔离 / evict
- RuleChainCompilerTest: 正常编译 / 单 Trigger 兜底 / DAG 无环 / 非法 category & relation_type / 连线 sortOrder
- DefaultRuleEngineTest: 链级异常隔离（chain1+chain3 成功，chain2 失败，counters 各 1 次）
补齐依赖：
- rule/pom.xml 加 io.micrometer:micrometer-core（节点执行 Timer + 失败 Counter）
- RuleNodeCategory 加 of(String) 静态查找方法（配合 RuleLinkRelationType.of 一致风格）
Known Pitfalls 落地：
⚠️ 评审 B1：ShakeLimit 节点 hook 留在 DagExecutor（B48 补）
⚠️ 评审 B3：LinkedHashMap 去重保留顺序（ChainIndex.match）
⚠️ 评审 B4：relation_type 严格封闭 6 值（RuleLinkRelationType + isValid）
⚠️ 评审 A5：chains 顺序 for 循环 + try-catch；不使用 Reactor flatMap 并发
⚠️ 评审 B10：单 Trigger 兜底在 Compiler 层（Service 层 + Compiler 双重保障）
⚠️ Metrics 基数：tag 含 chainId + nodeType + outcome；规则链 ≤ 500 控制
⚠️ DAG 兜底 MAX_NODES_PER_EXECUTION=1000 防脏数据绕过无环校验
未实现（留给后续任务）：
- 具体 Provider（B4/B5/B6 Trigger/Condition/Action 实现）
- 全量缓存加载 + Pub/Sub 驱逐（B8）
- JMH Benchmark（任务卡 §6.4 + AC9 p99 < 50ms，第二期补）
- @SpringBootTest 集成测试（B9 Handler 就位后补）
Co-Authored-By: Claude Opus 4.7 (1M context, main session) <noreply@anthropic.com>
|
2026-04-23 23:58:48 +08:00 |
|
|
|
962e69290b
|
feat(iot): B2 RuleChain/Node/Link 数据模型 + CRUD（单 Trigger/DAG 无环/乐观锁）
- 新增 sql/iot/V2.0.1__iot_rule_chain.sql（iot_rule_chain/node/link 三表 + idx_binding 索引）
- 新增 rule 模块 dal/（3 个 DO + 4 个封闭枚举 + 3 个 Mapper）
- 新增 rule 模块 service/（CRUD + 单 Trigger 校验 + DAG DFS 无环 + 乐观锁 + 级联软删）
- 新增 rule 模块 controller/admin/（7 REST 端点 + @PreAuthorize + VO）
- 新增 resources/mapper/rule/（3 个 MyBatis XML）
- api 模块 ErrorCodeConstants 新增规则链段（1-050-030-xxx）
- **补 B1 遗漏依赖**：rule/pom.xml 追加 viewsh-spring-boot-starter-{web,security,biz-tenant}
- 测试：8 个单元用例全绿（BaseMockitoUnitTest）
- Known Pitfalls 落地：
⚠️ 评审 B4：relation_type VARCHAR + 应用层 RuleLinkRelationType.isValid 校验
⚠️ 评审 B9：updateWithVersion 乐观锁原子 SQL + idx_update_time 索引支撑 B9 拉模式兜底扫描
⚠️ 评审 B10：单 Trigger 校验在 Service 层（validateSingleTrigger）
⚠️ 评审 A4：name UK（name, tenant_id, deleted）
⚠️ 评审 §十一-B：idx_binding (tenant_id, subsystem_id, product_id, device_id) 最左匹配
Co-Authored-By: Claude Sonnet (B2 subagent) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context, orchestrator) <noreply@anthropic.com>
|
2026-04-23 21:09:54 +08:00 |
|
