# Web 开发端口调整开发总结

- 功能编号：FEAT-MO-002
- 总结版本：0.1
- 日期：2026-08-19

## 原始开发需求

将前端端口改为 8080，检查占用并启动；经检查 8080 被其他项目占用后，用户确认改用 8888。

## 需求与范围变化

初始目标从 8080 调整为 8888，原因是 8080 已被另一个本地项目占用；该进程不属于本项目，本次没有停止或修改它。

## 实际完成需求

- `web/vite.config.ts` 开发端口改为 8888。
- `web/playwright.config.ts` 两处 Web 地址改为 8888。
- 本地开发手册 Web 地址改为 8888。
- 新增端口回归测试。
- Web 已在 `http://127.0.0.1:8888/` 启动并返回 200。
- Tailscale 外部隧道已启动，SSH 控制隧道监听 `127.0.0.1:17710`，TDX 只读行情请求成功。
- 为保证外部隧道切换后的 API 可重复启动，在被 Git 忽略的 `deploy/env/development/api.env.local` 补充了 `TDX_BASE_URL` 和 `TDX_TIMEOUT_MS`，未写入仓库。

## 修复缺陷

本次没有修复既有业务缺陷；变化属于本地开发配置和对应验证入口的一致性调整。新增回归断言防止端口意外恢复为 5173。

## 未完成与延期项

生产部署不在本次范围。完整 E2E 在收尾复验时发现市场概览夹具时钟未隔离，已由 `FEAT-QA-001` 修复；API 健康检查因开发 MySQL 不可用返回 503，但 Redis 正常，市场概览接口和 TDX 只读链路返回 200，MySQL 状态不属于本次端口变更。

## 关键提交

- `f00e114f88464f07bcbba3ca6691f04ca9699d38`：`chore(FEAT-MO-002): 调整 Web 开发端口为 8888`。
- 该实施提交已推送至项目 Gitea `origin/main`，远端分支 SHA 与本地一致。

## 验证证据

- Schema：`npm run schema:baseline` 和 `npm run schema:verify` 均通过，版本 `v0.0.10 (captured_empty)`。
- GitNexus：开发前索引状态最新；开发后检测为 LOW、受影响执行流 0。
- 测试：Web Vitest 8 个文件、21 个测试通过；修改前新增端口测试按预期失败。
- 启动：Vite 监听 8888，首页 HTTP 200；API 使用本地配置启动并监听 3000。
- TDX：Tailscale ping 经 DERP 成功，SSH 隧道监听 17710，`get_market_data` 返回 `ErrorId=0`。
- 安全：保持 127.0.0.1，不停止其他项目，不读取凭据。