chore(FEAT-MO-002): 调整 Web 开发端口为 8888

docs/features/FEAT-MO-002-web-port-8888/gitnexus/impact-plan.md

@@ -0,0 +1,35 @@
+# 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` 启动会失败；启动前必须检测并报告。