# 需求文档 vs 系统实际功能 对比分析报告

建设方案 V1（2026年4月） + 新增需求 vs qData 系统实际功能 | 分析日期：2026-05-12

概
一、总体概览
匹配功能
38
需求已实现
超出需求
15
系统额外提供
部分实现
8
功能不完整
缺少功能
12
需求有但系统无

指标 | 数值
--- | ---
需求文档涉及功能模块总数 | 约 73 项
系统已实现功能 | 约 53 项（含超出需求部分）
需求覆盖度 | 52%
功能完整度（含部分实现） | 68%

✓
二、匹配功能（需求已实现）

需求文档模块 | 需求描述 | 系统实现 | 实现位置 | 状态
--- | --- | --- | --- | ---
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.6）是需求中缺失最多的模块，涉及100路10kHz高频波形展示，技术上需要专门的时序数据可视化方案，当前ECharts难以满足。
~
五、部分实现功能

需求模块 | 需求描述 | 系统现状 | 差距说明
--- | --- | --- | ---
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链路追踪、熔断降级

幽
六、幽灵模块（前后端代码完整但前端路由未注册）
以下模块代码完整、数据库表已创建、后端API已实现，但因前端路由未注册，用户无法在系统中看到这些功能。

模块 | 前端页面数 | 后端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张拖拽报表表 | 数据库+后端存在，前端视图缺失

建议：以上模块只需添加前端路由配置即可解锁，无需额外开发工作量。
总
七、总结与建议

#### 7.1 完成度评估

模块 | 需求覆盖度 | 说明
--- | --- | ---
系统管理（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% | 视图+后端存在，路由缺失+独立项目未接入

#### 7.2 优先级建议

优先级 | 建议事项 | 工作量
--- | --- | ---
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 | 半天

#### 7.3 关键发现

1. 幽灵模块问题突出：AI、DM、ATT 三大模块的前后端代码均已完整实现，仅因路由未注册导致 16+ 页面不可达。这是当前最大的"隐性功能资产"，只需添加路由配置即可立即解锁。
2. 监测大屏是最大缺口：需求文档中 3.6 章节的监测大屏（100路10kHz波形展示）在系统中完全缺失，这是需求文档中技术指标最明确、量化的部分，且涉及专门的时序数据可视化技术，当前 ECharts 无法满足 10kHz 实时渲染要求。
3. 系统超出需求的部分：数据集成（ETL）可视化编排、代码生成器、表单构建器、SSO单点登录、CA证书管理、消息中心等均为系统额外提供的能力，需求文档未提及，体现了系统的扩展性和前瞻性。
4. 端侧采集与云边端协同缺失：需求文档中的 C++ 高频采集、Java 低频采集、ZeroMQ 传输、边缘网关等端/边侧能力均未实现。当前系统聚焦云端数据服务平台，端侧和边侧需要额外建设。