第 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(含中文表头),培训进度可单独导出