46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# 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，不停止其他项目，不读取凭据。
|