# GitNexus 开发前影响计划

- 功能编号：FEAT-MO-002
- 目标：将 Vue/Vite 本地开发服务器端口从 5173 调整为 8888。
- 总体风险：LOW

## 直接与间接影响

- `gitnexus_query("Vite development server port web startup")` 定位到 `web/vite.config.ts` 和 `web/src/vite-config.test.ts`。
- `gitnexus_context({name: "vite.config.ts", file_path: "web/vite.config.ts"})` 显示该配置文件被 `web/src/vite-config.test.ts` 导入，配置内部调用 `readDevelopmentPublicEnv`。
- `gitnexus_impact({target: "vite.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW。
- `gitnexus_impact({target: "playwright.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW；该配置自身启动并访问 Web 开发服务器，需要同步更新端口。
- 对 `readDevelopmentPublicEnv` 的 upstream 影响为 1 个配置文件调用方，风险 LOW；端口字段是 Vite 配置常量，不改变 API、数据契约或业务逻辑。
- 8080 已被另一个本地项目占用；该进程不属于本项目，本次不停止、不修改，也不记录其本机目录或临时进程标识。

## 跨模块同步修改

| 维度 | 判断 | 同步修改 |
|---|---|---|
| HTTP/OpenAPI | 不涉及页面 API 契约 | 无 |
| Web API | 不涉及 Axios 请求路径 | 无 |
| 消息契约 | 不涉及 RocketMQ | 无 |
| 数据库 | 不涉及 MySQL Schema | 无 |
| Redis | 不涉及缓存 | 无 |
| API | Nest API 端口保持 3000 | 无 |
| Scheduler/Worker | 不涉及任务进程 | 无 |
| 部署 | 仅开发 Vite 端口；生产 Web 配置不变 | 更新本功能说明 |
| 测试 | Vite 配置回归测试增加 8888 断言；Playwright baseURL/webServer URL 同步 | 修改 `web/src/vite-config.test.ts`、`web/playwright.config.ts` |
| 文档 | 本地开发 Web 地址同步为 8888 | 修改 `docs/deployment/local-development.md` 和本功能档案 |

## 安全、性能与残余风险

- 安全：不改变监听地址（仍为 `127.0.0.1`），不暴露新公网入口，不接触凭据。
- 性能：仅改变本地开发服务器监听端口，不改变构建产物、代理或运行时性能。
- 残余风险：如果其他本地进程占用 8888，因 `strictPort: true` 启动会失败；启动前必须检测并报告。