Files
a-share-analysis/docs/features/FEAT-MO-002-web-port-8888/design.md

22 lines
974 B
Markdown

# 设计
## 方案
在 `web/vite.config.ts` 的 `server.port` 设置 8888;同步 `web/playwright.config.ts` 的 `baseURL` 与 `webServer.url`,并更新 `docs/deployment/local-development.md`。保持 `host: 127.0.0.1`、`strictPort: true` 和 `/api` 代理不变。
## 安全策略与评估
- 监听地址仍为回环地址,不增加局域网或公网暴露。
- 不停止 8080 的外部项目进程。
- 不读取或写入凭据,不改变 API、TDX 或外部基础设施配置。
## 性能目标与评估
- 端口调整不改变前端构建产物和运行时逻辑。
- Vite 启动验证目标为 30 秒内可访问;本次实际启动耗时小于 1 秒。
- E2E 启动入口与真实监听地址保持一致,避免重复启动或等待错误端口。
## 错误处理与回退
`strictPort: true` 保持不变;8888 被占用时启动明确失败,不自动抢占或切换端口。回退时将四处当前配置恢复为 5173,并同步恢复文档。