安全生产一体化管理平台 · TK-Safe-Upload
安全生产一体化智慧管理平台(信创版 5112) · 移动端 + PC 后台 + 数据大屏
项目定位
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_
内网 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 审批
技术架构
Architecture35 个 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 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 片段
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 中台为领导提供一站式智能分析看板,数据流动设计支持实时/准实时同步
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
模块组成
Modules登录后按角色展示可进端,4 个 KPI 加预警中心加状态分布加风险分布加最新隐患动态,巡查员直达隐患页,staff 仅见移动端
拍照自动绑定风险点位(point_id 回填 point_name),打卡按计划签到,个人中心可改密,待办优先展示
基础台账经营主体特种设备人员相关方物资,风险点四级分级到期复核,专项消防燃气建筑有限空间特种设备文旅户外
隐患表加流转表双写,状态机待分派到整改中到待复核到已销号,复核退回则回到整改中,销号自动办结整改任务
* **逾期兜底**:逾期扫描自动标记,重大隐患挂牌督办加强制停工标记
* **一致性**:通用接口禁止直写状态类字段,只能走闭环接口
* **权限**:仅整改负责人或管理员可提交整改,空意见销号被拒
单课时进度达 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)
```
源码与素材清单
| 文件 / 目录 | 类型 | 说明 |
|---|
数据流转
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["销号归档"]
接口与集成
APIGET /portal统一工作台,登录后默认落地页,按角色展示三端入口与待办
* **方法路径**:GET /portal,需登录
POST /login表单与 JSON 双兼容登录,失败按 IP 限流,成功体含角色
* **方法路径**:POST /login,需提供用户名与口令
* **返回**:成功含角色,失败 401,触发限流 429
GET /logout清会话并记审计
* **方法路径**:GET /logout,需登录
POST /api/photo/submit一线员工拍照上报隐患,自动绑定点位
* **方法路径**:POST /api/photo/submit,需登录,multipart 表单,照片最多 6 张,单文件 8MB 限制
POST /api/patrol/checkin按计划点位签到并留证
* **方法路径**:POST /api/patrol/checkin,需登录
POST /api/report/submit实名或匿名举报,匿名时上报人记 0
* **方法路径**:POST /api/report/submit,需登录
POST /api/task/编号/done任务负责人确认完成本人任务
* **方法路径**:POST /api/task/任务编号/done,仅本人或管理员
POST /api/training/课程编号/sign课程签到课时进度上报笔记管理证书生成
* **方法路径**:POST 同路径 sign 与 progress,GET 同路径 lessons,POST 同路径 certificate/generate
POST /api/profile/password校验旧口令后改密,更新姓名与手机号
* **方法路径**:POST /api/profile/password 与 /api/profile/update
GET /api/admin/表名/list21 张台账分页列表,巡查员仅开放 10 张只读子集
* **方法路径**:GET /api/admin/表名/list,需后台角色,支持 org 筛选 + kw 服务端搜索 + 分页
POST /api/admin/表名/add台账新增与维护,隐患流程字段被拦截保护
* **方法路径**:POST 同路径 add,POST 同路径 编号/update,POST 同路径 编号/delete
POST /api/admin/users/add新增改角色停用删除用户,保留至少一个可用管理员
* **方法路径**:POST 同路径 users/add 与 users/编号/update,仅公司管理员
POST /api/admin/hazard/编号/assign指定整改负责人责任单位与期限,自动生成 rectify 任务
* **方法路径**:POST /api/admin/hazard/编号/assign,需后台角色
POST /api/admin/hazard/编号/rectify负责人提交整改说明与佐证照片
* **方法路径**:POST /api/admin/hazard/编号/rectify,需登录且为负责人本人或管理员
POST /api/admin/hazard/编号/review通过则销号并办结任务,退回则回到整改中,销号必须写验收依据
* **方法路径**:POST /api/admin/hazard/编号/review,需后台角色
POST /api/admin/hazard/编号/major重大隐患挂牌督办与强制停工标记
* **方法路径**:POST /api/admin/hazard/编号/major,需后台角色
GET /api/admin/hazard/编号/detail基础信息加照片加流转时间线一站式查看
* **方法路径**:GET /api/admin/hazard/编号/detail,管理员与巡查员可读
POST /api/admin/material/编号/io原子加减库存并写流水,超库存直接拒绝
* **方法路径**:POST /api/admin/material/编号/io,需后台角色
POST /api/admin/risk/编号/review风险点复核登记并顺延下次复核
* **方法路径**:POST /api/admin/risk/编号/review,需后台角色
POST /api/admin/permit/编号/approve高风险作业多级审批与完工销项
* **方法路径**:POST /api/admin/permit/编号/approve,POST 同路径 /finish
GET /admin/export/表名全量台账 CSV 导出,培训进度可单独导出
* **方法路径**:GET /admin/export/表名,POST /api/admin/表名/import 做 CSV 批量导入(兼容 UTF-8-BOM 与 GBK)
GET /api/screen/data免登录公开访问,手机号脱敏,隐患明细仅白名单字段
* **方法路径**:GET /api/screen/data,30 秒服务端缓存
GET /health托管探活,附带数据库连通性
* **方法路径**:GET /health,免登录
POST /api/admin/training_courses/upload课程上传(视频/PDF/文档),org_id 自动取当前用户所属单位
* **方法路径**:POST /api/admin/training_courses/upload,需后台角色
部署形态
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 放行)