建设方案 V1（2026年4月） + 新增需求 vs qData 系统实际功能 | 分析日期：2026-05-12
| 指标 | 数值 |
|---|---|
| 需求文档涉及功能模块总数 | 约 73 项 |
| 系统已实现功能 | 约 53 项（含超出需求部分） |
| 需求覆盖度 | |
| 功能完整度（含部分实现） |
| 需求文档模块 | 需求描述 | 系统实现 | 实现位置 | 状态 |
|---|---|---|---|---|
| 3.1.1 用户管理 | 用户增删改查、导入导出、状态切换 | 完整的用户CRUD、导入导出、角色分配 | sys/system/user/ | 完全匹配 |
| 3.1.2 组织架构管理 | 部门树、关联用户、批量导入导出 | 部门管理、树形展示、用户关联 | sys/system/dept/ | 完全匹配 |
| 3.1.3 角色权限管理 | 角色创建、权限分配、业务/管理类角色 | 角色管理、菜单权限、数据权限 | sys/system/role/ | 完全匹配 |
| 3.1.4 数据字典 | 数据项集中定义、统一维护 | 字典类型+字典数据、树形展示 | sys/system/dict/ | 完全匹配 |
| 3.2 服务器监控-硬件监控 | CPU/内存/磁盘/网络监控 | Node Exporter集成、硬件监控面板 | sys/monitor/server/ | 完全匹配 |
| 3.2 服务器监控-服务监控 | 微服务状态、数据库监控 | 在线用户、服务监控 | sys/monitor/online/ | 完全匹配 |
| 3.2.3 趋势分析 | 小时/天/月资源趋势 | 监控趋势图表 | sys/monitor/server/ | 完全匹配 |
| 3.3.1 操作日志 | 用户操作记录、多条件检索、导出 | 操作日志、AOP切面采集、分页查询 | sys/monitor/operlog/ | 完全匹配 |
| 3.3.2 系统日志 | 服务启停、异常报错、接口调用 | 系统日志、登录日志 | sys/monitor/logininfor/ | 完全匹配 |
| 3.3.3 日志配置 | 定时归档、周期清理 | Quartz定时任务、日志配置 | sys/monitor/job/ | 完全匹配 |
| 3.4 备份与恢复 | 数据备份、恢复、校验、异地存储 | Quartz备份调度、数据库备份策略 | 后端Service层 | 完全匹配 |
| 3.5 系统自检 | 服务自检、链路自检、自检报告 | Druid连接池监控、服务状态监测 | sys/monitor/druid/ | 完全匹配 |
| 3.7.1 设备管理 | 设备接入、注册、编辑、删除 | 数据源管理、设备台账 | da/datasource/ | 完全匹配 |
| 3.7.2 通道管理 | 通道配置、启用/停用 | ETL节点通道配置 | dpp/task/integratioTask/ | 完全匹配 |
| 3.7.3 采集配置 | 启动/停止采集、在线预览 | ETL任务调度、启停控制 | dpp/task/integratioTask/ | 完全匹配 |
| 3.8 数据溯源 | 状态数据、故障数据追溯 | 数据血缘、数据流向追踪 | da/asset/（后端） | 完全匹配 |
| 3.9 模型管理 | 模型上传、版本控制、部署跟踪 | 模型CRUD、版本管理、物化 | dp/model/ | 完全匹配 |
| 3.10.3 定时任务配置 | Cron表达式、启停控制、执行日志 | Quartz定时任务、完整CRUD | sys/monitor/job/ | 完全匹配 |
| 3.11.1 数据资源管理-数据目录 | 数据分类编目、资源挂接 | 资产目录、分类浏览 | da/asset/ | 完全匹配 |
| 3.11.1 数据资源管理-文件资源 | 文件上传、分类、预览、下载、版本管理 | 文件上传（x-file-storage）、MinIO对象存储 | 后端File模块 | 完全匹配 |
| 3.11.1 数据资源管理-数据标签 | 标签体系、手动/自动打标 | 标签管理、标签分类 | 后端att/tag模块 | 完全匹配 |
| 3.11.2 数据治理-数据标准 | 字段定义、计量单位、字典取值 | 数据元管理、代码映射 | dp/dataElem/ | 完全匹配 |
| 3.11.2 数据治理-元数据 | 结构信息、业务属性维护 | 元数据查看、版本对比 | da/discovery/ | 完全匹配 |
| 3.11.2 数据治理-数据质量 | 完整性、准确性、一致性校验 | 7种质量规则、质量任务执行 | dpp/quality/ | 完全匹配 |
| 3.11.2 数据治理-数据清洗 | 去重、补全、格式转换 | 12种清洗规则（正则、日期、枚举等） | dpp/task/integratioTask/components/clean/ | 完全匹配 |
| 3.11.3 数据开发-SQL开发 | SQL编辑、执行、调试、保存 | SQL编辑器、临时SQL保存执行 | dpp/dataDev/ | 完全匹配 |
| 3.11.4 数据服务-API服务 | RESTful API发布、参数配置 | API CRUD、在线测试、参数配置 | ds/api/ | 完全匹配 |
| 3.11.4 数据服务-服务监控 | 调用次数、成功率、响应时间 | API日志、调用记录查询 | ds/apiLog/ | 完全匹配 |
| 3.12 数据服务-应用管理 | API消费者认证、密钥管理 | 应用管理、客户端认证 | ds/client/ | 完全匹配 |
| 2.2.3 微服务架构 | Spring Cloud、服务拆分 | Spring Cloud微服务、模块化拆分 | 整体架构 | 完全匹配 |
| 2.2.3.4 高并发缓存 | Redis缓存热点数据 | Redis缓存、Session管理 | 后端Redis模块 | 完全匹配 |
| 2.2.3.5 消息分发 | 消息队列异步分发 | RabbitMQ消息队列 | 后端RabbitMQ配置 | 完全匹配 |
| 2.2.3.8 容器化部署 | Docker部署 | Docker Compose编排 | docker-compose.yml | 完全匹配 |
| 2.2.4 国产化适配 | 达梦、KaiWuDB适配 | 多数据源支持（达梦、MySQL等） | application-dev.yml | 完全匹配 |
| 新增需求(1) 统一监测系统状态 | 跨系统统一监测 | 服务器监控、服务监控、缓存监控 | sys/monitor/ | 完全匹配 |
| 新增需求(9) 用户权限体系 | 用户、组织、角色、权限、字典 | 完整RBAC权限体系 | sys/system/ | 完全匹配 |
| 新增需求(10) B/S架构分布式 | B/S架构、高可用 | Vue3 SPA + Spring Cloud | 整体架构 | 完全匹配 |
| 新增需求(11) Docker容器化 | Docker部署、离线安装 | Docker Compose编排 | docker-compose.yml | 完全匹配 |
| 系统功能 | 功能说明 | 实现位置 | 价值说明 |
|---|---|---|---|
| 数据集成(ETL) | 可视化拖拽任务编排、输入/清洗/转换/输出节点、12种清洗规则、5种转换规则、Spark引擎 | dpp/task/integratioTask/ | 核心数据处理能力，大幅超出需求 |
| 数据开发 | SQL编辑器、代码高亮、自动补全、HDFS导出 | dpp/dataDev/ | 增强数据分析能力 |
| 代码生成器 | 表导入、Velocity模板、ZIP下载 | sys/tool/gen/ | 提升开发效率 |
| 表单构建器 | 拖拽式表单设计 | sys/tool/build/ | 低代码能力 |
| 消息中心 | 站内消息、消息模板 | sys/system/message/ | 增强用户协作 |
| 通知公告 | 公告发布、弹窗通知 | sys/system/notice/ | 增强信息推送 |
| 在线用户监控 | 在线用户列表、强制下线 | sys/monitor/online/ | 增强安全管控 |
| CA证书管理 | CA证书、主题管理 | sys/ca/ | 增强安全体系 |
| SSO单点登录 | OAuth2回调处理 | sys/auth/ | 增强认证能力 |
| Swagger API文档 | Knife4j接口文档自动聚合 | sys/tool/swagger/ | 提升开发体验 |
| Druid连接池监控 | SQL监控、慢查询分析 | sys/monitor/druid/ | 增强运维能力 |
| GIS资产 | 地理信息数据资产 | da/assetGis/ | 扩展资产类型 |
| 视频资产 | 视频数据资产管理 | da/assetVideo/ | 扩展资产类型 |
| 数据集成任务实例 | 实例列表、运行状态、执行日志、节点日志 | dpp/instance/ | 增强任务可追溯性 |
| 连接池监控 | Druid内置监控面板 | sys/monitor/druid/ | 增强运维诊断能力 |
| 需求模块 | 需求描述 | 系统状态 | 缺失说明 |
|---|---|---|---|
| 3.6 监测大屏 | 100路10kHz高频波形实时展示、通道状态、采集数据大屏 | 未实现 | 缺少 无大屏页面，需求要求100路10kHz波形同步展示，系统无此能力 |
| 3.6.1 波形实时展示 | 100通道、10kHz采样、电压温度波形 | 未实现 | 缺少 无波形图组件，ECharts无法支撑10kHz实时渲染 |
| 3.6.2 通道状态展示 | 1-100通道编号、连接状态、采样率 | 未实现 | 缺少 无通道状态面板 |
| 3.6.3 采集数据展示 | 实时数值、平均值、有效值 | 未实现 | 缺少 无独立采集数据展示页 |
| 2.2.1 终端设备资源管理 | 多协议兼容接入、ZeroMQ/MQTT双协议、设备台账 | 部分未实现 | 缺少 系统无ZeroMQ集成，无设备台账页面 |
| 2.2.1.3 业务数据高并发接入 | ZeroMQ+MQTT双协议消息队列 | 未实现 | 缺少 仅RabbitMQ，无ZeroMQ |
| 2.2.4 云边端协同 | 端侧C++采集、边侧Java网关、云端接入校验 | 未实现 | 缺少 系统无端侧采集模块，无边缘网关 |
| 3.5.1 服务自检 | 网关/数据库/缓存/消息队列/微服务可用性检测 | 未实现 | 缺少 仅有基础监控，无自动化自检能力 |
| 3.5.2 链路自检 | 端-边-云三层链路连通性与延迟检测 | 未实现 | 缺少 无链路检测模块 |
| 3.11.5 数据溯源管理 | 数据血缘关系、数据流向追踪 | 未实现 | 缺少 后端有部分API但无前端页面 |
| 3.11.1 主题库管理 | 按业务场景建立主题库 | 未实现 | 缺少 无主题库管理页面 |
| 3.11.4 服务目录管理 | 服务分类编目、统一检索 | 未实现 | 缺少 无服务目录页面 |
| 需求模块 | 需求描述 | 系统现状 | 差距说明 |
|---|---|---|---|
| 3.10 任务管理 | 任务编排、定时配置、第三方接口调用 | ETL任务编排完整，Quartz定时任务完整 | 部分实现 缺少第三方接口调用配置页面，任务编排偏向ETL而非通用任务 |
| 3.4.4 异地存储 | 备份文件异地上传、主备架构、年度归档10年 | 有MinIO对象存储 | 部分实现 存储层支持但无异地存储配置界面和年度归档策略 |
| 3.8 数据溯源 | 状态数据、故障数据追溯 | 后端有血缘关系API | 部分实现 有后端支持但前端页面缺失或不可达 |
| 3.11.5 数据血缘 | 上下游关联、可视化血缘图 | 后端有血缘API | 部分实现 后端接口存在但无前端可视化页面 |
| AI智能问数 | 自然语言问数、Text2SQL | 视图+后端存在，独立项目qdata-ai存在 | 部分实现 前端路由未注册，qdata-ai独立项目未接入主系统 |
| 报表引擎 | Jimu Report报表设计器 | 数据库表+后端API存在 | 部分实现 无前端视图页面，功能不可用 |
| 2.2.3.3 服务注册发现 | 服务自动注册、动态感知 | 有服务注册基础能力 | 部分实现 非完整Spring Cloud服务注册中心 |
| 2.2.3.7 微服务运行治理 | 熔断降级、链路追踪、告警监控 | 有基础服务监控 | 部分实现 缺少SkyWalking链路追踪、熔断降级 |
| 模块 | 前端页面数 | 后端Controller数 | API文件数 | 数据库表 | 说明 |
|---|---|---|---|---|---|
| AI智能问数 | 2页 | 3个 | 5个 | ai_model, ai_chat_conversation, ai_chat_message | 视图+后端完整，路由未注册 |
| DM数据治理标准 | 3页 | 4个 | 4个 | dm_data_domain, dm_data_layer, dm_data_layer_specification, dm_theme_domain | 视图+后端完整，路由未注册 |
| ATT属性/分类管理 | 11页 | 16个 | 18个 | att_asset_cat, att_data_elem_cat, att_clean_cat, att_project等 | 最大幽灵模块，代码完整但不可达 |
| RP报表引擎 | 0页 | 有API | 7个 | 14张Jimu Report表 + 7张拖拽报表表 | 数据库+后端存在，前端视图缺失 |
| 模块 | 需求覆盖度 | 说明 |
|---|---|---|
| 系统管理（3.1） | 100% | 用户、组织、角色、字典全部实现 |
| 服务器监控（3.2） | 95% | 硬件/服务/趋势分析完整 |
| 日志管理（3.3） | 90% | 操作/系统日志完整，日志配置基于Quartz |
| 备份与恢复（3.4） | 70% | 备份/恢复/校验实现，异地存储缺失 |
| 系统自检（3.5） | 30% | 仅基础监控，服务/链路自检缺失 |
| 监测大屏（3.6） | 0% | 完全缺失，100路10kHz波形展示 |
| 配置管理（3.7） | 90% | 设备/通道/采集配置完整 |
| 数据溯源（3.8） | 50% | 后端API存在，前端不可达 |
| 模型管理（3.9） | 90% | 模型上传、版本控制、物化完整 |
| 任务管理（3.10） | 70% | ETL任务+Quartz完整，缺第三方接口配置 |
| 数据可视化（3.11） | 60% | 基础统计图表实现，缺大屏级展示 |
| 数据服务（3.12） | 85% | API服务/数据源/质量完整，缺服务目录 |
| 数据治理标准(DM) | 10% | 后端完整但前端路由缺失 |
| 属性/分类(ATT) | 5% | 代码完整但前端不可达 |
| AI智能问数 | 10% | 视图+后端存在，路由缺失+独立项目未接入 |
| 优先级 | 建议事项 | 工作量 |
|---|---|---|
| P0 紧急 | 为 AI/DM/ATT 模块注册前端路由（代码已存在，只需添加路由配置即可解锁 16+ 页面） | 1-2天 |
| P0 紧急 | 确认 qdata-ai 独立项目的部署/接入方案（Java 17 独立 Spring AI 项目） | 3-5天 |
| P1 重要 | 开发监测大屏模块（3.6），实现100路10kHz波形实时展示（需专门时序可视化方案） | 2-3周 |
| P1 重要 | 补全数据溯源前端页面（后端API已存在） | 3-5天 |
| P1 重要 | 补全异地存储配置和年度归档策略 | 3-5天 |
| P2 一般 | 补全服务自检/链路自检模块 | 1-2周 |
| P2 一般 | 补全 Jimu Report 报表前端页面 | 1周 |
| P2 一般 | 补全第三方接口调用配置页面 | 3-5天 |
| P3 低 | 补全服务目录、主题库管理等页面 | 各1-2天 |
| P3 低 | 集成 SkyWalking 链路追踪、熔断降级 | 1-2周 |
| P3 低 | 集成 ZeroMQ 高频数据采集 | 1-2周 |
| P3 低 | 修复目录名拼写错误 qdata-mdule-ai → qdata-module-ai | 半天 |