48 lines
1.7 KiB
Markdown
48 lines
1.7 KiB
Markdown
# 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 和生产部署。
|