HazardMind - 一站式企业安全隐患智能管控平台

HazardMind 是一款现代化的企业级安全隐患“发现-审核-整改-验收”全闭环智能管理系统。本项目由后台管理系统 (Web)、后端服务 (API) 和移动端小程序 (uni-app x) 三大核心部分组成，旨在帮助企业建立高效、透明且自动化的安全生产防范体系。

🌐 官方在线体验与宣传：

• 后台管理系统 Demo：https://yhgl-admin.sumpeer.com/login
• 作者 B 站主页（视频演示/技术分享）：https://space.bilibili.com/397296484

---

🌟 核心特性

• 🔄 闭环隐患流转流程：支持隐患“现场拍照上报 -> 管理员审核分派 -> 责任人限期整改 -> 验收人闭环归档”的全流程流转。
• 📊 可视化智能看板：Admin 端内置丰富的 ECharts 可视化图表，实时展示隐患分类占比、整改完成率及多维度趋势分析。
• 👥 多租户与数据隔离：后端预留并支持多租户（Tenant）设计，保障不同机构之间的数据隐私与隔离。
• 📱 跨平台全端体验：移动端小程序基于最新的 uni-app x 框架开发，采用 UTS 与 Vue 3 技术栈，原生支持微信小程序，并具备向 iOS/Android/鸿蒙原生端无缝移植的能力。
• 🚀 极速现代化架构：前端采用 Vite 8 极速构建，后端搭载 FastAPI 异步框架，提供毫秒级响应响应。

---

📸 系统效果演示

📱 小程序首页

📱 隐患整改详情

📊 管理端月度统计报表

---

📂 项目结构

HazardMind/
├── backend/            # 后端 Python API 服务 (FastAPI)
├── admin/              # 后端管理系统网页端 (React 19 + Antd 6)
├── wxapp/              # 移动端/微信小程序 (uni-app x / UTS)
└── docs/               # (本地保留) 设计文档与开发指南 (已加入 Git 忽略)

---

🛠️ 快速启动指南

1. 后端服务 (backend)

后端使用 FastAPI 作为 Web 框架，默认使用 SQLite 数据库进行快速开发调试，支持切换 PostgreSQL。

环境要求

• Python 3.10+
• pip 或 uv (推荐)

运行步骤

1. 进入后端目录：

   cd backend

2. 创建并激活虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # macOS/Linux
   # Windows 使用: .venv\Scripts\activate

3. 安装依赖：

   pip install -r requirements.txt

4. 配置文件： 将 .env.example 复制并重命名为 .env，然后填写您自己的配置项（如微信小程序密钥等）：

   cp .env.example .env

5. 运行数据库迁移 (Alembic)：

   alembic upgrade head

6. 启动开发服务器：

   uvicorn main:app --reload --port 8000

   启动后，可直接在浏览器中访问接口文档：
   • Swagger UI: http://localhost:8000/docs
   • ReDoc: http://localhost:8000/redoc

---

2. 后端管理网页端 (admin)

管理端基于 React 19、Vite 8 和 Ant Design 6 开发，提供安全主管使用的全局统计看板和隐患流转系统。

🌐 在线演示体验：

• 后台管理系统 Demo：点击访问在线演示系统

环境要求

• Node.js 18+
• npm / yarn / pnpm

运行步骤

1. 进入管理端目录：

   cd admin

2. 安装依赖：

   npm install

3. 运行开发服务器：

   npm run dev

   默认启动地址：http://localhost:5173。开发环境下的 API 请求将自动代理至后端的 http://localhost:8000 服务。

---

3. 移动端微信小程序 (wxapp)

小程序使用 DCloud 最新推出的 uni-app x 高性能跨平台技术进行开发，采用纯 UTS (uni-app Typescript) 强类型编写。

编译要求

• HBuilderX (推荐安装最新 Alpha 或 Beta 版以获得最佳的 uni-app x 支持)
• 微信开发者工具

运行步骤

1. 打开 HBuilderX，选择 文件 -> 导入 -> 本地目录，将 wxapp 目录导入。
2. 打开 manifest.json 与 project.config.json，在对应的微信小程序配置项中，填入您的微信小程序 AppID。
3. 在 HBuilderX 工具栏上方，点击 运行 -> 运行到小程序模拟器 -> 微信开发者工具。
4. 编译完成后，微信开发者工具将自动唤起，即可进行端侧的隐患流转、照片上报调试。

(注意：在小程序内与后端通信时，请确保将 wxapp/utils/request.uts 中请求的后端 BaseURL 修改为您本机的局域网 IP 或生产服务域名)

---

🔒 隐私与开源安全说明

• 本项目在开源时已剔除所有的硬编码 WECHAT_APPID、WECHAT_SECRET 等敏感凭证。
• 本地开发中使用的私密配置已放入被 Git 忽略的 backend/.env 中。
• 本地历史提交记录已做全面脱敏合并处理。

---

📄 开源许可证

本项目采用 MIT License 许可证开源。您可以自由地修改、分发或用于商业项目中，但请保留原作者的版权声明。