plan.md

通用规则引擎研发计划 V1.0

一、项目概述

1.1 项目目标

构建一个通用的规则引擎平台，支持传染病报卡、处方审核、病案质控等多个医疗业务场景，通过可视化界面配置规则，实现业务规则的灵活管理和高效执行。

1.2 技术栈

前端: Vue 3.x + Element Plus + Query Builder
后端: Spring Boot 2.7.14 + JDK 11 + MyBatis-Plus + Drools
数据库: MySQL 8.0+
其他: Redis（缓存）、Maven（构建工具）

1.3 项目周期

预计总工期：12周（3个月）

二、项目阶段规划

第一阶段：需求分析与架构设计（第1-2周）

2.1 需求确认与细化

时间: 第1周 负责人: 产品经理 + 技术负责人

任务清单:

与业务方确认传染病报卡规则的详细需求
梳理处方审核、病案质控等其他业务场景需求
确认规则引擎的通用能力边界
整理字段元数据清单（诊断、检验、检查、手术等）
确认操作符支持范围（包含、不包含、大于、小于、between等）
明确权限控制需求
输出《需求规格说明书》

2.2 架构设计

时间: 第2周 负责人: 架构师 + 技术负责人

任务清单:

第二阶段：基础环境搭建（第2周）

2.3 开发环境准备

时间: 第2周 负责人: 运维工程师 + 后端开发

任务清单:

搭建开发环境（MySQL、Redis）
配置代码仓库（Git）
搭建CI/CD流水线
创建Spring Boot项目骨架
创建Vue 3项目骨架
配置MyBatis-Plus代码生成器
配置Drools依赖
配置Element Plus和相关组件
编写项目README和开发文档

第三阶段：数据库与后端核心开发（第3-6周）

2.4 数据库实施

时间: 第3周 负责人: 数据库工程师 + 后端开发

任务清单:

2.5 后端核心接口开发

时间: 第3-4周 负责人: 后端技术负责人

任务清单:

2.6 后端业务适配器开发

时间: 第5周 负责人: 后端开发工程师

任务清单:

2.7 后端API开发

时间: 第5-6周 负责人: 后端开发工程师

任务清单:

第四阶段：前端开发（第6-9周）

2.8 前端基础组件开发

时间: 第6周 负责人: 前端技术负责人

任务清单:

2.9 规则配置页面开发（核心）

时间: 第7-8周 负责人: 前端开发工程师

任务清单:

2.10 其他管理页面开发

时间: 第8-9周 负责人: 前端开发工程师

任务清单:

2.11 前端API对接与联调

时间: 第9周 负责人: 前端开发 + 后端开发

任务清单:

封装API接口调用方法
实现请求拦截器（添加token）
实现响应拦截器（统一错误处理）
前后端联调测试
修复联调问题
优化用户体验

第五阶段：规则转换与Drools集成（第9-10周）

2.12 规则转换引擎开发

时间: 第9-10周 负责人: 后端技术负责人

任务清单:

第六阶段：业务场景实现与测试（第10-11周）

2.13 传染病报卡场景实现

时间: 第10周 负责人: 后端开发 + 前端开发

任务清单:

2.14 处方审核场景实现

时间: 第10周 负责人: 后端开发 + 前端开发

任务清单:

2.15 病案质控场景实现

时间: 第10周 负责人: 后端开发 + 前端开发

任务清单:

2.16 系统集成测试

时间: 第11周 负责人: 测试工程师 + 开发团队

任务清单:

第七阶段：优化与上线准备（第11-12周）

2.17 系统优化

时间: 第11周 负责人: 开发团队

任务清单:

2.18 文档编写

时间: 第11-12周 负责人: 全体团队

任务清单:

2.19 部署上线

时间: 第12周 负责人: 运维工程师 + 开发团队

任务清单:

三、团队配置与职责

3.1 人员配置

角色	人数	主要职责
产品经理	1	需求管理、产品设计、验收测试
架构师	1	架构设计、技术选型、技术攻关
后端开发（Java）	2-3	后端服务开发、API开发、Drools集成
前端开发（Vue）	2	前端页面开发、Query Builder组件开发
测试工程师	1-2	测试用例编写、功能测试、性能测试
运维工程师	1	环境搭建、部署上线、监控运维
合计	8-10人

3.2 关键角色职责

产品经理

负责需求分析和产品设计
组织需求评审和产品验收
协调业务方沟通
跟踪项目进度

架构师/技术负责人

负责系统架构设计
制定技术方案和开发规范
解决技术难点
代码审查和质量把控
核心模块开发（规则引擎、编译器）

后端开发工程师

实现规则引擎核心功能
开发业务适配器
实现API接口
编写单元测试
性能优化

前端开发工程师

实现规则配置界面
开发Query Builder组件
实现规则列表、日志查询等管理页面
前后端联调
用户体验优化

测试工程师

编写测试用例
执行功能测试、集成测试
执行性能测试、压力测试
问题跟踪和回归测试
输出测试报告

运维工程师

搭建开发、测试、生产环境
配置CI/CD流水线
应用部署和监控
数据库维护
故障处理

四、关键技术难点与解决方案

4.1 Query Builder与Drools DRL转换

难点:

前端可视化配置转换为Drools规则语言
支持复杂的AND/OR嵌套逻辑
多种操作符的准确转换

解决方案:

设计JSON中间格式，前端生成JSON，后端解析
实现递归算法处理嵌套条件组
建立操作符映射表，覆盖所有场景
充分的单元测试保证转换正确性

4.2 规则缓存与动态更新

难点:

规则修改后需要重新编译
保证缓存一致性
不影响正在执行的规则

解决方案:

使用KieBase缓存已编译的规则
规则更新时通知所有节点重载
使用版本号机制，新规则不影响旧会话
提供手动刷新缓存接口

4.3 多业务场景解耦

难点:

不同业务场景数据结构差异大
业务逻辑各不相同
保持规则引擎的通用性

解决方案:

使用适配器模式
定义统一的数据接口（Map结构）
业务适配器负责数据转换
通过元数据配置实现灵活扩展

4.4 性能优化

难点:

大量规则执行性能
复杂规则编译耗时
高并发场景响应时间

解决方案:

规则预编译和缓存
使用无状态会话（Stateless Session）
合理设计规则优先级（salience）
批量执行使用并行流
添加Redis缓存热点数据
数据库读写分离

五、里程碑与交付物

阶段	时间节点	里程碑	主要交付物
第一阶段	第2周末	需求与架构设计完成	需求规格说明书、架构设计文档、数据库设计文档、接口设计文档
第二阶段	第2周末	开发环境就绪	项目骨架、开发环境、CI/CD流水线
第三阶段	第6周末	后端核心功能完成	规则引擎核心代码、业务适配器、API接口、单元测试
第四阶段	第9周末	前端功能完成	规则配置页面、Query Builder组件、管理页面
第五阶段	第10周末	规则转换集成完成	JSON to DRL转换器、规则验证器、测试用例
第六阶段	第11周末	业务场景实现与测试完成	三个业务场景实现、测试报告
第七阶段	第12周末	系统上线	优化后的系统、用户手册、运维文档、生产环境部署

六、风险管理

6.1 技术风险

风险	概率	影响	应对措施
Drools学习曲线陡峭	中	高	提前技术预研，组织技术培训
Query Builder组件复杂度高	中	高	调研开源组件（vue-query-builder），或降低复杂度
规则转换逻辑复杂	高	高	充分的技术方案设计，增加测试覆盖
性能不达标	中	中	性能测试前置，预留优化时间

6.2 需求风险

风险	概率	影响	应对措施
需求变更频繁	高	中	需求评审严格把关，控制需求变更
业务规则复杂度超预期	中	高	分阶段实现，先简单后复杂
用户体验不满意	中	中	原型评审，及时收集反馈

6.3 进度风险

风险	概率	影响	应对措施
人员不足	中	高	提前储备人力，关键岗位双人配置
关键人员离职	低	高	知识沉淀和文档化，代码审查制度
开发进度延期	中	中	每周进度跟踪，及时调整计划

七、质量保障措施

7.1 代码质量

代码审查（Code Review）机制
单元测试覆盖率≥80%
使用SonarQube进行代码扫描
遵循阿里巴巴Java开发规范
使用ESLint进行前端代码检查

7.2 测试质量

编写详细的测试用例
功能测试覆盖率100%
自动化测试覆盖核心功能
性能测试验证关键指标
安全测试（SQL注入、XSS等）

7.3 文档质量

API文档自动生成（Swagger）
关键代码必须有注释
每个模块必须有README
架构和设计文档及时更新
用户手册通俗易懂

八、后续规划（V2.0）

8.1 功能增强

支持决策表可视化配置
支持规则流（Rule Flow）配置
支持规则模板和规则库
支持规则导入导出（Excel）
支持规则A/B测试
支持规则效果评估

8.2 性能优化

分布式规则引擎集群
规则热加载（不重启应用）
规则执行结果缓存
异步规则执行

8.3 运维增强

九、附录

9.1 参考文档

Drools官方文档：https://docs.drools.org/
Vue 3官方文档：https://cn.vuejs.org/
Element Plus文档：https://element-plus.org/
Spring Boot文档：https://spring.io/projects/spring-boot
MyBatis-Plus文档：https://baomidou.com/

9.2 关键配置示例

示例1：传染病报卡规则JSON结构

{
  "ruleCode": "HIV_001",
  "ruleName": "艾滋病(HIV)报卡规则",
  "sceneCode": "INFECTIOUS_DISEASE_REPORT",
  "ruleType": "CONDITION",
  "priority": 100,
  "conditions": {
    "logic": "OR",
    "groups": [
      {
        "logic": "AND",
        "conditions": [
          {
            "field": "diagnosis_code",
            "operator": "IN",
            "value": ["B22.100", "B22.200", "B22.700", "B22.701", "B23.100", "B23.200"]
          }
        ]
      },
      {
        "logic": "AND",
        "conditions": [
          {
            "field": "diagnosis_name",
            "operator": "LEFT_MATCH",
            "value": "B20"
          }
        ]
      }
    ]
  },
  "actions": [
    {
      "actionType": "RETURN",
      "params": {
        "need_report": true,
        "disease_code": "HIV",
        "disease_name": "艾滋病"
      }
    }
  ]
}

示例2：生成的Drools DRL规则

package rules.infectious_disease;

import java.util.Map;
import com.ruleengine.core.RuleContext;
import com.ruleengine.core.RuleResult;

global RuleResult ruleResult;
global RuleContext context;

rule "HIV_001"
    salience 100
when
    $data : Map(
        this["diagnosis_code"] memberOf ["B22.100", "B22.200", "B22.700", "B22.701", "B23.100", "B23.200"]
        || this["diagnosis_name"].toString().startsWith("B20")
    )
then
    ruleResult.setMatched(true);
    ruleResult.getOutputData().put("need_report", true);
    ruleResult.getOutputData().put("disease_code", "HIV");
    ruleResult.getOutputData().put("disease_name", "艾滋病");
end

9.3 开发环境要求

JDK 11+
Node.js 16+
MySQL 8.0+
Redis 6.0+
Maven 3.6+
Git 2.0+
IDE: IntelliJ IDEA / VS Code

文档版本: V1.0 编写日期: 2025-01-08 最后更新: 2025-01-08 编写人: 研发团队 审核人: 技术负责人 / 产品经理

FilesExpand file tree

plan.md

Latest commit

History

plan.md

File metadata and controls

通用规则引擎研发计划 V1.0

一、项目概述

1.1 项目目标

1.2 技术栈

1.3 项目周期

二、项目阶段规划

第一阶段：需求分析与架构设计（第1-2周）

2.1 需求确认与细化

2.2 架构设计

第二阶段：基础环境搭建（第2周）

2.3 开发环境准备

第三阶段：数据库与后端核心开发（第3-6周）

2.4 数据库实施

2.5 后端核心接口开发

2.6 后端业务适配器开发

2.7 后端API开发

第四阶段：前端开发（第6-9周）

2.8 前端基础组件开发

2.9 规则配置页面开发（核心）

2.10 其他管理页面开发

2.11 前端API对接与联调

第五阶段：规则转换与Drools集成（第9-10周）

2.12 规则转换引擎开发

第六阶段：业务场景实现与测试（第10-11周）

2.13 传染病报卡场景实现

2.14 处方审核场景实现

2.15 病案质控场景实现

2.16 系统集成测试

第七阶段：优化与上线准备（第11-12周）

2.17 系统优化

2.18 文档编写

2.19 部署上线

三、团队配置与职责

3.1 人员配置

3.2 关键角色职责

产品经理

架构师/技术负责人

后端开发工程师

前端开发工程师

测试工程师

运维工程师

四、关键技术难点与解决方案

4.1 Query Builder与Drools DRL转换

4.2 规则缓存与动态更新

4.3 多业务场景解耦

4.4 性能优化

五、里程碑与交付物

六、风险管理

6.1 技术风险

6.2 需求风险

6.3 进度风险

七、质量保障措施

7.1 代码质量

7.2 测试质量

7.3 文档质量

八、后续规划（V2.0）

8.1 功能增强

8.2 性能优化

8.3 运维增强

九、附录

9.1 参考文档

9.2 关键配置示例

示例1：传染病报卡规则JSON结构

示例2：生成的Drools DRL规则

9.3 开发环境要求