01 系统概述与架构

定位： 面向电力施工企业的安全生产全流程数字化管理平台，覆盖业主、施工、监理、监管四方协同，实现安全管理的标准化、透明化、可追溯。

功能全景

平台涵盖八大主菜单、20+业务模块，核心功能如下：

截图：侧边栏菜单全景

截图：工作台首页

技术架构

┌─────────────────────────────────────────────────────┐
│                    前端层 (PC / H5)                  │
│     Vue 3 + TypeScript + Element Plus / Vant        │
│     Pinia 状态管理 / Vue Router / WebSocket 客户端   │
└────────────────────┬────────────────────────────────┘
                     │ REST API (JSON) + WebSocket
┌────────────────────▼────────────────────────────────┐
│                   网关层 (Nginx)                     │
│             反向代理 / SSL 终止 / 限流 / 跨域         │
└────────────────────┬────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────┐
│                后端层 (Django 6.0)                   │
│  Django REST Framework / SimpleJWT / Channels       │
│  django-axes(登录锁定) / django-safedelete(软删除)   │
│  Celery + Redis (异步任务 + 消息队列)                │
│  django-guardian (对象级权限) / drf-spectacular (API)│
└────────────────────┬────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────┐
│                   数据层                             │
│   MySQL 8.0 / PostgreSQL / SQLite (开发)             │
│   Redis (缓存 + 会话 + WebSocket pub/sub)             │
│   + 文件存储 (本地 / OSS) + 日志审计 (JSON)           │
└─────────────────────────────────────────────────────┘

关键特性

• 认证： JWT + Token 双通道认证，支持 TOTP 双因素认证
• 通信： REST API + WebSocket 实时推送（通知、预警、待办更新）
• 部署： Docker 容器化（docker-compose），支持 dev / full / prod 三种 profile
• 移动端： H5 响应式前端（Vant UI），覆盖移动办公场景

适用对象

系统特性

• 等保 2.0 三级合规： 安全审计、访问控制、数据加密、剩余信息保护
• CA 电子签名： SM2/RSA 签名算法，证书管理 + 签名存证
• 移动端 H5： 核心业务移动化，支持现场拍照、定位、电子签名
• 字段级加密： 身份证号、手机号、地址等敏感信息自动加密存储
• 柔性安全删除： 软删除 + 安全擦除，满足等保 4.3.7 剩余信息保护
• 审计全追踪： AuditLog 模型自动记录所有关键操作，不可篡改
• PIPL 合规： 敏感信息单独同意机制，同意书文本留档

updated: 2026-06-07

02 安装部署与系统维护

面向运维人员： 环境要求、部署步骤、日常维护与故障处理。

🎯 选择部署模式

软件支持三种部署模式，同一套代码，不改程序，只改配置。用户根据自身需求选择即可。

💡 常见误解： 云部署 ≠ 数据上云。混合模式下，软件跑在云服务器上，但你的数据库和文件依然保存在公司内部服务器里。云服务器只是一个”远程操作台”，操作完的数据回传到你自己的数据库。

如何选择

┌ 数据必须留在企业内部？
├── 是 → 公司有运维能力？
│       ├── 是 → 🏢 本地部署（最简单）
│       └── 否 → 🔗 混合部署（云服务器算，数据留本地）
└── 否 → 公司有固定运维人员？
        ├── 有 → 🏢 本地部署
        └── 无 → ☁️ 云端部署（云服务商帮管数据库和备份）

环境要求

开发环境可使用 SQLite，生产环境推荐 MySQL 8.0 或 PostgreSQL。

Docker 部署（推荐）

前置准备

# 克隆项目
git clone <项目仓库地址> /opt/sa-power
cd /opt/sa-power

# 创建环境变量文件
cp .env.example .env
# 编辑 .env，填写 DJANGO_SECRET_KEY、MYSQL_ROOT_PASSWORD 等必要变量

启动服务

docker-compose.yml 位于项目根目录（src/docker-compose.yml），提供三种 profile：

# 开发模式（仅后端 + DB + Redis）
docker compose --profile dev up -d

# 完整模式（含前端 + Celery Worker + Beat）
docker compose --profile full up -d

# 生产模式（含 Nginx 反向代理）
docker compose --profile prod up -d

验证部署

# 检查容器状态
docker compose ps

# 查看后端日志
docker compose logs -f web

# 测试 API 是否正常
curl http://localhost:8000/api/health/

🔗 混合部署（计算上云·数据留本地）

应用服务器部署到云上，但数据库和上传文件留在公司内网。

部署拓扑

┌─ 云服务器 ─────────────────────┐
│  Django APP（Nginx + Gunicorn） │
│  前端 Vue （编译后静态文件）       │
│  Redis （缓存，可放云上）         │
└─────────────┬──────────────────┘
              │ VPN 加密隧道
┌─────────────▼──────────────────┐
│ 公司内网服务器                    │
│  MySQL 数据库                     │
│  上传文件存储（NFS / 本地磁盘）    │
│  （可选）敏感 Redis               │
└────────────────────────────────┘

操作步骤

1. 内网服务器 — 准备好 MySQL 服务器和文件存储目录

2. 建 VPN 隧道 — WireGuard（最简单）或 OpenVPN，打通云服务器和内网

   # 内网服务器上安装 WireGuard，分配一个虚拟 IP（如 10.0.0.2）
   # 云服务器上安装 WireGuard，也分配一个虚拟 IP（如 10.0.0.1）
   # 两边配好密钥对，互相能 ping 通即可

3. 云服务器 .env 配置 — 数据库地址指向内网 IP

   USE_MYSQL=True
   MYSQL_HOST=10.0.0.2    ← 内网数据库的 WireGuard IP
   MYSQL_PASSWORD=xxx
   FILE_STORAGE=local
   MEDIA_ROOT=/mnt/nfs/uploads  ← 或挂载内网的 NFS 共享目录

4. 正常启动云服务器上的 Docker 或手动部署

⚠️ 注意

• VPN 必须稳定，否则业务中断。建议设监控告警
• 内网数据库建议 crontab 每天自动备份
• 云服务器和内网之间的网络延迟不要超过 10ms

📋 三种模式一键切换

三种部署模式的区别就是 .env 配置文件里的几行参数不同，其他完全一样。

切换模式只需换 .env 文件 + 迁移数据，不涉及程序代码的任何修改。

从本地迁移到云端

如果之前用本地部署，现在想上云，数据迁移步骤：

# 1. 在本地服务器导出数据库
mysqldump -u root -p sa_power_db > export.sql

# 2. 把文件传到云服务器
scp export.sql user@云服务器:/tmp/

# 3. 导入云数据库
mysql -h 云数据库地址 -u admin -p sa_power_db < /tmp/export.sql

# 4. 上传文件从本地拷贝到云存储（OSS/S3）
# 5. 换 `.env` 配置，重启服务

手动部署

1. 后端（Django）

# 创建 Python 虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
export DJANGO_SECRET_KEY="your-generated-secret-key"
export DJANGO_DEBUG=False
export DJANGO_ALLOWED_HOSTS=localhost,your-domain.com
export USE_MYSQL=True
export MYSQL_PASSWORD=your-db-password

# 数据库迁移
python manage.py migrate

# 收集静态文件
python manage.py collectstatic --noinput

# 启动后端服务（开发）
python manage.py runserver 0.0.0.0:8000

# 或使用 Gunicorn（生产）
gunicorn config.wsgi:application -w 4 -b 0.0.0.0:8000

2. 前端（Vue 3）

cd frontend

# 安装依赖
npm install

# 编译生产版本
npm run build

# 开发模式（热更新）
npx vite --port 3000

3. 移动端 H5

cd h5

# 安装依赖
npm install

# 编译
npm run build

# 开发模式
npx vite --port 3002

Nginx 配置

项目根目录提供 src/nginx.conf 配置文件。典型配置要点：

# API 反向代理
location /api/ {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# WebSocket 代理
location /ws/ {
    proxy_pass http://127.0.0.1:8000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

# 前端静态文件
location / {
    root /path/to/frontend/dist;
    try_files $uri $uri/ /index.html;
}

安全提示： 生产环境请配置 SSL 证书（Let’s Encrypt 免费证书），并开启 HSTS。

日常维护

数据库备份

本地部署 / 混合部署：

# MySQL 备份到内网存储
mysqldump -u root -p sa_power_db > /data/backup/backup_$(date +%Y%m%d).sql

# 建议设置 crontab 自动备份
0 2 * * * mysqldump -u root -p密码 sa_power_db > /data/backup/daily_$(date +\%Y\%m\%d).sql

云端部署： - 使用云数据库的自动备份功能（阿里云 RDS 每天自动备份，保留 7~30 天） - 也可每月一次手动拉回本地存档

mysqldump -h 云数据库地址 -u admin -p sa_power_db > local_backup_$(date +%Y%m%d).sql

数据库恢复

# MySQL 恢复
mysql -u root -p sa_power_db < backup_20260601.sql
python manage.py migrate

日志查看

# Django 应用日志
tail -f logs/app.log

# 审计日志
tail -f logs/audit.log

# Docker 日志
docker compose logs -f --tail=100 web

升级更新

# 拉取最新代码
git pull

# 更新后端依赖
source .venv/bin/activate
pip install -r requirements.txt

# 执行数据库迁移
python manage.py migrate

# 更新前端
cd frontend && npm install && npm run build

# 重启服务
# Docker 部署：
docker compose restart web

# 手动部署：
systemctl restart sa-power  # 或 supervisorctl restart

常见故障处理

端口占用

# 检查端口占用
lsof -i :8000

# 终止占用进程
kill -9 <PID>

# 或更换端口
python manage.py runserver 0.0.0.0:8001

数据库连接失败

# 检查数据库服务是否运行
systemctl status mysql

# 检查数据库凭证（.env 文件）
# 确认 DB_NAME / DB_USER / DB_PASSWORD 正确

# 测试连接
mysql -u sa_power_user -p -h 127.0.0.1 -e "SELECT 1"

权限错误

# 检查文件权限
ls -la db.sqlite3
chmod 644 db.sqlite3

# Django 密钥检查
# 确保 DJANGO_SECRET_KEY 环境变量已设置且有效

# 日志文件权限
chmod -R 755 logs/

WebSocket 连接失败

# 确认 daphne/Channels 已运行
# 生产环境需配置 Nginx WebSocket 代理（参见上方 Nginx 配置）
# 检查 Redis 是否可访问
redis-cli ping  # 应返回 PONG

03 数据安全与合规

面向系统管理员： 平台内置的安全机制与合规保障，帮助您满足等保 2.0 三级、数据安全法等监管要求。

数据加密

字段级加密

平台对敏感数据采用 EncryptedCharField / EncryptedTextField 自动加密：

加密密钥从 DJANGO_SECRET_KEY 派生，或通过 ENCRYPTION_KEY 环境变量独立设置。

存储加密

• 数据库连接支持 SSL 加密（生产环境强制）
• 密码使用 Argon2 / PBKDF2 哈希存储（非明文）
• 文件上传默认权限为 0o640，防止未授权访问

TOTP 双因素认证

截图：双因素认证设置界面

• 支持 Google Authenticator / Authy 等标准 TOTP 应用
• 密钥加密存储，防止泄露
• 连续失败锁定 + 恢复码机制
• 记录所有 2FA 操作至审计日志

权限模型（RBAC）

8 种角色 + 39 项授权码

平台采用精细化的 基于角色的访问控制（RBAC），权限颗粒度细至单操作：

8 种角色权限对比：

授权管理

• 通过 grant_role_permissions() 自动为用户分配角色权限
• 可在”授权管理”页面查看/修改用户的具体授权码
• 权限范围支持限定到具体项目

审计日志

所有关键操作由 AuditLog 模型自动记录，支持：

• 操作人（Who）：谁执行了操作
• 操作时间（When）：精确到秒的时间戳
• 操作类型（What）：增/删/改/查/登录等
• 操作对象（Which）：被操作的数据类型和 ID
• IP 地址（Where）：操作来源 IP
• 变更内容（Detail）：变更前后的数据摘要

审计日志通过 AuditModel 基类自动集成，新增模型只需继承即可获得审计能力。审计日志不可删除（仅软删除），满足等保 4.1.6 审计要求。

截图：审计日志列表

提示： 管理员可在「系统管理 → 审计日志」页面查看和搜索所有日志记录。

等保 2.0 三级合规

隐私保护（PIPL 合规）

依据《个人信息保护法》第 29 条，敏感个人信息需取得个人单独同意：

• 身份证号、手机号、家庭住址等敏感信息有独立的 *_consent 布尔字段
• 记录同意时间和同意书文本（*_consent_date、*_consent_text）
• 支持查看和撤回同意

会话管理

安全建议

作为系统管理员，建议定期执行以下操作：

1. 密钥轮换： 定期更新 DJANGO_SECRET_KEY，执行字段重加密
2. 证书管理： 监控 CA 证书到期时间，提前续期
3. 审计审查： 每周查看审计日志，关注异常登录行为
4. 权限审计： 每月审查用户角色和授权码，清理过期授权
5. 备份验证： 定期测试备份恢复流程，确保备份可用
6. 日志归档： 按合规要求归档审计日志，保存不少于 3 年

04 系统设置与管理

系统设置与管理模块涵盖用户管理、角色权限、通知模板配置、系统配置、授权码管理和电子档案归档管理六大功能，是整个系统的运维管理中心。

用户管理

截图：用户管理列表

系统通过 Django 认证体系 + 员工信息模型实现用户全生命周期管理。用户账号自动关联员工信息，手机号作为登录用户名。

功能说明

• 创建用户：通过新增员工自动生成系统账号（手机号=用户名）
• 编辑用户：修改用户基本信息，关联员工信息
• 启用/禁用：设置账号激活状态，禁用后无法登录
• 邀请注册：生成邀请码，支持用户自助注册

操作步骤

新建用户 → 创建员工自动生成账号

1. 左侧菜单点击 系统设置 → 用户管理
2. 点击 新增员工 按钮
3. 填写员工信息：
   • 姓名、手机号、身份证号（加密存储，PIPL 合规）
   • 部门、岗位、角色类型
   • 所属公司、项目、团队
4. 点击 保存
5. 系统自动完成：
   • 生成永久工号（格式：E26001）
   • 创建系统账号（手机号为用户名，随机密码，未激活）
   • 根据角色类型自动授予授权码
   • 自动生成邀请码

编辑用户信息

1. 点击用户列表中的 编辑 按钮
2. 修改员工信息（手机号、姓名、岗位等）
3. 点击 保存
4. 员工永久工号不可修改，岗位编码随调动自动变更

禁用/启用用户账号

1. 在用户列表选中目标用户
2. 点击 禁用/启用 切换按钮
3. 启用状态 True → 正常登录；False → 禁止登录

数据隐私说明

• 身份证号、手机号、地址等敏感字段使用 EncryptedCharField 加密存储
• 根据《个人信息保护法》(PIPL) 需获取用户单独同意（id_card_consent、phone_consent）
• 支持同意撤回功能

角色权限管理

采用 RBAC（Role-Based Access Control）模型，包含 8 种预设角色和 39 项授权码。

八种预设角色

39 项授权码

授权码按功能域分为以下几类：

危险作业审批 permit_create | permit_approve_1 | permit_approve_2 | permit_approve_3 permit_issue | permit_close

分包与危大工程 subcontract_approve | subcontract_audit | hazard_eng_manage

安全教育培训 train_org_company | train_org_project | train_org_team | train_exam

安全技术交底 disclosure_give | disclosure_receive

违章与检查 violation_entry | violation_process | inspection_exec

事故管理 accident_report | accident_investigate

证书与方案 cert_manage | plan_edit | plan_approve

班前会 meeting_org | meeting_review | meeting_participate

安全检查与防护 safety_confirm | hazard_report | safety_officer_report | ppe_confirm

数据查看范围 view_self | view_team | view_squad | view_project | view_all

系统管理 sys_user | sys_auth | sys_config | sys_audit

操作步骤

为用户分配角色

1. 左侧菜单点击 系统设置 → 角色权限
2. 点击 分配角色
3. 选择目标用户
4. 选择角色（如：“项目经理”）
5. 系统自动：检查是否在可授权范围内 → 创建 UserRole 记录 → 批量授予该角色的所有授权码

手动配置授权码

1. 点击 授权管理
2. 选择目标用户
3. 勾选需要授予的授权码
4. 设置授权范围（公司级/项目级）
5. 填写授权人
6. 设置有效期（可选）
7. 点击 批量授权
8. 系统记录授权时间、授权人用于审计追踪

撤销授权

1. 在授权管理中找到目标用户
2. 查看当前授权清单
3. 勾选需要撤销的授权码
4. 点击 批量撤销
5. 系统将 is_active 设置为 False（不删除记录，保证审计链完整性）

安全管理机构

系统支持配置安全生产委员会、项目安全领导小组等机构：

1. 点击 安全管理机构
2. 点击 新建机构
3. 选择机构类型（公司安全生产委员会/项目安全生产领导小组/班组安全小组）
4. 添加成员并指定职务（主任/副主任/安全主管/安全员等）
5. 支持机构解散操作（自动停用所有成员）

通知模板配置

系统提供多通道通知能力，支持站内信、邮件、短信和 WebSocket 推送。

模板类型

操作步骤

编辑通知模板

1. 左侧菜单点击 系统设置 → 通知模板
2. 选择要编辑的模板
3. 使用 Jinja2 语法编辑标题和内容模板
   • 标题模板示例：{{ hazard.title }} - 重大隐患上报
   • 内容模板支持变量注入
4. 点击 保存
5. 可通过 启用/禁用 开关控制模板是否生效

配置升级规则

支持隐患超期未审、整改超期未完、证书即将过期、工作票逾期四类事件的逐级升级：

1. 点击 通知设置 → 升级规则
2. 选择触发事件类型
3. 配置：升级等级（1/2/3）→ 触发延迟（小时）→ 目标角色
4. 级别 1 → 安全员，级别 2 → 项目经理，级别 3 → 安全总监/公司负责人
5. 点击 保存

系统配置项

系统配置通过 SystemConfig 模型管理，支持安全策略、密码策略、会话超时等功能。

配置说明

操作步骤

1. 左侧菜单点击 系统设置 → 系统配置
2. 在配置列表中找到需要修改的配置项
3. 点击 编辑
4. 输入新的配置值
5. 点击 保存
6. 系统自动记录变更日志到 ConfigChangeLog

安全特性

• 双因素认证 (2FA)：支持 TOTP（基于时间的一次性密码），兼容 Google Authenticator / Microsoft Authenticator
• API 密钥管理：支持生成和管理 API Key，用于程序化接口调用
• 速率限制：登录接口 10 次/小时，敏感操作限流
• 会话管理：Token 认证机制，支持多种认证后端
• 审计日志：所有配置变更记录到 AuditLog

授权码管理

授权（Authorization）是系统的最小权限单元，每个授权码对应一个具体操作。

授权码结构与作用

• 授权码（auth_code）：程序唯一标识（如 permit_create）
• 授权名称（auth_name）：中文描述（如”新建作业票”）
• 授权范围（project）：公司级或特定项目
• 有效期（expire_at）：支持限时授权

操作步骤

查看用户授权清单

1. 点击 授权管理 → 用户授权
2. 搜索目标用户
3. 查看该用户所有已授权和已撤销的授权码
4. 可筛选查看有效/全部授权

批量授予/撤销

1. 选择 批量授权 功能
2. 选择目标用户（仅可向下级人员授权）
3. 勾选授权码集合
4. 点击 确认 执行

角色一键授权

1. 选择 角色模板授权
2. 选择角色类型（如”项目安全员”）
3. 系统自动加载预设的授权码集合
4. 点击 确认 一键授予

授权范围规则

• 超级管理员拥有全部授权，不依赖 Authorization 记录
• 非管理员只能给可授权范围内的下级人员授权
• 授权范围逻辑：同项目下的人员可互相授权（取决于数据查看范围）

电子档案归档管理

系统支持按制度要求自动创建和管理电子档案，符合等保 2.0 合规要求。

档案分类

按 7 大类 76 项进行归档：

档案生命周期

收集中 → 待冻结 → 已冻结 → 补录窗口期 → 已封存 → 待销毁 → 已销毁

操作步骤

创建归档

1. 左侧菜单点击 系统设置 → 电子档案
2. 点击 新建归档
3. 选择归档分类（7 大类）
4. 系统自动生成归档编号（格式：YEAR-CAT-SEQ）
5. 填写档案标题、来源模块、保管期限
6. 上传归档文件（支持 PDF/A、JSON 快照、影像图片）
7. 点击 保存 → 状态为”收集中”
8. 可追加多个文件到同一归档记录

冻结与封存

1. 归档记录准备完成后，点击 冻结
2. 系统提示：冻结后不可随意修改
3. 确认后：记录状态变为”已冻结”，记录冻结人、冻结时间
4. 冻结后自动进入补录窗口期（默认 365 天）
5. 窗口期满自动封存（sealed）

档案销毁

1. 选择 待销毁 状态的档案记录
2. 点击 销毁审批 → 填写销毁原因
3. 指定批准人和监销人
4. 确认销毁（不可逆操作）
5. 系统保留销毁记录（destroy_date、destroy_reason）
6. 档案状态变为”已销毁”

安全特性

• 哈希链验证：每条记录保存前一条的 SHA256 哈希，形成防篡改链
• 只追加不删除：归档数据不可篡改，软删除保护
• 审计留痕：所有操作（创建/查阅/下载/打印/销毁）记录到 ArchiveLog
• 密级管理：支持公开/内部/机密/秘密四级密控

归档的原则：归档操作必须人工完成，系统不会自动冻结。归档后的数据不可篡改，只能追加材料直到封存。

05 组织架构与项目管理

面向系统管理员： 组织架构是系统运行的基础骨架，合理的组织层级设计决定了权限分配、审批流程和数据隔离的有效性。

一、组织架构管理

1.1 组织层级设计

截图：人员管理列表

系统支持四级组织层级：

创建组织： 1. 进入【组织架构】页面，默认展示树形结构 2. 点击父级组织的【添加子级】按钮 3. 填写组织名称、类型、负责人等信息 4. 点击【保存】完成创建

1.2 组织调整

支持的操作： - 编辑组织信息 - 调整组织层级 - 停用/启用组织 - 查看组织下的人员和设备

二、项目管理

项目管理是在组织架构基础上的进一步细化，用于管理不同工程项目的业务数据。

项目管理要点： - 项目需挂靠在某个部门或项目部下 - 项目可设置专属的安全目标、检查计划 - 项目数据默认隔离，不同项目间不可见