diff --git a/FLOWCHART.md b/FLOWCHART.md new file mode 100644 index 0000000..4322a2e --- /dev/null +++ b/FLOWCHART.md @@ -0,0 +1,334 @@ +# 项目流程图 + +## 1. 系统整体架构 + +```mermaid +flowchart TB + PLC1["西门子 S7-1200/1500
PLC #1 (DB100)"] + PLC2["西门子 S7-1200/1500
PLC #2 (DB100)"] + + subgraph SN [Node.js 服务端] + SC["Scanner 轮询线程
每 1000ms"] + CL["Snap7 Client
读写 DB 块"] + CO["采集服务
DataReady 处理"] + IL["互锁服务
PrevResultReq 处理"] + API["REST API
Hono (:3000)"] + SW["静态文件服务
web/dist"] + DB[("SQLite
production.db")] + end + + subgraph WEB ["浏览器"] + UI["前端页面
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{"数据库
存在?"} + CHECK_DB -->|"否"| CREATE["创建配置表
MeasurementPoints
PLCs
Stations"] + CHECK_DB -->|"是"| LOAD["加载配置"] + CREATE --> LOAD + LOAD --> SKIP{"SKIP_PLC?"} + SKIP -->|"是"| SKIP_LOG["跳过 PLC 连接"] + SKIP -->|"否"| CONNECT["连接 PLC
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: 写入测量值
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
InspectionCount=1 + else 返修 + SC->>DB: UPDATE
InspectionCount+1 + end + + SC->>PLC: 写 ControlWord
DataReady=0 +``` + +--- + +## 4. 工序互锁流程(PrevResultReq) + +```mermaid +sequenceDiagram + participant PLC as 西门子 PLC + participant SC as Scanner 轮询 + participant DB as SQLite + + PLC->>PLC: 需要查上一工序结果
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
PrevResult=1/0
PrevResultReq=0 +``` + +--- + +## 5. 设备配置流程(前端 → API → 数据库) + +```mermaid +flowchart LR + subgraph FE ["前端"] + MP["检测点管理
增删改"] + PLC["PLC 管理
增删改"] + ST["工序管理
增删改
下拉选检测点"] + 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
自动关联检测点"] + 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: 输入产品编号
点击查询 + 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,
InspectionCount, 测量值 + end + + API-->>UI: 返回所有检测点数据 + UI->>UI: 按检测点分组展示
合格/不合格 标记
返修标记 +``` + +--- + +## 7. PLC 内存布局 + +```mermaid +flowchart TB + subgraph DB1 ["DB1 (PLC接口数据块)"] + ST0["工序 0
偏移 0 ~ 23
24 字节"] + ST1["工序 1
偏移 24 ~ 47
24 字节"] + ST2["工序 2
偏移 48 ~ 71
24 字节"] + ST_N["... 更多工序
每工序 24 字节"] + end + + subgraph ST0_D ["工序 0 内部结构"] + P0["ProductID (DINT)
偏移 +0 | 4 字节"] + UL["UpperLimit (REAL)
偏移 +4 | 4 字节"] + LL["LowerLimit (REAL)
偏移 +8 | 4 字节"] + MV["MeasuredValue (REAL)
偏移 +12 | 4 字节"] + CW["ControlWord (WORD)
偏移 +16 | 2 字节"] + RS["Reserved
偏移 +18 | 6 字节"] + end + + subgraph CW_D ["ControlWord 位定义"] + B0["Bit 0: DataReady
PLC → PC"] + B1["Bit 1: IsQualified
PLC → PC"] + B2["Bit 2: PrevResultReq
PLC → PC"] + B3["Bit 3: PrevResult
PC → PLC"] + B4["Bit 4~15
保留"] + 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 进程
(tsx 或编译后运行)"] + HTTP["HTTP 服务 :3000"] + DB[("SQLite 数据库
data/production.db")] + WEB_DIST["前端构建产物
web/dist"] + end + + subgraph PLC_NET ["车间以太网"] + PLC_A["PLC #1
192.168.0.10"] + PLC_B["PLC #2
192.168.0.11"] + end + + subgraph CLIENT ["浏览器"] + ADMIN["管理员电脑
查追溯/配置"] + end + + PLC_A -->|"S7 协议"| PROC + PLC_B -->|"S7 协议"| PROC + PROC --> DB + PROC --> WEB_DIST + HTTP --> ADMIN +``` + +--- + +## 10. 日志系统 + +```mermaid +flowchart TB + subgraph LOG ["日志格式"] + TS["时间戳
2026-06-09 12:00:00"] + LVL["级别
D/I/W/E"] + TAG["模块
Scanner/PLC/采集/互锁"] + MSG["消息"] + end + + subgraph LVLS ["级别说明"] + D["[D] DEBUG
开发调试"] + I["[I] INFO
正常流程"] + W["[W] WARN
需关注"] + E["[E] ERROR
异常错误"] + end + + subgraph MODS ["模块 TAG"] + S["Scanner
轮询/配置"] + P["PLC
连接/读写"] + C["采集
数据入库"] + I2["互锁
前工序查询"] + SC["Schema
建表"] + 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] [互锁] 主焊接 查询 预焊接 → 合格"] +```