交付包补充解压内容双存档：README/截图x12/录屏/文档，更新登记与.gitignore放行mp4

2026-10-13 13:47:00 +08:00
parent 85219b8ee3
commit d5ff06d723
34 changed files with 524 additions and 22 deletions
@@ -0,0 +1,68 @@
+# 环境依赖清单
+
+项目：智慧停车综合管理平台（Smart Parking Platform）
+版本日期：2026-10-10
+
+## 1. 基础运行环境
+
+| 组件 | 版本要求 | 用途 | 备注 |
+| --- | --- | --- | --- |
+| Docker Engine | 20.10+ | 容器运行时 | Linux 官方源 / Windows Docker Desktop |
+| Docker Compose | v2.0+ | 多容器编排 | `docker compose` 子命令形式 |
+| 操作系统 | Linux（内核 4.x+）/ Windows 10+ / macOS | 宿主机 | 生产推荐 Linux |
+| 浏览器 | Chrome / Edge / Firefox 最新版 | 前端访问 | 需支持 HLS、ES2020 |
+
+## 2. 容器化组件（由 docker-compose 自动拉取/构建，无需手动安装）
+
+| 组件 | 版本 | 用途 | 默认宿主端口 |
+| --- | --- | --- | --- |
+| 前端（Umi4 静态资源） | 随构建 | Web 界面 | 4010 → 容器 80 |
+| 后端（NestJS） | Node 运行时 | REST API + WebSocket | 同 4010（Nginx 反代） |
+| MySQL | 8.0 | 业务数据库 | 4012 → 3306 |
+| Nginx-RTMP / FFmpeg | - | RTMP 收流、HLS 分发 | 4015 → 1935 |
+
+## 3. 本地开发依赖（非 Docker 手动部署时）
+
+### 3.1 前端
+
+- Node.js 16+（建议 18 LTS）
+- 包管理器：npm / pnpm（注意 lockfile 版本匹配；如 pnpm 与 lockfile 冲突可直接使用本地 `node_modules/.bin/umi`）
+- 关键依赖：Umi 4、React 18、Ant Design 5、Leaflet、hls.js
+
+### 3.2 后端
+
+- Node.js 16+（建议 18 LTS）
+- 关键依赖：NestJS、TypeScript、MySQL 驱动、JWT、WebSocket（ws）
+- 外部服务：可连接的 MySQL 8.0 实例
+
+### 3.3 监控算法端（ai-end）
+
+- Python 3.9+
+- 关键依赖：Ultralytics YOLO、OpenCV、FFmpeg（系统二进制）、WebSocket 客户端
+- 模型文件：`yolov8n.pt`（项目内已附带轻量版，可按需更换）
+- 可选：NVIDIA GPU + CUDA 以加速推理
+
+## 4. 网络与端口
+
+| 端口 | 协议 | 方向 | 说明 |
+| --- | --- | --- | --- |
+| 4010（可配置） | TCP/HTTP | 入站 | Web 访问、API、HLS |
+| 4012（可配置） | TCP | 内部 | MySQL，建议不对公网开放 |
+| 4015（可配置） | TCP | 入站 | RTMP 推流 |
+| 摄像头源端口 | TCP/UDP | 出站 | 访问摄像头 RTSP/RTMP 源 |
+
+## 5. AI 对话可选依赖
+
+- [TokenFree](https://www.tokenfree.com/) 账号及 API Key（`sk-` 开头）
+- 默认接口地址：`https://www.tokenfree.com/v1`
+- 默认模型：`kimi-k2.6`
+- 浏览器需能访问该接口地址（出网）
+
+## 6. 默认账号（来源：backend/src/database-seeder.ts）
+
+| 角色 | 账号 | 密码 |
+| --- | --- | --- |
+| 管理员 | admin | admin123 |
+| 操作员 | operator | 123456 |
+
+> 交付上线前务必修改默认密码，并限制数据库端口暴露。