20260924172548

code/fms/.workbuddy-ai/memory/topics/env-and-baseline.md

@@ -0,0 +1,29 @@
+# 本机环境坑 + 测试基线
+
+## 环境坑（本机特有）
+
+- **编译/测试 fms-api 唯一可行命令**（`start.cmd` 里的 JDK/Maven 路径都是坏的）：
+  ```
+  cd /d/workspace/code/fms/fms-api && /d/devtool/jdk/jdk21/bin/java \
+    -Dclassworlds.conf="D:/devtool/maven/bin/m2.conf" -Dmaven.home="D:/devtool/maven" \
+    -Dmaven.multiModuleProjectDirectory="D:/workspace/code/fms/fms-api" \
+    -cp "D:/devtool/maven/boot/plexus-classworlds-2.11.0.jar" \
+    org.codehaus.plexus.classworlds.launcher.Launcher -o -Dtest=XxxTests test
+  ```
+  本地仓库是 `D:\data\maven`（不是 ~/.m2）；联网下载去掉 `-o`；`target/` 被 git 跟踪，编译后有噪音。
+- 无 sqlcmd/pyodbc/pymssql：用 `fms-api/tools/migration/RunSqlFile.java` 或一次性 `SqlRunner.java`
+  + JDBC jar（`~/.m2/.../mssql-jdbc-13.4.0.jre11.jar`）+ `/d/devtool/jdk/jdk17/bin/java`。
+  脚本要按行首 `GO` 分批，路径传绝对路径。
+- `vite build` 被 safe-delete 守卫拦（要删 600+ 文件）：用 `--outDir dist-verify --emptyOutDir`；
+  清理用 `find dist-verify -type f -delete` 再 `find dist-verify -type d -empty -delete`。
+- `oxfmt --check` 全仓库都报 format issues（版本漂移），**不是自己引入的**，别顺手格式化整个仓库。
+- 本工作区可能被多会话同时编辑，验证失败项先用 `find <dir> -mmin -N` 确认是否自己引入。
+
+## 测试基线（既有失败，别去修）
+
+- 后端 `OrgDataSourceFactoryTests.databaseConnectionFailureDoesNotRetry`（断言 Druid retry=0，实测 1）。
+- 前端 `tests/unit/fms-module-list-page.spec.js` 里引用 `.filter-drawer`/`.filter-row__*` 的用例
+  （类名已不存在，是高级查询面板改版后的过期断言）—— 另有约 13 个长期失败基线。
+- `tests/helpers/app.js` 的 `mountPage` 用 shallowMount 且默认打桩子组件：给 `Splitter`/`SplitterPanel`
+  打桩时键名要写 **Vue 推断名 `'splitter'`/`'panel'`**（文件名小写），写 `'SplitterPanel'` 打不上桩；
+  自定义组件传 `false` 可强制真实挂载。`global` 会整体覆盖内部 stubs，别在里面再写 stubs。