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

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，不停止其他项目，不读取凭据。