docs: add mermaid flowcharts
This commit is contained in:
1 parent
5166df13f6
commit
d9d03a5ef6
1 file changed
+334
+334
@@ -0,0 +1,334 @@
|
||||
# 项目流程图
|
||||
|
||||
## 1. 系统整体架构
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
PLC1["西门子 S7-1200/1500<br/>PLC #1 (DB100)"]
|
||||
PLC2["西门子 S7-1200/1500<br/>PLC #2 (DB100)"]
|
||||
|
||||
subgraph SN [Node.js 服务端]
|
||||
SC["Scanner 轮询线程<br/>每 1000ms"]
|
||||
CL["Snap7 Client<br/>读写 DB 块"]
|
||||
CO["采集服务<br/>DataReady 处理"]
|
||||
IL["互锁服务<br/>PrevResultReq 处理"]
|
||||
API["REST API<br/>Hono (:3000)"]
|
||||
SW["静态文件服务<br/>web/dist"]
|
||||
DB[("SQLite<br/>production.db")]
|
||||
end
|
||||
|
||||
subgraph WEB ["浏览器"]
|
||||
UI["前端页面<br/>Vite + Tailwind"]
|
||||
end
|
||||
|
||||
PLC1 -- "S7 协议" --> CL
|
||||
PLC2 -- "S7 协议" --> CL
|
||||
CL --> SC
|
||||
SC --> CO
|
||||
SC --> IL
|
||||
CO --> DB
|
||||
IL --> DB
|
||||
API --> DB
|
||||
API --> SW
|
||||
SW --> UI
|
||||
UI -- "http://localhost:3000" --> API
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 启动流程
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
START["npm run start"] --> INIT
|
||||
INIT["ensureDatabase()"] --> CHECK_DB{"数据库<br/>存在?"}
|
||||
CHECK_DB -->|"否"| CREATE["创建配置表<br/>MeasurementPoints<br/>PLCs<br/>Stations"]
|
||||
CHECK_DB -->|"是"| LOAD["加载配置"]
|
||||
CREATE --> LOAD
|
||||
LOAD --> SKIP{"SKIP_PLC?"}
|
||||
SKIP -->|"是"| SKIP_LOG["跳过 PLC 连接"]
|
||||
SKIP -->|"否"| CONNECT["连接 PLC<br/>ConnectTo(ip, 0, 2)"]
|
||||
CONNECT --> SUCCESS{"成功?"}
|
||||
SUCCESS -->|"是"| START_LOG["开始轮询 1000ms"]
|
||||
SUCCESS -->|"否"| ERR_LOG["记录失败日志"]
|
||||
ERR_LOG --> START_LOG
|
||||
SKIP_LOG --> START_LOG
|
||||
START_LOG --> HTTP["HTTP 服务 :3000"]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 数据采集流程(DataReady)
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant PLC as 西门子 PLC
|
||||
participant SC as Scanner 轮询
|
||||
participant DB as SQLite
|
||||
participant CW as ControlWord
|
||||
|
||||
PLC->>CW: 写入测量值<br/>DataReady=1
|
||||
SC->>PLC: 每 1000ms 读 32 字节
|
||||
PLC-->>SC: ProductID + 测量值 + ControlWord
|
||||
SC->>CW: 检查 DataReady
|
||||
CW-->>SC: DataReady=1
|
||||
|
||||
SC->>SC: 解析数据
|
||||
|
||||
SC->>DB: 查该产品最大 InspectionCount
|
||||
DB-->>SC: max(InspectionCount)
|
||||
|
||||
alt 首次检测
|
||||
SC->>DB: INSERT<br/>InspectionCount=1
|
||||
else 返修
|
||||
SC->>DB: UPDATE<br/>InspectionCount+1
|
||||
end
|
||||
|
||||
SC->>PLC: 写 ControlWord<br/>DataReady=0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 工序互锁流程(PrevResultReq)
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant PLC as 西门子 PLC
|
||||
participant SC as Scanner 轮询
|
||||
participant DB as SQLite
|
||||
|
||||
PLC->>PLC: 需要查上一工序结果<br/>PrevResultReq=1
|
||||
SC->>PLC: 读 32 字节
|
||||
PLC-->>SC: ProductID + ControlWord
|
||||
SC->>SC: 检测到 PrevResultReq=1
|
||||
|
||||
SC->>DB: 获取所有工序(按 Id 排序)
|
||||
DB-->>SC: [预焊接, 主焊接, 焊后检测, ...]
|
||||
|
||||
SC->>SC: 找到当前工序位置
|
||||
alt 是首工序
|
||||
SC->>SC: PrevResult=1
|
||||
else 不是首工序
|
||||
SC->>DB: 查前工序的 IsQualified
|
||||
DB-->>SC: IsQualified=1 或 0
|
||||
end
|
||||
|
||||
SC->>PLC: 写 ControlWord<br/>PrevResult=1/0<br/>PrevResultReq=0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 设备配置流程(前端 → API → 数据库)
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph FE ["前端"]
|
||||
MP["检测点管理<br/>增删改"]
|
||||
PLC["PLC 管理<br/>增删改"]
|
||||
ST["工序管理<br/>增删改<br/>下拉选检测点"]
|
||||
end
|
||||
|
||||
subgraph API ["后端 API"]
|
||||
GET_MP["GET /api/config/measurement-points"]
|
||||
POST_MP["POST /api/config/measurement-points"]
|
||||
GET_PLC["GET /api/config/plcs"]
|
||||
POST_PLC["POST /api/config/plcs"]
|
||||
GET_ST["GET /api/config/stations"]
|
||||
POST_ST["POST /api/config/stations<br/>自动关联检测点"]
|
||||
end
|
||||
|
||||
subgraph DB ["数据库"]
|
||||
TBL_MP["MeasurementPoints"]
|
||||
TBL_PLC["PLCs"]
|
||||
TBL_ST["Stations"]
|
||||
DATA["MPData_P{id}_{date}"]
|
||||
end
|
||||
|
||||
MP --> GET_MP
|
||||
MP --> POST_MP
|
||||
PLC --> GET_PLC
|
||||
PLC --> POST_PLC
|
||||
ST --> GET_ST
|
||||
ST --> POST_ST
|
||||
|
||||
GET_MP --> TBL_MP
|
||||
POST_MP -->|"创建检测点"| TBL_MP
|
||||
POST_MP -->|"自动创建"| DATA
|
||||
GET_PLC --> TBL_PLC
|
||||
POST_PLC --> TBL_PLC
|
||||
GET_ST --> TBL_ST
|
||||
POST_ST --> TBL_ST
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 追溯查询流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant UI as 前端页面
|
||||
participant API as 后端 API
|
||||
participant DB as SQLite
|
||||
|
||||
UI->>UI: 输入产品编号<br/>点击查询
|
||||
UI->>API: GET /api/query/PROD-001
|
||||
API->>DB: 查询所有检测点
|
||||
DB-->>API: [{Id:1, 焊接温度}, {Id:2, 焊接电流}, ...]
|
||||
|
||||
loop 遍历每个检测点
|
||||
API->>DB: SELECT FROM MPData_P{Id}_{date}
|
||||
DB-->>API: RecordTime, IsQualified,<br/>InspectionCount, 测量值
|
||||
end
|
||||
|
||||
API-->>UI: 返回所有检测点数据
|
||||
UI->>UI: 按检测点分组展示<br/>合格/不合格 标记<br/>返修标记
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. PLC 内存布局
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph DB1 ["DB1 (PLC接口数据块)"]
|
||||
ST0["工序 0<br/>偏移 0 ~ 23<br/>24 字节"]
|
||||
ST1["工序 1<br/>偏移 24 ~ 47<br/>24 字节"]
|
||||
ST2["工序 2<br/>偏移 48 ~ 71<br/>24 字节"]
|
||||
ST_N["... 更多工序<br/>每工序 24 字节"]
|
||||
end
|
||||
|
||||
subgraph ST0_D ["工序 0 内部结构"]
|
||||
P0["ProductID (DINT)<br/>偏移 +0 | 4 字节"]
|
||||
UL["UpperLimit (REAL)<br/>偏移 +4 | 4 字节"]
|
||||
LL["LowerLimit (REAL)<br/>偏移 +8 | 4 字节"]
|
||||
MV["MeasuredValue (REAL)<br/>偏移 +12 | 4 字节"]
|
||||
CW["ControlWord (WORD)<br/>偏移 +16 | 2 字节"]
|
||||
RS["Reserved<br/>偏移 +18 | 6 字节"]
|
||||
end
|
||||
|
||||
subgraph CW_D ["ControlWord 位定义"]
|
||||
B0["Bit 0: DataReady<br/>PLC → PC"]
|
||||
B1["Bit 1: IsQualified<br/>PLC → PC"]
|
||||
B2["Bit 2: PrevResultReq<br/>PLC → PC"]
|
||||
B3["Bit 3: PrevResult<br/>PC → PLC"]
|
||||
B4["Bit 4~15<br/>保留"]
|
||||
end
|
||||
|
||||
DB1 --> ST0
|
||||
DB1 --> ST1
|
||||
DB1 --> ST2
|
||||
DB1 --> ST_N
|
||||
ST0 --> ST0_D
|
||||
CW --> CW_D
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 数据库表关系
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
MeasurementPoints ||--o{ Stations : "1:N"
|
||||
PLCs ||--o{ Stations : "1:N"
|
||||
Stations ||--o{ "MPData_P{id}_{date}" : "写入数据"
|
||||
|
||||
MeasurementPoints {
|
||||
int Id PK
|
||||
string PointName
|
||||
string FieldUnit
|
||||
}
|
||||
|
||||
PLCs {
|
||||
int Id PK
|
||||
string PLCName
|
||||
string IPAddress
|
||||
int DBNumber
|
||||
int StationCount
|
||||
}
|
||||
|
||||
Stations {
|
||||
int Id PK
|
||||
int PLCId FK
|
||||
int StationIndex
|
||||
string StationName
|
||||
int PointId FK
|
||||
}
|
||||
|
||||
"MPData_P{id}_{date}" {
|
||||
int Id PK
|
||||
string ProductID UK
|
||||
datetime RecordTime
|
||||
int IsQualified
|
||||
int InspectionCount
|
||||
float UpperLimit
|
||||
float LowerLimit
|
||||
float MeasuredValue
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. 部署架构
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph WIN ["Windows 工控机"]
|
||||
PROC["Node.js 进程<br/>(tsx 或编译后运行)"]
|
||||
HTTP["HTTP 服务 :3000"]
|
||||
DB[("SQLite 数据库<br/>data/production.db")]
|
||||
WEB_DIST["前端构建产物<br/>web/dist"]
|
||||
end
|
||||
|
||||
subgraph PLC_NET ["车间以太网"]
|
||||
PLC_A["PLC #1<br/>192.168.0.10"]
|
||||
PLC_B["PLC #2<br/>192.168.0.11"]
|
||||
end
|
||||
|
||||
subgraph CLIENT ["浏览器"]
|
||||
ADMIN["管理员电脑<br/>查追溯/配置"]
|
||||
end
|
||||
|
||||
PLC_A -->|"S7 协议"| PROC
|
||||
PLC_B -->|"S7 协议"| PROC
|
||||
PROC --> DB
|
||||
PROC --> WEB_DIST
|
||||
HTTP --> ADMIN
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 日志系统
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph LOG ["日志格式"]
|
||||
TS["时间戳<br/>2026-06-09 12:00:00"]
|
||||
LVL["级别<br/>D/I/W/E"]
|
||||
TAG["模块<br/>Scanner/PLC/采集/互锁"]
|
||||
MSG["消息"]
|
||||
end
|
||||
|
||||
subgraph LVLS ["级别说明"]
|
||||
D["[D] DEBUG<br/>开发调试"]
|
||||
I["[I] INFO<br/>正常流程"]
|
||||
W["[W] WARN<br/>需关注"]
|
||||
E["[E] ERROR<br/>异常错误"]
|
||||
end
|
||||
|
||||
subgraph MODS ["模块 TAG"]
|
||||
S["Scanner<br/>轮询/配置"]
|
||||
P["PLC<br/>连接/读写"]
|
||||
C["采集<br/>数据入库"]
|
||||
I2["互锁<br/>前工序查询"]
|
||||
SC["Schema<br/>建表"]
|
||||
end
|
||||
|
||||
LOG --> LVLS
|
||||
LOG --> MODS
|
||||
|
||||
%% 示例日志
|
||||
EX1["✅ 正常: [I] [Scanner] PLC01 DataReady=1, ProductID=12345, 开始采集"]
|
||||
EX2["⚠️ 警告: [W] [PLC] DB100 读取工序 0 失败: tcp连接超时"]
|
||||
EX3["✅ 采集: [I] [采集] 焊接温度 产品 12345: 首次检测 95.5"]
|
||||
EX4["✅ 互锁: [I] [互锁] 主焊接 查询 预焊接 → 合格"]
|
||||
```
|
||||
Reference in new issue
Block a user