From 20b73ff0d3b847caac41ce5fa004fda1329f3e80 Mon Sep 17 00:00:00 2001 From: weijuesen Date: Thu, 13 Aug 2026 14:53:10 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20Web=20=E6=B5=8B=E8=AF=95=E5=9F=BA?= =?UTF-8?q?=E5=BB=BA=EF=BC=88#27=EF=BC=89=E5=8F=98=E6=9B=B4=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4=E6=8E=A5=E8=AE=B0?= =?UTF-8?q?=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 变更记录.md | 7 +++++++ 开发交接记录.md | 19 +++++++++++++++++++ 2 files changed, 26 insertions(+) diff --git a/变更记录.md b/变更记录.md index b8270d6..efad489 100644 --- a/变更记录.md +++ b/变更记录.md @@ -251,6 +251,13 @@ - 部署与踩坑（2026-08-13 第二次发布）：①Gin 路由 `/rooms/:id/health-profile` 与已有 `/rooms/:id` 冲突导致启动 panic → 改独立路径 `/health-profiles/:roomId`；②`RegisterHealthRoutes` 曾重复注册 panic；③新增 health.go 时覆盖了原 `/health` 路由导致 health 404 → 恢复原函数并拆分 `RegisterHealthProfileRoutes`；④handler 参数名由 `id` 改为 `roomId` 修正 404。最终冒烟：蚕房1# score=96 优（risk 黄 1） - 回滚点见服务器 README（后端 `server-go-linux.old-20260813-6`、web `dist.old-20260813-3`） +### Web 测试基建（计划 #27） + +- `web` 引入 Vitest + jsdom + @testing-library/react/jest-dom；新增 `npm test`（`vitest run`），`vite.config.ts` 增加 `test` 配置（jsdom） +- 新增公共格式化函数 `web/src/utils/format.ts`（`aiClassLabel`/`riskLevelLabel`）+ 首批 3 个单测（TDD 红→绿）；巡检记录页接入公共函数（删除内联映射） +- 验证：`npm test` 3/3、`npm run lint`、`npm run build` 全过；无后端/schema 变更，Web 已同步部署（`dist.old-20260813-4` 为回滚点） +- 说明：Go 测试骨架此前已随各模块落地；后续新增 Web 纯逻辑/工具函数时按 TDD 补充单测 + ## 2026-07-17 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index fff76ab..9678d5b 100644 --- a/开发交接记录.md +++ b/开发交接记录.md @@ -537,6 +537,25 @@ --- +## 2026-08-13 模块：Web 测试基建（计划 #27） + +### 做了什么 + +- Web 引入 Vitest（jsdom），`npm test` 命令；`utils/format.ts` 公共函数 + 3 个单测；巡检页接入公共函数。 + +### 思路与决策 + +- 测试基建先搭最小可用（vitest + jsdom），纯函数优先测试（TDD 红→绿），组件测试等后续按需补； +- 抽取内联映射为公共函数，既便于复用也给了首批可测单元； +- Go 侧测试骨架此前已随各模块建立（model/service/handler 均有单测）。 + +### 验证与部署 + +- `npm test` 3/3、lint、build 全过；无后端/schema 变更，Web 已同步部署； +- 相关提交：`0e6dc00`；回滚见服务器 README（web `dist.old-20260813-4`）。 + +--- + ## 环境与踩坑备忘（新同事必读） - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。