Standardize SurClaw ports away from defaults

- Change the API default listen port from 3000 to 3100 and include the Docker frontend origin in default CORS.

- Point Vite's default API proxy, Docker API container port, and Nginx upstream to 3100.

- Keep Docker host ports on 4002 for web, 3002 for API, and 5433 for PostgreSQL.

- Update environment examples and documentation to remove stale localhost:3000 guidance.

docs/README.md

@@ -29,6 +29,6 @@
 - 技术栈：React 19、TypeScript、Vite 6、Tailwind CSS 4、React Router DOM 7、NestJS、Prisma、PostgreSQL。
 - 应用类型：前端 SPA + NestJS API。登录、报告、模板、用户管理、部门模板授权、系统设置和签名文件已接入后端，其余主业务页面仍处于迁移期。
 - 数据层：认证用户、报告、报告媒体关系、模板、字段库、模板图片资源、视频/关键帧文件、用户管理、部门模板授权、系统设置和签名文件来自 PostgreSQL/后端文件目录。
-- 本地开发端口：前端 `3001`，后端 API `3000`；Docker Compose 暴露 API 到宿主机 `3002`。
+- 本地开发端口：前端 `3001`，后端 API `3100`；Docker Compose 暴露 API 到宿主机 `3002`。
 - 默认账号：`admin / 123456`、`manager / 123456`、`0001 / 123456`。
 - 核心代码目录：`src/pages`、`src/components`、`src/utils`、`src/types.ts`。

docs/deployment.md

@@ -10,7 +10,7 @@ npm run dev
 ```
 
 开发服务监听 `0.0.0.0:3001`。
-开发模式下 Vite 会把 `/api` 代理到 `VITE_API_PROXY_TARGET`，默认 `http://localhost:3000`。
+开发模式下 Vite 会把 `/api` 代理到 `VITE_API_PROXY_TARGET`，默认 `http://localhost:3100`。
 
 后端：
 
@@ -20,10 +20,10 @@ npm run prisma:generate
 npm run server:dev
 ```
 
-本地直接运行 API 默认监听 `0.0.0.0:3000`，健康检查为：
+本地直接运行 API 默认监听 `0.0.0.0:3100`，健康检查为：
 
 ```text
-http://localhost:3000/api/health
+http://localhost:3100/api/health
 ```
 
 如需连接真实 PostgreSQL：
@@ -56,13 +56,13 @@ AI 和语音密钥由后端 Settings API 保存并由代理使用，前端不再
 
 后端新增变量：
 
-- `API_PORT`：API 监听端口。本地直接运行默认 `3000`；Docker Compose 暴露到宿主机的默认端口是 `3002`。
+- `API_PORT`：API 监听端口。本地直接运行默认 `3100`；Docker Compose 暴露到宿主机的默认端口是 `3002`。
 - `CORS_ORIGIN`：允许跨域携带 Cookie 的前端来源。
 - `DATABASE_URL`：PostgreSQL 连接串。Docker Compose 暴露到宿主机的默认端口是 `5433`，容器内部仍使用 `db:5432`。
 - `SESSION_SECRET`：Session Cookie 签名密钥。
 - `SESSION_COOKIE_SECURE`：是否只通过 HTTPS 发送 Session Cookie。本地 HTTP/Compose 默认 `false`，生产 HTTPS 应设为 `true`。
 - `FILE_STORAGE_DIR`：后端文件目录。Docker Compose 默认 `/app/uploads`，并挂载到 `uploads_data` volume。
-- `VITE_API_PROXY_TARGET`：前端开发服务器 `/api` 代理目标。直接运行后端用 `http://localhost:3000`；连接 Docker Compose API 用 `http://localhost:3002`。
+- `VITE_API_PROXY_TARGET`：前端开发服务器 `/api` 代理目标。直接运行后端用 `http://localhost:3100`；连接 Docker Compose API 用 `http://localhost:3002`。
 - `VITE_ENABLE_LOCAL_FALLBACK`：生产构建是否允许本地兼容回退。开发模式默认启用，生产默认关闭。
 
 ## Docker 部署

docs/progress.md

@@ -54,7 +54,8 @@
 | 日期 | 事项 |
 | --- | --- |
 | 2026-05-01 | 新增 `docs/` 文档结构，梳理当前需求、设计、模块和风险。 |
-| 2026-05-01 | 本地开发端口从 `3000` 调整为 `3001`。 |
+| 2026-05-01 | 前端本地开发端口调整为 `3001`。 |
+| 2026-05-02 | 统一端口配置：本地/API 容器监听 `3100`，Docker API 暴露 `3002`，Docker 前端暴露 `4002`，避免占用其他项目常用端口。 |
 | 2026-05-01 | 新增功能盘点和测试文档，补充 Vitest 测试覆盖核心功能契约。 |
 | 2026-05-01 | 对齐前端权限 mock、报告修订版本和医生个人模板，统一 `xfSpeechConfig` 字段。 |
 | 2026-05-01 | 新增 Playwright E2E 和 API 契约草案，锁定后端化前的关键前端行为。 |