开发清单 — ActDenox 智能脱硝控制系统

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

Electron_Test/
│
│  ★ 编排层 — 纯编排器，只做 Import → Init → IPC → Window
│
├── main.js                           主进程入口（编排器，deps 注入）
│
│  ★ 安全桥接 — 唯一渲染进程通道
│
├── preload.js                        contextBridge API（110+ 通道）
│
│  ★ 全局常量
│
├── constants/
│   ├── constants.js                   全局常量 (MAX_INTERNAL_VARIABLES)
│   ├── licenseKey.js                  授权密钥单一来源
│   └── pidDefaults.js                 PID 默认配置模板（单一来源）
│
│  ★ core/ — 7 个自治微服务模块（从 main.js 深度解耦）
│
├── core/
│   ├── errorLogger.js                 全局异常捕获 + 进程退出快照 + 错误日志
│   ├── backupScheduler.js             每日数据备份 + 过期清理 + 数据库完整性周检
│   ├── dataPipeline.js                数据处理管线（解析→过滤→补偿→计算变量，自持状态）
│   ├── healthMetrics.js               系统健康指标采集（5s 周期，含 AI 状态）
│   ├── windowManager.js               BrowserWindow + 系统托盘 + 电源监控(休眠/唤醒)
│   ├── pollEngine.js                  后台轮询引擎（Modbus 周期读取→管线→自动保存→健康心跳）
│   └── pidOrchestrator.js             PID 编排器（多实例生命周期/无扰动切换/定时器看门狗）
│
│  ★ ipc/ — 7 个 IPC 注册模块（deps 注入，零直接耦合）
│
├── ipc/
│   ├── modbusIpc.js                   Modbus 主机/从机/后台轮询/自动保存
│   ├── pidIpc.js                      PID 实例管理 (增删/启停/配置/状态/图表)
│   ├── alarmIpc.js                    报警配置/规则/历史
│   ├── authIpc.js                     用户/授权/自登录/权限/审计
│   ├── dataIpc.js                     数据存储/映射/列管理
│   ├── variableIpc.js                 内部变量/计算变量/过滤器/补偿/字段名
│   └── systemIpc.js                   健康状态/配置备份/仪表盘布局/原生对话框/连接配置保存
│
│  ★ modules/ — 7 个业务逻辑模块（有状态 / 独立自治）
│
├── modules/
│   ├── modbusManage.js                Modbus 主机（连接/队列/诊断/重连，PID 退避已上移）
│   ├── modbusSlave.js                 Modbus 从机（RTU ServerSerial + TCP ServerTCP）
│   ├── pidController.js               PID 控制器类（位置式/抗饱和/微分先行/低通滤波）
│   ├── alarmManager.js                报警引擎（看门狗/阈值/延时/滞后/分级/历史）
│   ├── authManager.js                 用户管理（CRUD/权限矩阵/硬件指纹/授权/自登录/超时降级）
│   ├── aiInferenceEngine.js           AI 推理引擎（双定时器：采样+请求，失败退避+慢速探测恢复）
│   └── auditLogger.js                 操作审计日志
│
│  ★ services/ — 5 个服务模块（无状态 / 纯函数 / 全项目共享）
│
├── services/
│   ├── configManager.js               统一配置管理器（原子写入：tmp→copyFile→unlink）
│   ├── controlRouter.js               控制策略路由（源→目标变量复制）
│   ├── dataStore.js                   SQLite 数据存储（自动建列/聚合查询/列管理/健康）
│   ├── logger.js                      中央日志控制器
│   └── variableRegistry.js            变量元数据注册表（单例，category/description/unit/writable）
│
│  ★ utils/
│
├── utils/
│   └── modbusUtils.js                 Modbus 共享工具（CRC16/帧构建解析/字节重排/寄存器↔值转换）
│
│  ★ renderer/pages/ — 14 个渲染进程页面（contextIsolation, 无 nodeIntegration）
│
├── pages/
│   ├── dashboard.html + .js           仪表盘首页（12列自由布局/10种组件）
│   ├── dashboardWidgets.js            组件注册表（含报警摘要/补偿摘要/顶栏状态灯）
│   ├── modbus.html + modbusRender.js  Modbus 通讯管理（主/从，TCP Server）
│   ├── variables.html + .js           内部变量监控（含 AI 分类筛选）
│   ├── pid.html + .js                 PID 控制（多实例/无扰动/偏差带/健康灯）
│   ├── data.html + .js                数据保存与查询（保留策略/Excel 导出）
│   ├── trend.html + .js               历史趋势（多轴/聚合/缩放）
│   ├── filter.html + .js              数据过滤器（范围/速率/移动平均/尖峰）
│   ├── compensation.html + .js        仪表状态补偿（状态机/取变量值）
│   ├── alarm.html + .js               报警配置（看门狗/延时进度/历史查询）
│   ├── auth.html + .js                用户管理（权限矩阵/审计/自登录/超时/丰富授权信息）
│   ├── aiControl.html + .js           AI 优化控制
│   ├── mapping.html + .js             字段映射
│   ├── sysTools.html + .js            系统工具
│   ├── chartPopout.html               PID 趋势弹出窗
│   ├── trendPopout.html               历史趋势弹出窗
│   ├── components.css                 共享组件样式（按钮/表格/卡片/徽章）
│   ├── theme-industrial.css           工业控制台主题（冷灰/微圆角/强语义色）
│   ├── layout-shell.css               侧边栏+顶条三区 CSS Grid 布局
│   ├── layout-shell.js                Shell 注入引擎（替代旧 layout.js）
│   └── authGuard.js                   权限守卫（查权限矩阵 + 返回仪表盘按钮）
│
├── build-obfuscate.js                 构建混淆脚本
├── generateLicense.js                 离线授权码生成工具（开发环境，不打包）
├── package.json                       (含 electron-builder NSIS 配置)
├── nodemon.json                       开发热重启配置
├── icon.png                           应用图标
├── data/                              运行时数据 (安装后在 %APPDATA%)
├── 开发清单.md                         本文档
└── 操作手册说明.md                     运维操作手册

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

main.js (编排器)
  │
  ├─→ core/errorLogger        ← 全局异常 + 退出快照
  ├─→ core/backupScheduler    ← 定时备份/清理
  ├─→ core/dataPipeline       ← 自持: 过滤器配置/补偿配置/计算变量
  ├─→ core/healthMetrics      ← 读取各模块状态 → _sys_* 变量（含 AI）
  ├─→ core/windowManager      ← 窗口/托盘/电源
  ├─→ core/pollEngine         ← 注入: modbus, dataStore, onDataRefresh
  └─→ core/pidOrchestrator    ← 注入: pidInstances, modbus, onLatestItems

数据流:  Modbus设备 → pollEngine → dataPipeline → internalVariables → pidOrchestrator
                                                                         ↓
                         DCS/PLC ← modbusSlave ←─────────────────────────┘