← 返回总览 / 安全生产一体化管理平台 · TK-Safe-Upload 🏢 展示 📖 说明书 🕘 日志 技术架构说明
📐 Architecture

安全生产一体化管理平台 · TK-Safe-Upload

安全生产一体化智慧管理平台(信创版 5112) · 移动端 + PC 后台 + 数据大屏

📁 平台开发 🌐 http://192.168.11.70:5112/ 🕑 更新于 2026-10-25
1

项目定位

Positioning

大鹏投控安全生产一体化智慧管理平台信创版:把隐患发现、上报、分派、整改、复核销号、留痕做成闭环,手机能报、后台能管、大屏能看。

一句话定位

大鹏投控安全生产一体化智慧管理平台,移动端加 PC 后台加可视化大屏三端一体,5 类角色权限分级,全流程留痕可追溯

* **服务对象**:集团公司管理员(company_admin)、子公司安管(sub_admin)、现场巡查员(inspector)、商户(merchant)、普通员工(staff)

* **核心价值**:隐患从发现到销号全程线上留痕,逾期自动预警,重大隐患挂牌督办,培训签到与证书管理

* **统一入口**:登录后默认进 /portal 按角色分流,巡查员直达隐患页,员工仅见移动端

点击查看全文 ⤢
信创关系

源站 TK-Safe-UpLoad 跑 5111 沿用 SQLite 保持不动,本卡为信创版 TK-Safe-Xinchuang 跑 5112 切远端 PostgreSQL 专库

* **数据专库**:青云 W585x-A021(172.168.10.17 端口 5432),库名 tk_safe_xc,PG 11.22,openGauss 兼容目标

* **库迁移**:35 张表、1986 行生产数据全量迁移(保 id,sequence 逐表 setval),迁移后行数与源库零差异

* **口令管理**:环境变量 TK_SAFE_PG_PASSWORD 优先,data/pg_dsn.txt(mode 600)兜底,代码零硬编码;无凭据启动即 RuntimeError

* **登录升级**:bcrypt 带盐哈希(cost 12),旧 SHA-256 无盐哈希登录成功后自动升级;停用账号会话即时失效

* **灾备重建**:db_init.py / init_default_admin 走 models.bootstrap_pw,优先读 TK_BOOTSTRAP__PW,否则随机生成并打印,绝不回落弱默认值

点击查看全文 ⤢
当前运行态

内网 192.168.11.70 端口 5112 对外服务,Leon-Control 卡片 id 25 托管,自动重启加健康检查

* **代码规模**:约 3600 行 Python,35 个页面模板,36 张数据表,86 条路由

* **回归门禁**:test_all 87 项接口冒烟(自清理),test_links 96 项链接可达,test_ui 55 项真点击交互,test_flows 85 项多账号业务闭环,test_offline 断网可用,govern_data 0 残留

* **进程托管**:Leon-Control(192.168.11.70:5078),auto_restart=true,health_check=true,日志 logs/script_25.log

点击查看全文 ⤢
非目标

不做公网开放注册,账号由管理员后台创建,匿名仅限隐患举报入口,不替代 OA 审批

点击查看全文 ⤢
2

技术架构

Architecture
表现层
前端
服务端渲染零外部依赖

35 个 Jinja 模板,移动端 10 页加后台 21 页加门户登录大屏,Tailwind 加 Alpine.js 本地 vendor,ECharts 仅报表页懒加载,后台手机侧边栏抽屉化

* **设计令牌**:全站暗色 tk-theme.css(GitHub Dark 令牌),CSS 变量统一维护,4 端(登录/移动端/后台/门户)统一

* **对比度**:18 面 × 双视口 WCAG 对比度量化,低对比 0

* **适配**:表格支持左右滑动与分页,上传照片走压缩直传,移动端可缩放

* **离线可用**:tailwind/alpine/echarts 三件套 vendored 到 static/vendor/,外部请求 0

点击查看全文 ⤢
应用层
后端
Flask 单体加速蓝图拆分

Flask 3.1.1 多线程 serving,生产用 gunicorn 4 进程 4 线程,认证 auth、移动端 mobile、后台页面 admin_pages 已抽离为蓝图

* **鉴权**:login_required 拦未登录,role_required 按角色白名单,隐患整改另做负责人归属校验(assignee_id / assignee 双兼容)

* **防护**:Origin 与 Referer 同源校验加可选 CSRF Token,登录失败按 IP 限流锁定(5 次/5 分钟),停用账号会话即时失效

* **缓存**:大屏数据 30 秒内存缓存,组织名 60 秒缓存,表结构进程内缓存

* **错误处理**:_friendly_db_err 翻译数据库错误为中文,不外泄 SQL 片段

点击查看全文 ⤢
数据层
存储
PostgreSQL 兼容层

psycopg2 ThreadedConnectionPool 2 到 32 连接,问号占位统一转百分号 s,PRAGMA 查表结构转 information_schema,schema_migrations 表加 site_settings 双轨记录结构版本

* **兼容层**:?→%s、PRAGMA→information_schema、AUTOINCREMENT→SERIAL、date()→CURRENT_DATE 系、保留字 "user"/"key" 引用、RETURNING id、INSERT OR IGNORE→ON CONFLICT DO NOTHING

* **原子写**:物资出入库 UPDATE 自带库存下限条件加同事务写流水,杜绝超发与负库存

* **流程保护**:hazards 的 status/整改/复核/挂牌字段禁止通用 CRUD 直写(PROTECTED_FIELDS),防一步销号无留痕

* **治理**:govern_data 默认预览,确认后 --apply 执行;孤儿行(fk>0)+ 测试残留清理

点击查看全文 ⤢
运维层
运维
日志与回归脚本

RotatingFileHandler 单文件 5MB 保留 5 份,全操作留痕到 logs 表,db_init 初始化种子,87 项冒烟加 95 项链接可达性回归

* ** Leon-Control**:卡片 id 25,auto_restart=true,health_check=true,5s 监控 + 60s 健康检查

* **凭据**:bcrypt cost 12,5 账号强随机口令(data/ROTATED_PASSWORDS_20261009.txt mode 600),明文口令全仓 0 处

点击查看全文 ⤢
AI中台层
数据融合与智能分析

平台作为 AI 中台的数据底座:隐患、培训、物资、巡查、风险、许可、应急等结构化数据统一入库,对外提供标准化数据接口,供 AI 分析引擎消费;AI 结果回写平台,为领导提供智能态势分析、趋势预测、风险预警与整改建议

* **数据汇聚**:本平台数据 + 工程反馈系统 + 安全管理平台 + 智慧工地等多源数据统一汇聚到 AI 中台

* **供应商/提供商**:AI 模型供应商与数据提供商通过标准化接口接入,平台不绑定单一模型,支持多模型切换

* **AI 分析**:报告自动生成、隐患趋势预测、风险等级智能评估、整改方案建议、培训效果分析

* **领导视图**:AI 中台为领导提供一站式智能分析看板,数据流动设计支持实时/准实时同步

点击查看全文 ⤢
flowchart TB
    subgraph C["三端"]
        M["移动端 /m"]
        P["PC 后台 /admin"]
        S["大屏 /screen"]
        Portal["统一工作台 /portal"]
    end
    subgraph A["Flask 应用层"]
        B1["蓝图 auth mobile admin_pages"]
        B2["隐患闭环 培训 物资 巡查 许可 应急"]
        B3["通用 CRUD 导入导出 报表"]
    end
    subgraph D["数据层"]
        PG[("PostgreSQL tk_safe_xc")]
        Pool["ThreadedConnectionPool 2-32"]
    end
    subgraph Ops["运维"]
        LC["Leon-Control id=25"]
        Tests["test_all test_links test_ui test_flows test_offline"]
    end
    C --> A --> D
    Ops -.-> A
    Ops -.-> D
flowchart LR
    R["上报 随手拍 巡查 举报"] --> W["待分派"]
    W --> F["分派 责任人加期限"]
    F --> G["整改 说明加照片"]
    G --> H{"复核"}
    H -->|"通过"| C["销号归档"]
    H -->|"退回"| G
    C --> S["报表加预警"]
    G --> T["培训链"]
    G --> M["物资链"]
flowchart LR
    subgraph Sources["多源数据"]
        P["本平台 数据"]
        E["工程反馈系统"]
        S["安全管理平台"]
        W["智慧工地"]
    end
    subgraph AI["AI 中台"]
        A1["数据标准化"]
        A2["AI 分析引擎"]
        A3["报告生成"]
        A4["趋势预测"]
    end
    subgraph Out["输出"]
        L["领导看板"]
        R["AI 报告"]
        A5["整改建议"]
    end
    Sources --> A1 --> A2
    A2 --> A3
    A2 --> A4
    A3 --> L
    A4 --> L
    A2 --> A5
    A5 --> P
    A3 --> R
3

模块组成

Modules
统一工作台
三端聚合桌面

登录后按角色展示可进端,4 个 KPI 加预警中心加状态分布加风险分布加最新隐患动态,巡查员直达隐患页,staff 仅见移动端

点击查看全文 ⤢
移动端
随手拍上报加巡查打卡加任务接收加举报加培训加资料查阅加预警加个人中心

拍照自动绑定风险点位(point_id 回填 point_name),打卡按计划签到,个人中心可改密,待办优先展示

点击查看全文 ⤢
后台台账
21 页覆盖双重预防专项培训应急报表考核

基础台账经营主体特种设备人员相关方物资,风险点四级分级到期复核,专项消防燃气建筑有限空间特种设备文旅户外

点击查看全文 ⤢
隐患治理闭环
分派整改复核销号挂牌督办

隐患表加流转表双写,状态机待分派到整改中到待复核到已销号,复核退回则回到整改中,销号自动办结整改任务

* **逾期兜底**:逾期扫描自动标记,重大隐患挂牌督办加强制停工标记

* **一致性**:通用接口禁止直写状态类字段,只能走闭环接口

* **权限**:仅整改负责人或管理员可提交整改,空意见销号被拒

点击查看全文 ⤢
培训 MOOC
课程加课时加进度加笔记加证书

单课时进度达 90% 视为完成,全部完成生成 12 位证书码,删除课程级联清理课时进度笔记签到证书

点击查看全文 ⤢
物资管理
原子出入库

UPDATE 语句带库存下限条件加同事务写流水,杜绝超发与负库存,出入库流水可查,盘点写盘点日

点击查看全文 ⤢
作业许可
高风险作业多级审批

动火有限空间高处作业模板,两级审批(未过一级直接二级被拒),完工销项,全程 4 条审计

点击查看全文 ⤢
风险管理
双重预防四色分级

重大/较大/一般/低风险,复核记录落库,next_review 顺延,风险复核到期预警

点击查看全文 ⤢
巡查管理
计划加点位加打卡

计划可启停,手机按计划签到,不存在的计划被打回,打卡关联计划

点击查看全文 ⤢
应急管理
预案加演练加联系人

新增演练/联系人落库到对应表,/m/library 可查阅

点击查看全文 ⤢
通用台账能力
白名单加流程保护

21 张业务台账可通用增删改查,考核与配置仅公司管理员可维护,7 类台账 CSV 模板下载加上传导入兼容 UTF-8-BOM 与 GBK 编码

点击查看全文 ⤢
风险/违章上报
两种上报渠道

风险上报与违章上报,大屏脱敏展示

```python

# models.py material_io_apply 摘录:原子出入库

row = conn.execute(

"UPDATE materials SET quantity=quantity+%s WHERE id=%s "

"AND (quantity >= %s) RETURNING quantity, name",

(sign * qty, mid, qty if sign < 0 else 0)).fetchone()

```

```python

# app.py api_hazard_rectify 摘录:越权防护

if u["role"] not in ("company_admin", "sub_admin"):

is_owner = (hazard.get("assignee_id") == u["id"]

or hazard.get("assignee") in (u["name"], u["username"]))

if not is_owner:

return api_err("仅整改负责人可提交整改", 403)

```

点击查看全文 ⤢
源码与素材清单
文件 / 目录类型说明
4

数据流转

Data Flow

平台主线只有一条:隐患从发现到销号的闭环,培训链物资链报表链都围着它转。

* **上报端**:移动端随手拍、巡查打卡、举报三路写入 hazards,状态为待分派;标题为空时默认"隐患随手拍"/"隐患举报",org_id 自动取上报人所属单位

* **分派端**:管理员指定整改负责人与期限,自动生成 rectify 任务并通知;责任单位未选时自动取责任人所属单位

* **整改端**:负责人提交说明与佐证照片(8MB 单文件限制),状态转待复核;整改说明同时接受 note 和 rectify_note 字段

* **复核端**:验收通过则销号并办结任务,退回则回到整改中;销号必须填写复核意见(验收依据),空意见被拒

* **兜底**:逾期扫描自动标记,重大隐患挂牌督办加强制停工标记;通用接口禁止直写状态类字段

平台定位为 **AI 中台的数据底座与服务入口**,所有业务数据统一汇聚、标准化输出,供 AI 分析引擎消费,并将 AI 分析结果回写平台,为领导提供智能决策支持。

* **数据标准**:统一字段命名、编码、时间戳、单位编码,确保跨系统可关联

* **同步方式**:实时接口推送 + 定时批量同步,支持增量与全量

* **数据范围**:隐患记录、整改记录、培训签到、物资流水、巡查轨迹、风险点位、作业许可、应急演练

* **报告生成**:自动生成安全态势报告、隐患趋势分析、整改率排名、风险分布报告

* **趋势预测**:基于历史隐患数据预测高发时段/区域/类型,提前预警

* **风险评估**:AI 智能评估风险等级,辅助分级管控

* **整改建议**:根据隐患类型与历史数据,推荐整改方案与责任单位

* **培训分析**:培训效果评估、知识薄弱点识别、个性化培训推荐

* **模型切换**:支持多 AI 模型供应商,按需切换(如 Qwen、DeepSeek、OpenAI 兼容接口)

* **数据提供商**:工程反馈、安全管理、智慧工地等外部系统作为数据提供商接入

* **鉴权**:API Key + Token 双层认证,调用限流与审计

* **AI 看板**:风险热力图、隐患趋势、整改态势、培训效果、物资预警,AI 自动生成摘要

* **决策支持**:AI 推荐重点关注区域/单位/人员,辅助管理决策

员工上报 → 管理员分派 → 责任人整改 → 管理员复核 → 销号归档

* 培训链:后台上传课件排课,移动端在线学习,课时进度按用户累积(进度达 90% 视为完成),全部完成签发 12 位证书码;未学完申请证书返回 400 且证书表 0 行

* 物资链:每次出入库同时写流水(同事务),库存低于警戒线进入待办预警;出入库超库存被拒且库存不变

* 风险链:风险点四级分级,复核记录落库,next_review 顺延,风险复核到期预警

* 巡查链:计划可启停,手机按计划签到,不存在的计划被打回,打卡关联计划

* 报表链:隐患趋势(12 个月)、整改率排名、风险分布定时聚合,大屏 30 秒缓存对外提供脱敏态势数据(手机号打码,证件号/整改说明剔除)

* 权限链:5 角色分级,登录态集中校验(停用即失效),角色白名单,负责人归属三层收敛

* 多源数据汇聚 | 跨系统数据融合 | 本平台(隐患/培训/物资/巡查/风险/许可/应急)+ 工程反馈系统 + 安全管理平台 + 智慧工地等多源数据统一汇聚到 AI 中台

* AI 分析引擎 | 智能分析与预测 | AI 中台对汇聚数据进行深度分析,输出结构化结论

* 供应商/提供商接入 | 开放的 AI 服务接口 | AI 模型供应商与数据提供商通过标准化 API 接入,平台不绑定单一模型

* 领导视图 | AI 中台服务入口 | 为领导提供一站式智能分析看板

* **报告推送**:定期推送 AI 生成的安全报告到领导端(微信/邮件/大屏)

点击查看全文 ⤢
flowchart LR
  n0["员工上报"] --> n1["管理员分派"]
  n1["管理员分派"] --> n2["责任人整改"]
  n2["责任人整改"] --> n3["管理员复核"]
  n3["管理员复核"] --> n4["销号归档"]
5

接口与集成

API
GET /portal
GET

统一工作台,登录后默认落地页,按角色展示三端入口与待办

* **方法路径**:GET /portal,需登录

点击查看全文 ⤢
POST /login
POST

表单与 JSON 双兼容登录,失败按 IP 限流,成功体含角色

* **方法路径**:POST /login,需提供用户名与口令

* **返回**:成功含角色,失败 401,触发限流 429

点击查看全文 ⤢
GET /logout
GET

清会话并记审计

* **方法路径**:GET /logout,需登录

点击查看全文 ⤢
POST /api/photo/submit
POST

一线员工拍照上报隐患,自动绑定点位

* **方法路径**:POST /api/photo/submit,需登录,multipart 表单,照片最多 6 张,单文件 8MB 限制

点击查看全文 ⤢
POST /api/patrol/checkin
POST

按计划点位签到并留证

* **方法路径**:POST /api/patrol/checkin,需登录

点击查看全文 ⤢
POST /api/report/submit
POST

实名或匿名举报,匿名时上报人记 0

* **方法路径**:POST /api/report/submit,需登录

点击查看全文 ⤢
POST /api/task/编号/done
POST

任务负责人确认完成本人任务

* **方法路径**:POST /api/task/任务编号/done,仅本人或管理员

点击查看全文 ⤢
POST /api/training/课程编号/sign
POST

课程签到课时进度上报笔记管理证书生成

* **方法路径**:POST 同路径 sign 与 progress,GET 同路径 lessons,POST 同路径 certificate/generate

点击查看全文 ⤢
POST /api/profile/password
POST

校验旧口令后改密,更新姓名与手机号

* **方法路径**:POST /api/profile/password 与 /api/profile/update

点击查看全文 ⤢
GET /api/admin/表名/list
GET

21 张台账分页列表,巡查员仅开放 10 张只读子集

* **方法路径**:GET /api/admin/表名/list,需后台角色,支持 org 筛选 + kw 服务端搜索 + 分页

点击查看全文 ⤢
POST /api/admin/表名/add
POST

台账新增与维护,隐患流程字段被拦截保护

* **方法路径**:POST 同路径 add,POST 同路径 编号/update,POST 同路径 编号/delete

点击查看全文 ⤢
POST /api/admin/users/add
POST

新增改角色停用删除用户,保留至少一个可用管理员

* **方法路径**:POST 同路径 users/add 与 users/编号/update,仅公司管理员

点击查看全文 ⤢
POST /api/admin/hazard/编号/assign
POST

指定整改负责人责任单位与期限,自动生成 rectify 任务

* **方法路径**:POST /api/admin/hazard/编号/assign,需后台角色

点击查看全文 ⤢
POST /api/admin/hazard/编号/rectify
POST

负责人提交整改说明与佐证照片

* **方法路径**:POST /api/admin/hazard/编号/rectify,需登录且为负责人本人或管理员

点击查看全文 ⤢
POST /api/admin/hazard/编号/review
POST

通过则销号并办结任务,退回则回到整改中,销号必须写验收依据

* **方法路径**:POST /api/admin/hazard/编号/review,需后台角色

点击查看全文 ⤢
POST /api/admin/hazard/编号/major
POST

重大隐患挂牌督办与强制停工标记

* **方法路径**:POST /api/admin/hazard/编号/major,需后台角色

点击查看全文 ⤢
GET /api/admin/hazard/编号/detail
GET

基础信息加照片加流转时间线一站式查看

* **方法路径**:GET /api/admin/hazard/编号/detail,管理员与巡查员可读

点击查看全文 ⤢
POST /api/admin/material/编号/io
POST

原子加减库存并写流水,超库存直接拒绝

* **方法路径**:POST /api/admin/material/编号/io,需后台角色

点击查看全文 ⤢
POST /api/admin/risk/编号/review
POST

风险点复核登记并顺延下次复核

* **方法路径**:POST /api/admin/risk/编号/review,需后台角色

点击查看全文 ⤢
POST /api/admin/permit/编号/approve
POST

高风险作业多级审批与完工销项

* **方法路径**:POST /api/admin/permit/编号/approve,POST 同路径 /finish

点击查看全文 ⤢
GET /admin/export/表名
GET

全量台账 CSV 导出,培训进度可单独导出

* **方法路径**:GET /admin/export/表名,POST /api/admin/表名/import 做 CSV 批量导入(兼容 UTF-8-BOM 与 GBK)

点击查看全文 ⤢
GET /api/screen/data
GET

免登录公开访问,手机号脱敏,隐患明细仅白名单字段

* **方法路径**:GET /api/screen/data,30 秒服务端缓存

点击查看全文 ⤢
GET /health
GET

托管探活,附带数据库连通性

* **方法路径**:GET /health,免登录

点击查看全文 ⤢
POST /api/admin/training_courses/upload
POST

课程上传(视频/PDF/文档),org_id 自动取当前用户所属单位

* **方法路径**:POST /api/admin/training_courses/upload,需后台角色

点击查看全文 ⤢
6

部署形态

Deployment
运行位置

内网应用服务器 192.168.11.70,Leon-Control 卡片 id 25 托管,自动重启加健康检查

点击查看全文 ⤢
服务端口

5112 对外服务,start.sh 一键启动,生产用 gunicorn 4 进程 4 线程

点击查看全文 ⤢
数据专库

青云 ARM 服务器,172.168.10.17 端口 5432,库名 tk_safe_xc,PG 11.22,openGauss 兼容目标,口令走环境变量或受限文件

点击查看全文 ⤢
启动依赖

Python 3.12,Flask 3.1.1,psycopg2-binary 2.9.13,bcrypt,fpdf2,首次 bash start.sh --install 装依赖(清华镜像)

点击查看全文 ⤢
文件与上传

uploads 按业务分子目录存放,扩展名白名单,照片路径入库前正则校验(/^\/uploads\/[A-Za-z0-9_\-]+\/[A-Za-z0-9_.\-]+$/)

点击查看全文 ⤢
可观测性

RotatingFileHandler 单文件 5MB 保留 5 份,关键操作同步记 logs 表,87 项接口冒烟加 95 项链接可达性回归

点击查看全文 ⤢
备份

代码备份 git tag pre-ux-20261025 加目录副本,数据备份 /tmp/cleanup_backup_*.json

点击查看全文 ⤢
公网入口

http://119.145.17.34:5112/ (需 NAT 放行)

点击查看全文 ⤢
© 2026 Leyon WorkStation · 安全生产一体化管理平台 · TK-Safe-Upload 🏢 展示 📖 说明书 🕘 日志 ← 返回项目总览
🚀 进入系统