智能游客安全与监控系统

面向游客的实时安全平台 — 数字身份验证、实时 GPS 跟踪、紧急 SOS 和 AI 助手。

功能 · 架构 · 快速开始 · 文档 · 贡献

## 功能 | 功能 | 描述 | |---------|-------------| | **数字身份 + QR** | 加密验证身份（HMAC 签名，24 小时有效期） | | **实时 GPS 跟踪** | 通过 WebSocket 广播实时位置 | | **SOS 警报** | 一键紧急求助按钮，支持 9 种警报类型 + SMS 通知 | | **AI 助手** | 由 OpenRouter 提供支持的旅游专属聊天机器人 | | **天气数据** | 15 个以上尼泊尔旅游目的地的实时天气状况与未来 5 天预报 | | **管理后台** | 实时地图、警报管理、实时活动流 | | **基于角色的访问控制** | tourist / admin / police / authority，带有 JWT 守卫 | | **离线 Mesh 网络** | 无需互联网，通过 BLE 点对点中继 SOS/位置信息 | | **批量验证** | 一次性验证最多 100 个游客 ID | ## 架构 ``` ┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │ Mobile App │────▶│ Admin Dash │ │ MySQL DB │ │ (Expo/RN) │ │ (React/Vite)│ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ │ ┌──────────────┴──────────────┐ │ └─────│ NestJS Backend API │─────┘ │ (REST + WebSocket + Auth) │ └──────────────┬──────────────┘ │ ┌───────┴────────┐ │ Offline Mesh │ │ (BLE P2P) │ └────────────────┘ ``` ## 快速开始 ### 前置条件 - Node.js >= 20 - pnpm >= 9 - Docker & Docker Compose ### 1. 克隆并安装 ``` git clone https://github.com/your-org/tourist-safety-system.git cd tourist-safety-system pnpm install ``` ### 2. 配置环境 ``` cp .env.example .env cp apps/backend/.env.example apps/backend/.env cp apps/mobile/.env.example apps/mobile/.env ``` ### 3. 启动基础设施 ``` docker compose -f docker/docker-compose.dev.yml up -d mysql ``` ### 4. 运行服务 ``` # 后端 API (port 5000) pnpm backend:dev # Admin Dashboard (port 3000) pnpm admin:dev # 移动 App pnpm mobile:dev ``` ### 5. 初始化数据库 ``` pnpm db:seed ``` **测试账号凭据：** | 邮箱 | 密码 | 角色 | |-------|----------|------| | admin@touristsafety.com | admin123 | admin | | police@touristsafety.com | admin123 | police | | tourist1@test.com | admin123 | tourist | | tourist2@test.com | admin123 | tourist | ### 生产环境部署 ``` docker compose -f docker/docker-compose.yml up -d ``` ## 文档 - [系统架构](docs/SYSTEM_ARCHITECTURE.md) — 详细的模块拆解、数据库 schema、API 路由、WebSocket 事件 - [贡献指南](CONTRIBUTING.md) — 开发工作流与规范 - [安全性](SECURITY.md) — 漏洞报告与安全最佳实践 ## 技术栈 | 层级 | 技术 | |-------|-----------| | Monorepo | pnpm workspaces | | 后端 | NestJS, TypeORM, MySQL, Socket.IO | | 管理后台 | React 19, Vite, Tailwind CSS, Leaflet, Recharts | | 移动端 | Expo, React Native, Expo Router | | 身份验证 | Passport, JWT, bcryptjs | | 实时通信 | Socket.IO (WebSocket) | | 离线 | BLE (Bluetooth Low Energy) | ## 许可证 [MIT](LICENSE)

标签：GPS定位, React Native, WebSocket, 依赖分析, 库, 应急响应, 智慧旅游, 自动化攻击, 请求拦截