chore(FEAT-MO-002): 调整 Web 开发端口为 8888

2026-08-24 17:49:19 +08:00
parent 1f6ed00e6f
commit f00e114f88
22 changed files with 409 additions and 4 deletions
@@ -0,0 +1,13 @@
+# GitNexus 开发后基线
+
+## GitNexus 状态
+
+完成 Web 配置、测试和文档修改后刷新索引：3,122 nodes、4,343 edges、68 clusters、85 flows，状态 `up-to-date`。本功能影响评估为 LOW，受影响执行流为 0。
+
+## Git 已跟踪变更摘要
+
+Vite 开发端口、Playwright Web 地址和本地开发手册由 5173 统一调整为 8888；AGENTS.md 的既有修改保留，不属于本功能。
+
+## Git 工作区摘要
+
+工作区包含本功能档案和端口相关修改；无关未跟踪文件明确排除。提交与推送将在最终独立 Review 通过后执行。
@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：FEAT-MO-002
+- 记录时间：2026年8月19日 GMT+8 12:23:44
+- 分支：main
+- 基线提交：1f6ed00e6fbb
+
+## 工作区
+
+```text
+M AGENTS.md
+```
+
+## GitNexus 状态
+
+```text
+Repository: <project-root>
+Indexed: 8/18/2026, 9:31:53 PM
+Indexed commit: 1f6ed00
+Current commit: 1f6ed00
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,13 @@
+# GitNexus 前后对比
+
+## 开发前
+
+Vite 监听 5173，Playwright 和本地手册使用 5173；GitNexus 索引为项目当前基线。
+
+## 开发后
+
+Vite、Playwright 和本地开发手册统一使用 8888；业务模块执行流、API 契约和数据基础设施不变。GitNexus 变更检测为 LOW，受影响执行流 0。
+
+## 差异处置
+
+8080 的外部 Python 进程未被停止；Tailscale 外部 TDX 隧道独立切换到 `tdx-windows-tailnet`，不改变平台固定的 127.0.0.1:17710 入口。
@@ -0,0 +1,9 @@
+# GitNexus 变更检测
+
+执行：`gitnexus_detect_changes({scope: "unstaged", repo: "a-share-analysis"})`。
+
+结果：`changed_count=3`、`changed_files=5`、`affected_count=0`、`risk_level=low`、受影响执行流 0。GitNexus 识别到 AGENTS.md（既有工作区修改）和本地开发文档章节；Vite/Playwright 的端口常量变化未映射为业务符号，已通过配置测试、类型检查、构建和 HTTP 启动验证覆盖。
+
+本功能预期变更仅为：Vite 端口、Vite 配置测试、Playwright 地址、本地开发文档和功能档案。AGENTS.md 是用户已有修改，本次不触碰其内容，也不将其视为功能变更。
+
+同步判断：不涉及 API/OpenAPI、消息契约、数据库、Redis、Scheduler、Worker 或生产部署；Web 开发启动流程已同步。
@@ -0,0 +1,35 @@
+# GitNexus 开发前影响计划
+
+- 功能编号：FEAT-MO-002
+- 目标：将 Vue/Vite 本地开发服务器端口从 5173 调整为 8888。
+- 总体风险：LOW
+
+## 直接与间接影响
+
+- `gitnexus_query("Vite development server port web startup")` 定位到 `web/vite.config.ts` 和 `web/src/vite-config.test.ts`。
+- `gitnexus_context({name: "vite.config.ts", file_path: "web/vite.config.ts"})` 显示该配置文件被 `web/src/vite-config.test.ts` 导入，配置内部调用 `readDevelopmentPublicEnv`。
+- `gitnexus_impact({target: "vite.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW。
+- `gitnexus_impact({target: "playwright.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW；该配置自身启动并访问 Web 开发服务器，需要同步更新端口。
+- 对 `readDevelopmentPublicEnv` 的 upstream 影响为 1 个配置文件调用方，风险 LOW；端口字段是 Vite 配置常量，不改变 API、数据契约或业务逻辑。
+- 8080 已被另一个本地项目占用；该进程不属于本项目，本次不停止、不修改，也不记录其本机目录或临时进程标识。
+
+## 跨模块同步修改
+
+| 维度 | 判断 | 同步修改 |
+|---|---|---|
+| HTTP/OpenAPI | 不涉及页面 API 契约 | 无 |
+| Web API | 不涉及 Axios 请求路径 | 无 |
+| 消息契约 | 不涉及 RocketMQ | 无 |
+| 数据库 | 不涉及 MySQL Schema | 无 |
+| Redis | 不涉及缓存 | 无 |
+| API | Nest API 端口保持 3000 | 无 |
+| Scheduler/Worker | 不涉及任务进程 | 无 |
+| 部署 | 仅开发 Vite 端口；生产 Web 配置不变 | 更新本功能说明 |
+| 测试 | Vite 配置回归测试增加 8888 断言；Playwright baseURL/webServer URL 同步 | 修改 `web/src/vite-config.test.ts`、`web/playwright.config.ts` |
+| 文档 | 本地开发 Web 地址同步为 8888 | 修改 `docs/deployment/local-development.md` 和本功能档案 |
+
+## 安全、性能与残余风险
+
+- 安全：不改变监听地址（仍为 `127.0.0.1`），不暴露新公网入口，不接触凭据。
+- 性能：仅改变本地开发服务器监听端口，不改变构建产物、代理或运行时性能。
+- 残余风险：如果其他本地进程占用 8888，因 `strictPort: true` 启动会失败；启动前必须检测并报告。