Codewith-Yogita/SafePath_HACKHAZARD_PROJECT

# 🌐 在线演示 ### 🚀 生产环境 https://safepath-hackhazard-project.onrender.com # 📖 概述 SafePath 是一个由社区驱动的应急响应平台，旨在通过将市民、志愿者和紧急服务连接在同一个平台上，来提升公共安全。 在紧急情况下，用户可以即时报告事件、请求援助、发现附近的紧急服务，并实时追踪救援进度。 该平台赋能经过认证的志愿者和管理员，让他们能够高效地协调救援行动，同时为市民提供一个简单且响应迅速的界面。 # 🏆 HackHazards 2026 参赛作品 ## 🎯 黑客松主题 **基础设施、出行与智能系统** 该领域侧重于开发能够改善大规模物理和数字系统的软件，包括交通、应急响应、智慧城市基础设施、出行解决方案、基于 IoT 的平台以及实时监控系统。 ## 🌟 主题契合度 SafePath 是作为 **基础设施、出行与智能系统** 主题下的一个解决方案而开发的。 该平台通过让市民、志愿者和管理员通过集中的数字平台进行高效协调，从而增强了应急响应能力。 ### SafePath 通过提供以下功能来契合该主题： - 🚨 实时紧急事件报告 - 🗺️ 实时定位与交互式地图 - 🚑 附近的紧急服务发现 - 👥 社区志愿者协调 - 📍 救援分配与追踪 - 🏥 智能应急资源管理 - 📊 用于紧急监控的管理面板 - ⚡ 在关键情况下实现更快的沟通 通过整合地图技术、安全的身份验证以及集中的应急管理，SafePath 有助于改善市民、志愿者和应急救援人员之间的协调，为构建更安全、更智能的社区做出贡献。 # 🚨 问题陈述 应急响应系统通常面临以下问题： - 沟通缓慢 - 应急援助延误 - 缺乏附近的志愿者协调 - 救援进度的可见性差 - 获取应急资源的途径有限 这些问题会增加响应时间并降低应急管理的有效性。 # 💡 我们的解决方案 SafePath 通过提供以下功能，弥合了需要帮助的人与响应者之间的差距： - 实时紧急报告 - 安全的身份验证系统 - 社区志愿者网络 - 实时救援状态追踪 - 附近的紧急服务 - 交互式地图 - 集中的管理员管理 该平台确保了更快的沟通和更有组织的应急协调。 # ✨ 核心功能 ## 👤 身份验证 - 安全的用户注册 - JWT 身份验证 - 登录与退出 - 受保护的路由 - 基于角色的访问控制 ## 🚨 应急管理 - 报告事件 - 紧急 SOS - 事件分类 - 实时救援追踪 - 报告历史 ## 🗺️ 智能地图 - 交互式 Leaflet 地图 - 用户实时定位 - 附近的医院 - 警察局 - 消防局 - 药店 - 志愿者 ## 👥 志愿者系统 - 志愿者注册 - 志愿者面板 - 申请审批 - 救援分配 - 救援状态更新 ## 🛠️ 管理员面板 - 管理员登录 - 面板分析 - 志愿者审批 - 事件管理 - 救援分配 - 用户管理 ## 📱 用户体验 - 完全响应式设计 - 简洁的 UI - 快速导航 - 移动端友好 - 现代化的面板 # 🛠️ 技术栈 ## 前端 - React 19 - Vite - React Router DOM - Axios - React Leaflet - Lucide React - CSS3 ## 后端 - Node.js - Express.js - JWT 身份验证 - REST API ## 数据库 - MongoDB Atlas - Mongoose ODM ## 部署 - Render: https://safepath-hackhazard-project.onrender.com/ - GitHub: https://github.com/Codewith-Yogita/SafePath_HACKHAZARD_PROJECT # 🏗️ 系统架构 ``` User │ ▼ React + Vite Frontend │ REST API Requests │ ▼ Node.js + Express API │ JWT Authentication │ ▼ MongoDB Atlas Database ``` # 📂 项目结构 ``` SafePath │ ├── backend │ ├── config │ ├── controllers │ ├── middleware │ ├── models │ ├── routes │ ├── utils │ ├── data │ └── server.js │ ├── frontend │ ├── public │ ├── src │ │ ├── components │ │ ├── pages │ │ ├── assets │ │ └── styles │ └── vite.config.js │ ├── README.md └── LICENSE ``` # 🚀 快速开始 ## 克隆仓库 ``` git clone https://github.com/Codewith-Yogita/SafePath_HACKHAZARD_PROJECT.git ``` ## 安装依赖项 ### 后端 ``` cd backend npm install ``` ### 前端 ``` cd frontend npm install ``` ## 环境变量 在后端文件夹中创建一个 `.env` 文件。 ``` PORT=5000 MONGODB_URI=Your_MongoDB_Atlas_URI JWT_SECRET=Your_JWT_Secret NODE_ENV=development ``` ## 运行后端 ``` cd backend npm run dev ``` ## 运行前端 ``` cd frontend npm run dev ``` # 📸 应用截图 ## 🏠 首页 ## 🔐 身份验证 ## 🗺️ 交互式地图 ## 🚨 报告事件 ## 👥 志愿者面板 ## 🛠️ 管理员面板 ## 📍 救援状态 # 🔒 安全功能 - JWT 身份验证 - 受保护的路由 - 基于角色的授权 - 密码哈希处理 (bcrypt) - MongoDB 验证 - 安全的 REST API # 📈 未来展望 - 实时 Socket.IO 通知 - 推送通知 - AI 事件检测 - 基于图像的事件验证 - 路线优化 - 多语言支持 - 离线应急模式 - 政府 API 集成 - 移动应用程序 - 应急聊天系统 # 👨‍💻 HEXORA 团队 | 姓名 | 角色 | |------|------| | **Yogita Sharma** | 团队负责人兼全栈开发 | | Sawal Pushkarna | 团队成员 | | Priyanshi | 团队成员 | | Manpreet Dhir | 团队成员 | # 🏆 黑客松 **活动** HACKHAZARDS '26 **主题** 基础设施、出行与智能系统 SafePath 的开发旨在通过技术改善应急响应，使社区能够利用现代 Web 技术在紧急情况下进行协作。 # 🤝 贡献 随时欢迎贡献。 1. Fork 该仓库 2. 创建你的功能分支 ``` git checkout -b feature-name ``` 3. 提交你的更改 ``` git commit -m "Added new feature" ``` 4. Push ``` git push origin feature-name ``` 5. 发起一个 Pull Request # 📄 许可证 基于 MIT 许可证分发。 查看 `LICENSE` 获取更多信息。 # ⭐ 支持 如果你觉得这个项目有用， 请考虑在 GitHub 上给它点个 ⭐。 这真的很有帮助！

标签：MERN, MITM代理, 全栈应用, 实时定位, 应急管理, 志愿者协调, 智慧城市, 自定义脚本