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

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 和生产部署。