XW-AIOT/aiot-platform-cloud
4
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
525 Commits 5 Branches 0 Tags
1f87d599c0ded6d7cc929f8457380b531ae027e0
Commit Graph

5 Commits

Author SHA1 Message Date
lzh
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
lzh
66647e19dd feat(iot): B19 规则引擎 v1/v2/hybrid 版本解析器 + 管理 API 
- config/RuleEngineVersion.java（三态枚举 V1/V2/HYBRID）
- config/RuleEngineVersionProperties.java（@ConfigurationProperties, prefix=viewsh.iot.rule.engine）
- config/IotRuleEngineVersionResolver.java（volatile Set 本地缓存 < 1μs + Redis 动态白名单 + 降级）
- config/RuleEngineVersionAdminController.java（5 端点：add/remove/list/version/refresh，@PreAuthorize）
- config/IotRuleEngineVersionAutoConfiguration.java（@AutoConfiguration + @EnableConfigurationProperties）
- spring.factories 注册 AutoConfiguration
- 测试：IotRuleEngineVersionResolverTest 8 用例全绿（含 Redis 降级 + 动态刷新）
- Known Pitfalls 落地：
  ⚠️ 评审 B11：三态枚举 + switch 全覆盖
  ⚠️ 性能：volatile + Set.contains，无 I/O
  ⚠️ Redis 降级：try-catch + log.warn，不抛出
  ⚠️ subsystemId=null 走 v1（存量未归属设备安全默认）

Co-Authored-By: Claude Sonnet (B19 subagent) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context, orchestrator) <noreply@anthropic.com>
 2026-04-23 23:40:25 +08:00
lzh
48e605b3c9 fix(iot): 恢复 B2 Controller/VO 的 @PreAuthorize/@Schema/@Valid 注解 
Wave 2 三个 subagent 并行时，B19 subagent 看不到主会话后补的
rule/pom.xml web/security 依赖，把 B2 已写的注解全注释掉作为编译兜底。
rule/pom.xml 现已含 web/security/biz-tenant starter，恢复注解。

- IotRuleChainController: 7 @PreAuthorize + @Tag + 7 @Operation + @Parameter + @Valid + @Validated
- IotRuleChainSaveReqVO: @Schema + @NotEmpty/@NotNull/@Valid（含 NodeVO/LinkVO 子 VO）
- IotRuleChainRespVO: @Schema
- IotRuleChainGraphVO: @Schema（含子类）
- IotRuleChainPageReqVO: @Schema

落地 B2 AC9（REST API 所有端点带权限校验）。
测试：mvn test -pl viewsh-module-iot/viewsh-module-iot-rule → 17/17 全绿

Co-Authored-By: Claude Sonnet (annotation-restore subagent) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context, orchestrator) <noreply@anthropic.com>
 2026-04-23 23:39:26 +08:00
lzh
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
lzh
4614737d51 feat(iot): B1 新建 viewsh-module-iot-rule Maven 模块骨架 
- 新增 viewsh-module-iot-rule/pom.xml（仅依赖 iot-api + iot-core + Aviator 5.3.3 + mybatis/redis starter）
- 新增 package-info.java / ModuleSmokeTest.java / spring.factories 占位
- viewsh-module-iot/pom.xml <modules> 新增 rule（core 之后、server 之前）
- viewsh-module-iot-server/pom.xml 新增 rule 依赖（core 之后、业务组件之前）
- Known Pitfalls 落地：
  ⚠️ 评审 A3：依赖方向 rule → core → api，严禁反向（dependency:tree 验证）
  ⚠️ 评审 R6：server 对 rule 的依赖按项目一贯顺序插入
  ⚠️ Aviator 5.3.3 首次引入，rule 模块 pom 内显式声明 version

Acceptance Criteria 全 8 项通过（见任务卡 Notes §8.2026-04-23 执行记录）

Co-Authored-By: Claude Sonnet (B1 subagent) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context, orchestrator) <noreply@anthropic.com>
 2026-04-23 20:50:31 +08:00