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

2026-08-24 17:49:19 +08:00
parent 1f6ed00e6f
commit f00e114f88
22 changed files with 409 additions and 4 deletions
@@ -0,0 +1,47 @@
+# 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 和生产部署。