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