数据库表结构 · 安全生产一体化管理平台展示说明书架构日志
第 11 章

🗄️数据库表结构

技术参考

PostgreSQL 专库 172.168.10.17:5432/tk_safe_xc,共 36 张表。数据库是整个平台的"记忆中心",所有隐患、用户、台账数据都存在这里。SQLite 已下线,data/ 下如有旧库文件均为历史残留。


核心表关系图

erDiagram
    ORGANIZATIONS ||--o{ USERS : "拥有"
    ORGANIZATIONS ||--o{ EQUIPMENT : "拥有"
    ORGANIZATIONS ||--o{ HAZARDS : "发生"
    ORGANIZATIONS ||--o{ RISK_POINTS : "分布"
    ORGANIZATIONS ||--o{ TASKS : "派发"
    USERS ||--o{ HAZARDS : "上报"
    USERS ||--o{ TASKS : "负责"
    USERS ||--o{ LOGS : "操作"
    HAZARDS ||--o{ HAZARD_FLOW : "流转"
    RISK_POINTS ||--o{ RISK_REVIEWS : "复核"
    TRAINING_COURSES ||--o{ TRAINING_LESSONS : "课时"
    TRAINING_COURSES ||--o{ TRAINING_RECORDS : "学习"
    TRAINING_LESSONS ||--o{ TRAINING_NOTES : "笔记"
    MATERIALS ||--o{ MATERIAL_IO : "出入库"

    ORGANIZATIONS {
        int id PK
        string name
        int parent_id
    }
    USERS {
        int id PK
        string username
        string password_hash
        string role
        int org_id FK
    }
    HAZARDS {
        int id PK
        string title
        string level
        int org_id FK
        int reporter_id FK
        string status
    }
    TASKS {
        int id PK
        int hazard_id FK
        int assignee_id FK
        date deadline
        string status
    }
    LOGS {
        int id PK
        int user_id FK
        string action
        string ip
        datetime created_at
    }

表分类总览

分类 主要表 作用
基础台账 organizations equipment personnel related_parties materials material_io 录入组织、设备、人员、合作方、物资及出入库流水
隐患管理 hazards hazard_flow tasks 隐患上报、流转、整改、闭环
风险管控 risk_points risk_reviews risk_reports violation_reports 双重预防 - 风险点复核、风险报备、违规上报
培训管理 training_courses training_lessons training_records training_lesson_progress training_notes training_certificates training_plans 课程、课时、签到、进度、笔记、证书、计划
应急管理 emergency_plans drill_records contacts 预案、演练记录、应急通讯录
作业许可 work_permits 动火/有限空间/高处等高风险作业审批与销项
巡查管理 patrol_plans patrol_records 巡查计划、打卡记录
专项与报表 special_actions reports assessment 七大专项整治、统计报表、考核评分
系统表 users logs site_settings schema_migrations message_templates alert_rules 账号、操作留痕、站点配置、结构版本、消息模板、预警规则

通用字段约定

多数业务表包含以下基础字段:

  • id —— 自增主键(PG SERIAL)
  • created_at —— 创建时间(YYYY-MM-DD HH:MM:SS 文本)
  • org_id —— 经营主体关联(多数业务表都有,用于按单位筛选)
  • 照片字段(photos/rectify_photos)—— 存 JSON 数组,只收本站 /uploads/ 路径

多租户隔离机制

平台用角色 + 经营主体(org_id)做数据隔离:

  • 公司管理员:全部数据
  • 子公司安管:后台台账与治理操作
  • 巡查员:隐患、巡查、风险点等 10 张台账只读
  • 商户/员工:移动端上报、本人任务、本人记录
  • 停用或删除账号:已有会话立即失效,不可再操作

治理与维护

  • 数据治理:govern_data.py 默认只预览,确认后加 --apply 才执行清理(孤儿记录、测试残留)
  • 操作留痕:关键动作同步写入 logs 表,可在后台导出审计
  • 数据导出:管理员可在后台按表导出 CSV(含中文表头),培训进度可单独导出