bd7e93ae68
- RICS_readme.md: Rule information centralized display service - eqpm_readme.md: Equipment predictive maintenance & status monitoring - dsm_readme.md: Data save manager for historical data archiving - eqpalg_readme.md: Corrected architecture, data flow, variable system, thread model, and inter-process relationships
121 lines
5.6 KiB
Markdown
121 lines
5.6 KiB
Markdown
# RICS — 规则信息集中服务
|
||
|
||
## 概述
|
||
|
||
RICS（**R**ule **I**nfo **C**entralized **S**ervice）是 EIS 系统中的规则配置信息集中展示服务。它**不执行算法**，而是将 DB2 中配置的所有规则解析、格式化为结构化 JSON，然后推送到 Memcached 供前端页面和仪表盘使用。
|
||
|
||
与 eqpalg 不同，RICS 不做实时数据监控和报警，它专职负责**规则的配置信息的读取和格式化输出**。
|
||
|
||
## 进程架构
|
||
|
||
RICS 作为单个 PACE 平台组件运行，注册 ICE 端点 `"baosight/RICS"`，通过定时器周期性刷新全量规则信息。
|
||
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ RICS 进程 │
|
||
│ │
|
||
│ TimeNotify() ──→ RICSAlg::timed_task() │
|
||
│ │ │
|
||
│ ├→ alg_handle(algId) │
|
||
│ │ ├─ 读 T_RULE_CFG │
|
||
│ │ ├─ 解析 ruleParam │
|
||
│ │ └─ exp_handle() │
|
||
│ │ │
|
||
│ ├→ get_json_by_algid() │
|
||
│ │ └─ 格式化为JSON │
|
||
│ │ │
|
||
│ └→ write_memcaced() │
|
||
│ └─ Memcached 写入 │
|
||
└─────────────────────────────────────────────┘
|
||
```
|
||
|
||
## ICE 接口
|
||
|
||
| 方法 | 说明 |
|
||
|------|------|
|
||
| `SendDataShort(99999, seq)` | 调试/测试入口，调用 `RICS_alg_->dispose()` |
|
||
| `SendDataLong(...)` | 复杂数据接口（未实现） |
|
||
| `TimeNotify(...)` | 定时触发，调用 `timed_task()` 全量刷新 |
|
||
|
||
## 核心工作流
|
||
|
||
### `timed_task()` — 定时刷新
|
||
|
||
定时触发后，遍历 **15 种算法 ID**（`{1,2,3,4,5,6,7,8,12,13,14,15,16,17,18}`），对每种算法：
|
||
|
||
1. **`alg_handle(algId)`** — 从 DB2 `T_RULE_CFG` 读取该算法类型下的所有规则配置
|
||
2. **`exp_handle()`** — 按算法 ID 解析 `ruleParam` JSON，提取表达式字符串、参数、阈值等
|
||
3. **`get_json_by_algid()`** — 将所有规则组装为 `{columns: [...], data: [[...]]}` 的表格 JSON
|
||
4. **`write_memcaced()`** — 以 `"{unitNo}_Alg_{algId}"` 为 key 写入 Memcached
|
||
|
||
### 算法参数解析 (`exp_handle()`)
|
||
|
||
针对不同算法 ID 提取不同的参数字段：
|
||
|
||
| algId | 算法类型 | 表达式数 | 关键参数 |
|
||
|-------|----------|---------|----------|
|
||
| 1 | 简单报警 | 1 | — |
|
||
| 2 | 阈值监控 | 2 | limit_down, limit_up, unit |
|
||
| 3 | 动作-反馈(逻辑) | 3 | hold, timeout |
|
||
| 4 | 动作-反馈(阈值) | 3 | hold, timeout, limit_down, limit_up |
|
||
| 5 | 持续限值 | 2 | hold_time, limit_down, limit_up |
|
||
| 6 | 保持时间 | 1 | limit_time(小时) |
|
||
| 7 | 出现次数 | 1 | limit_times |
|
||
| 8 | 斜率/趋势 | 1 | interval_time, deltaX, diff, CS_AVG_SIZE |
|
||
| 12 | 相关性 | 3 | scale, min_len |
|
||
| 13 | 相关性+最小长度 | 3 | scale, min_len |
|
||
| 14 | 变化率 | 1 | interval_time, deltaX, diff(%), CS_AVG_SIZE |
|
||
| 15 | 数据窗口 | 1 | length(100-1000) |
|
||
| 16 | 多变量离群 | 2 | detect_mode, limit_warn, limit_error, hold_time |
|
||
| 17 | 限幅检查 | 2 | limit_warn, limit_error |
|
||
| 18 | 多变量离群v2 | 2 | 同 algId 16 |
|
||
|
||
### Memcached 输出
|
||
|
||
- **Key 格式**: `"{unitNo}_Alg_{algId}"`（如 `C308_Alg_1`）
|
||
- **Value 格式**: `{"columns": [...], "data": [[...]]}`
|
||
- 列包含：规则ID、规则名称、机组、标签名及中文翻译、表达式、参数等
|
||
|
||
## 关键技术细节
|
||
|
||
- **规则配置来源**: DB2 `T_RULE_CFG` 表，其中 `ruleParam` 是 JSON 字符串，包含 tags、before_exec（前提条件表达式）、function（算法参数）三大部分
|
||
- **中文翻译**: 通过 `BinaryTele` 从共享内存读取 `T_LOV_FDAAITEM` 表，构建 item 名→中文翻译的映射
|
||
- **算法 ID 缺失**: 算法 9、10、11 从未在 RICS 中实现展示
|
||
|
||
## 与 eqpalg 的关系
|
||
|
||
| 方面 | RICS | eqpalg |
|
||
|------|------|--------|
|
||
| 职责 | 规则配置展示 | 规则执行与报警 |
|
||
| 数据方向 | DB2 → Memcached（只读） | 共享内存 → 算法 → 报警 |
|
||
| 触发方式 | 定时全量刷新 | mon 持续/cron 定时/task 按需 |
|
||
| 输出 | Memcached 中的 JSON | 报警、DB2 统计结果 |
|
||
|
||
**RICS 是 eqpalg 的"配置展示面"** — 它将 eqpalg 所用到的同一批规则配置（来自 `T_RULE_CFG`）格式化后提供给前端，使得操作人员能看到当前正在运行哪些规则、每个规则的参数和表达式是什么。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
RICS/
|
||
├── RICS.cc/h # 进程入口，启动 ICE 服务
|
||
├── RICS_icei.cc/h # ICE 接口，处理电文和定时触发
|
||
├── RICS_alg.cc/h # 核心逻辑：规则读取、解析、JSON 输出
|
||
├── utility.cc/h # 时间工具函数
|
||
├── item2chinese.hpp # 标签名→中文翻译映射
|
||
├── public.h # RuleInfo / CfgRuleInfo 数据结构
|
||
├── table_struct/ # DB2 表结构映射
|
||
│ ├── t_rule_cfg.h # 规则配置表
|
||
│ ├── t_eqp_data.h # 设备数据表
|
||
│ ├── t_eqp_repair.h # 设备检修表
|
||
│ └── fv_pdi.h # 卷材生产数据视图
|
||
├── json/ # JSON 模板文件
|
||
│ ├── eqp_status.json
|
||
│ └── norm_info.json
|
||
└── CMakeLists.txt
|
||
```
|
||
|
||
## 作者
|
||
|
||
- Cat (null.null.null@qq.com)
|
||
- 宝信软件（Baosight Co. Ltd.）
|