# 环境依赖清单

项目：智慧停车综合管理平台（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 |

> 交付上线前务必修改默认密码，并限制数据库端口暴露。