1.7 KiB
1.7 KiB
Web 开发端口调整为 8888 PRD
- 功能编号：FEAT-MO-002
- PRD版本：0.1
- 状态：approved
- 日期：2026-08-19
背景与问题
本机 8080 已被其他项目占用，现有 A 股分析工具前端开发端口 5173 需要调整为用户指定的 8888。
产品目标
- Web 开发服务器监听
127.0.0.1:8888。 - Playwright、本地开发文档和端口回归测试使用同一地址。
- API 仍监听
127.0.0.1:3000，TDX 隧道仍使用127.0.0.1:17710。
非目标
- 不改变生产 Web 端口、Nginx、API、TDX、Redis、MySQL 或 RocketMQ 配置。
- 不停止其他项目进程，不开放公网监听。
功能需求
| 编号 | 优先级 | 需求 | 可观察结果 |
|---|---|---|---|
| FR-001 | P0 | 调整 Vite 开发端口 | vite.config.ts 的 server.port 为 8888 |
| FR-002 | P0 | 同步 E2E 和本地文档 | Playwright 和开发手册访问 8888 |
| FR-003 | P0 | 保持本机安全边界 | host 仍为 127.0.0.1，strictPort 仍启用 |
安全需求与信任边界
本次只改变本机开发监听端口，不改变监听地址、代理目标、认证、数据源或凭据。8080 占用进程不属于本项目，不停止或操作该进程。
性能目标与容量假设
端口变化不应改变构建、代理和页面运行时性能；Vite 应在 30 秒内启动并返回首页。
验收标准
web/src/vite-config.test.ts断言端口为 8888。http://127.0.0.1:8888/返回 HTTP 200。- API 代理仍转发到
http://127.0.0.1:3000。
关联模块与同步修改
涉及 Web Vite 配置、Web 配置测试、Playwright 配置和本地开发文档；不涉及 HTTP/OpenAPI、数据库、Redis、消息、Scheduler、Worker 和生产部署。