2.3 KiB
2.3 KiB
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启动会失败；启动前必须检测并报告。