diff --git a/docs/ops/company-multi-tenant-design-2026-10-04.md b/docs/ops/company-multi-tenant-design-2026-10-04.md index de497f3c2..611082342 100644 --- a/docs/ops/company-multi-tenant-design-2026-10-04.md +++ b/docs/ops/company-multi-tenant-design-2026-10-04.md @@ -59,10 +59,10 @@ controller 原样透传 `request.getUserId()`(`patroldelete`/`pricetrack`/`pro - `modules/auth/service/AuthService.java:94` —— `selectOne(eq(username))`,依赖 `users.username` 的**全局唯一索引** - `AuthService.java:50-78` —— 登录失败锁定 map 的 key 是**裸 `username`** -- `LoginResultVo.java:10-19` —— 返回 `userId/username/role/isAdmin/deviceId/token/expiresIn/appColumns/adminColumns`,无公司 +- `LoginResultVo.java:11-23` —— 改造前返回 `userId/username/role/isAdmin/deviceId/token/expiresIn/appColumns/adminColumns`,**无公司**(本轮按 §4 加了 `companyId`:16 / `companyName`:18) - `JwtService.issue()` claims 只有 `subject(userId)` / `username` / `deviceId` -- 前端两套登录态机制不同:**用户端 `frontend-vue` 无 Pinia**,登录态存 localStorage(`shared/auth/ensure-auth.ts:13` `aiimage_auth_token`、`:25-39` `uid`/`username`),`shared/api/user.ts:4-13 getCurrentUserId()` 直接读 `localStorage.uid`;**后台 `admin-frontend-vue` 是 Pinia**(`src/stores/admin-session.ts` 的 `defineStore('admin-session')`),用户信息走 `src/api/session.ts` 的 `fetchCurrentUser()` → `/api/admin/current-user` -- `/api/admin/current-user` 的返回体是 `AdminConsoleController.java:66-71` 里**手搭的 `Map`**(`id`/`username`/`role`/…),不是 VO 类 → 后台顶栏要显示公司名,改的是这个 Map,**不是** `LoginResultVo` +- 前端两套登录态机制不同:**用户端 `frontend-vue` 无 Pinia**,登录态存 localStorage(`shared/auth/ensure-auth.ts` 的 `AUTH_TOKEN_KEY = 'aiimage_auth_token'`,`uid`/`username` 由 `ensureAuth()` 与 `restoreLoginUser()` 两个函数各自回写),`shared/api/user.ts` 的 `getCurrentUserId()` 直接读 `localStorage.uid`;**后台 `admin-frontend-vue` 是 Pinia**(`src/stores/admin-session.ts` 的 `defineStore('admin-session')`),用户信息走 `src/api/session.ts` 的 `fetchCurrentUser()` → `/api/admin/current-user` +- `/api/admin/current-user` 的返回体是 `AdminConsoleController.java:70-77` 里**手搭的 `Map`**(`id`/`username`/`role`/…),不是 VO 类 → 后台顶栏要显示公司名,改的是这个 Map,**不是** `LoginResultVo` ### 1.5 `users` 表映射了两个实体 @@ -82,15 +82,19 @@ controller 原样透传 `request.getUserId()`(`patroldelete`/`pricetrack`/`pro ### 2.2 建号:公司必选,超管可指定 -规则与现有 `createdById` 完全同构(`AdminUserService.java:146-168`:超管可指定创建人,非超管强制落自己名下): +规则与现有 `createdById` 完全同构(`AdminUserService.java:161-175`:超管可指定创建人,非超管强制落自己名下): | 操作者 | `companyId` 传了 | 不传 | |---|---|---| | `super_admin` | 落指定公司(校验公司存在且启用) | 落自己所属公司 | | `admin`(公司内) | **只允许等于自己所属公司**,否则 403 | 落自己所属公司 | -| `normal` | 不可建号(现状即如此:`POST /api/admin/user` 需管理员 + `admin_users` 菜单,`AdminUserService.java:60-63`) | — | +| `normal` | 不可建号(现状即如此:`POST /api/admin/user` 需管理员 + `admin_users` 菜单,`AdminUserService.java:136-140`) | — | -`AdminUserService.create` **永远显式写入** `company_id`,不依赖列 DEFAULT。DEFAULT 只为混合版本窗口存在(§8.2)。 +`AdminUserService.createUser` **永远显式写入** `company_id`,不依赖列 DEFAULT。DEFAULT 只为混合版本窗口存在(§8.2)。 + +**前端比后端严**:新后台的建号弹窗对超管**必须显式选一家**(`validateCreateUserForm(form, operator)`), +而后端对"不传"仍落操作者自己公司。这不是矛盾——后端那条口径是给尚未升级的旧后台兜底的(§5.3), +超管手里同时有 N 家公司时"静默落我自己那家"是危险默认。别把前端的必选当成冗余逻辑删掉。 移人(改账号所属公司):一期**仅超管**可做,且必须校验不变式——账号的 `created_by_id` 必须与自己同公司或为超管,否则拒绝。这条不变式是二期省掉逐个改 77 处过滤点的前提(§7.2)。 @@ -105,9 +109,9 @@ controller 原样透传 `request.getUserId()`(`patroldelete`/`pricetrack`/`pro | PUT | `/api/admin/companies/{id}` | 仅超管(改名 / 启停) | **不做删除**:有账号挂着的公司删不掉,用 `status=0` 停用代替。 -菜单权限走现有口径:`columns` 表插 `admin_companies`,controller 用 `permissionMenuService.hasAnyAdminMenu(operator, List.of("admin_companies"))`(同 `AdminUserService.java:347-351`)。 +菜单权限走现有口径:`columns` 表插 `admin_companies`,controller 用 `permissionMenuService.hasAnyAdminMenu(operator, List.of("admin_companies"))`(同 `AdminUserService.java:466-470`)。 -账号列表(`AdminUserService.adminPage`)一期加 `companyId` **可选**筛选参数:超管可筛任意公司,admin 只能筛自己公司(传别家公司 → 视为无结果,不报错也不越权)。不传时行为与现状完全一致。若你只要"列表显示公司列"而不要筛选,去掉这个参数即可,其余设计不受影响(见 §9.3)。 +账号列表(`AdminUserService.listUsers`)一期加 `companyId` **可选**筛选参数:超管可筛任意公司,admin 只能筛自己公司(传别家公司 → 视为无结果,不报错也不越权)。不传时行为与现状完全一致。若你只要"列表显示公司列"而不要筛选,去掉这个参数即可,其余设计不受影响(见 §9.3)。 ### 2.4 登录态与前端显示公司名 @@ -141,7 +145,7 @@ controller 原样透传 `request.getUserId()`(`patroldelete`/`pricetrack`/`pro | 闸门留 `DEFAULT 1` | 只为混合版本窗口存在,见 §8.2;摘除时机由 §6.3 的启动期巡检盯,不在迁移里处理 | | 每条语句都写成幂等(`IF NOT EXISTS` / `INSERT IGNORE` / 查 `information_schema` 后 `PREPARE` / `WHERE` 限定 / `NOT EXISTS` 守卫) | MySQL 的 DDL 不进事务。迁移中途失败时前面的语句已落库,而 §8.1 的恢复步骤(补数据 → `flyway repair` → 重启)会让 Flyway **从第一条语句重跑整个文件**;写成裸 `CREATE TABLE` / 裸 `INSERT ... VALUES`,恢复路径自己会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库" | | 菜单 `sort_order` 按同级 `MAX+5` 自算 | 现有子菜单的 sort_order 来自初始数据、从未被任何迁移设定过,写字面量等于猜 | -| 菜单 `route_path = 'account/companies'`、`column_key = 'admin_companies'` | 必须与 `admin-frontend-vue/src/router/routes.ts` 逐字一致,否则菜单点进去 404;`columns.column_key` 上有 `uk_column_key`,非幂等插入会直接报错 | +| 菜单 `route_path = 'account/companies'`、`column_key = 'admin_companies'` | 真正的跨产物契约是 **`column_key` 必须在 `admin-frontend-vue/src/router/routes.ts` 登记为 `menuKey`**:侧边栏跳转、面包屑与路由门禁都按 key 关联,且 `menu-route-map.ts` 会用注册表算出的规范路径**覆盖**库里的 `route_path`——所以 `route_path` 写错并不会 404,没登记 menuKey 才会。两边都按现有值保持一致,由 `admin-frontend-vue/tests/company-menu-route.test.ts` 逐条核对;`columns.column_key` 上有 `uk_column_key`,非幂等插入会直接报错 | | 回滚是 `backend-java/docs/rollback-V143-company.sql`,**不是一条 V144 迁移** | 见 §8.3 | 条件 DDL 的写法照 V142(本仓首例),幂等插菜单照 V103/V106。 @@ -174,13 +178,15 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 |---|---| | `common/model/entity/AdminUserEntity.java` | +`companyId` | | `modules/auth/model/entity/LoginUserEntity.java` | +`companyId`(§1.5:两个实体都映射 users,必须同改) | -| `modules/company/`(新建) | `CompanyEntity` / `CompanyMapper` / `CompanyService` / `CompanyController` | -| `modules/admin/service/AdminUserService.java` | `create` 写 `companyId`(§2.2 规则);`update` 支持超管移人 + 不变式校验;`adminPage` 加 `companyId` 筛选 | +| `modules/company/`(新建) | `CompanyEntity` / `CompanyMapper` / `CompanyService` / `CompanyController`;`CompanyService` 除目录读写外还有三条只读口径:`requireActive`(准入)、`namesByIds`(批量显示名,不做权限判定)、`nameOrEmpty`(单条显示名,查不到回空串) | +| `modules/admin/service/AdminUserService.java` | `createUser` 写 `companyId`(§2.2 规则);`update` 支持超管移人 + 不变式校验;`listUsers` 加 `companyId` 可选筛选 + 批量取公司名 | +| `modules/admin/controller/AdminUserController.java` | `GET /api/admin/users` +`@RequestParam(name = "company_id")` | +| `modules/admin/model/vo/AdminUserItemVo.java` | +`company_id` / `company_name`(前端账号列的数据源,snake_case 与其余字段同规则) | | `modules/admin/model/dto/*` | 建号/改号请求 +`companyId` | | `modules/auth/model/vo/LoginResultVo.java` | +`companyId` / `companyName`(**用户端** app-web 走这条) | -| `modules/admin/controller/AdminConsoleController.java:66-71` | `current-user` 的手搭 Map +`companyId` / `companyName`(**后台** admin-vue 顶栏走这条,见 §1.4) | +| `modules/admin/controller/AdminConsoleController.java:76-77` | `current-user` 的手搭 Map +`companyId` / `companyName`(**后台** admin-vue 顶栏走这条,见 §1.4) | | `modules/auth/service/AuthService.java` | `login` 与 `checkLogin` 回填公司名(**不改** username 定位逻辑) | -| 启动期巡检 | 多公司 + DEFAULT 未摘除 → ERROR 告警(§6.3) | +| 启动期巡检 | `modules/company/service/CompanyDefaultGuard.java`(新建):`company` 表 >1 行 **且** `users.company_id` 仍带 DEFAULT → `log.error` 带 ASCII 标记 `COMPANY_DEFAULT_STILL_PRESENT`,探针自身失败降级为 `COMPANY_DEFAULT_PROBE_FAILED` 的 WARN(不许静默当成"查过了")。`scripts/_prod_watch.py` 的 `SIGNATURES` 收第一条并计入 ALERTS(§6.3) | --- @@ -192,12 +198,12 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 | 文件 | 改动 | |---|---| -| `src/router/routes.ts` | 注册 `{ path: 'account/companies', menuKey: 'admin_companies', title: '公司管理', load: () => import('@/pages/account/CompaniesPage.vue') }`——`path` 必须与 V143 里菜单的 `route_path` 逐字一致,`menuKey` 必须与 `column_key` 一致,否则菜单点进去 404 | +| `src/router/routes.ts` | 注册 `{ path: 'account/companies', menuKey: 'admin_companies', title: '公司管理', load: () => import('@/pages/account/CompaniesPage.vue') }`——`menuKey` 必须与菜单的 `column_key` 一致(否则菜单点进去 404,见 §3),`path` 与库里 `route_path` 保持一致 | | `src/pages/account/CompaniesPage.vue`(新建) | 公司列表 + 新建 + 改名/启停 | | `src/api/companies.ts`(新建,配 `-dto.ts`/`-model.ts`) | 按 `src/api/users.ts` 的现有 DTO/model 分层写,不另发明一套 | | `src/pages/account/UsersPage.vue` | 建号表单加公司下拉(必选,超管可选任意公司、admin 锁死自己公司);列表加公司列与筛选 | | `src/api/users-dto.ts` / `users-model.ts` / `users.ts` | +`companyId` / `companyName` | -| `src/api/session.ts` + `src/stores/admin-session.ts` | `fetchCurrentUser` 的返回类型与 `state.user` +`companyId`/`companyName`(该 store 是 Pinia,已有 `isSuperAdmin` getter,同处扩展) | +| `src/api/session.ts` + `src/stores/admin-session.ts` | **不改**:`fetchCurrentUser` 直接把 `/api/admin/current-user` 的 `item` 当 `AdminUser` 用(`session.ts:6`),不经解析器,所以 `companyId`/`companyName` 自动落到对象上;顶栏 `AdminLayout.vue:35` 的 `topbarUserOf(session.user)` 读它即可 | | `src/types/admin.ts` | `AdminUser` 类型 +`companyId`/`companyName` | | `src/layout/topbar-model.ts` + `AdminLayout.vue` | 顶栏显示当前公司名 | @@ -205,10 +211,12 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 | 文件 | 改动 | |---|---| -| `shared/api/user.ts` | `LoginData` +`companyId` / `companyName` | -| `shared/auth/ensure-auth.ts` | localStorage 存 `companyName`;走 `check_login` 恢复登录态时一并写回(该文件现在只恢复 `uid`/`username`,见 `:25-39`) | -| `pages/login/DesktopLoginPage.vue` | 登录成功后写入公司名 | -| 顶栏 / shell 组件 | 显示当前公司名 | +| `src/shared/api/user.ts` | `LoginData` +`companyId` / `companyName` | +| `src/shared/auth/company-identity.ts`(新建) | 公司名的 localStorage 读写:后端没带 `companyName` 就删键,避免换账号后残留上一个账号的公司 | +| `src/shared/auth/ensure-auth.ts` | `check_login` 恢复登录态时一并回写公司名(该文件原本只恢复 `uid`/`username`,见 `:25-39`) | +| `src/pages/login/DesktopLoginPage.vue` | 登录成功后写入公司名;`?logout=1 / ?switch=1` 那段清登录态时**连 `company_name` 一起清**(原本只清 token/uid/username) | +| `src/shared/auth/kick-handler.ts` | 被顶下线(`handleKicked`)时连 `company_name` 一起清,与 uid/username 同一批 | +| `src/pages/amazon/components/AmazonTopBar.vue` | 顶栏用户名左侧显示公司名;为空则整段不渲染 | ### 5.3 发布耦合 @@ -226,14 +234,52 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 ### 6.2 公司边界不变式 -用例:移人后 `created_by_id` 跨公司必须被拒;超管豁免。 -变异自证:删掉校验分支,用例必须红。 +`AdminUserMoveCompanyTest` 8 例(建号那批用例见 §6.1;移人写进 `AdminUserService.updateUser`): + +| 用例 | 钉住的行为 | +|---|---| +| `movingAloneIsAValidEdit` | 只传 `companyId`、不改密码/角色/权限,也是合法编辑(原代码的"请提供要修改的内容"会把这种请求打回) | +| `moveIsRefusedWhenTheCreatorLivesInAnotherCompany` | 创建人在第三家公司 ⇒ 403 且**一条 UPDATE 都不发** | +| `creatorSuperAdminIsExemptFromTheCompanyMatch` | 创建人是超管 ⇒ 不受同公司约束 | +| `onlySuperAdminMayMoveAccounts` | 公司内 admin 传别家公司 ⇒ 403,不静默改写 | +| `namingTheCurrentCompanyIsNotAMove` | 传的正好是账号现属公司按"没动"处理,照常改密码(幂等请求不该被判越权) | +| `destinationCompanyMustExistAndBeActive` | 目标公司先 `requireActive` 再落库 | +| `danglingCreatorBlocksTheMove` | `created_by_id` 悬空(创建人已删)⇒ 无法确认同公司,不移 | +| `nullCreatedByIdMovesWithoutComplaint` | `created_by_id` 本来就空 ⇒ 没有冲突可校验,照移 | + +不变式内容:**账号被移进 X 公司后,它的 `created_by_id` 要么仍是 X 公司的人,要么是超管**。 +这条是 §7.2 里"77 处 `eq(getUserId, userId)` 无需逐个改"的前提,破口就得回到逐出口补边界那条路。 + +一期**没做移人的前端入口**:账号列表只有公司列 + 超管筛选(§5.1),移人是后台手工动作, +接口 `PUT /api/admin/user` 的 `companyId` 字段已就绪,UI 留给二期和公司目录一起出。 + +> 踩过的坑(写下一条同类用例前先看):`LambdaUpdateWrapper.getSqlSegment()` **只含 WHERE**, +> SET 子句在 `getSqlSet()` 里。最初四条断言打在 `getSqlSegment()` 上,实际拿到的是 +> `(id = #{ew.paramNameValuePairs.MPGENVAL2})`——"改了哪一列"这一整组断言恒假红, +> 而"没移人不许带 company_id"那条恒绿。断"这次真的写了哪一列"只能取 `getSqlSet()`。 ### 6.3 DEFAULT 摘除告警(防「半套发布」) `users.company_id DEFAULT 1` 是**临时**的,只为混合版本窗口存在。第二家公司开通后若不摘除,此后每个不显式传公司的建号都会被静默塞进厦门米椿花。 启动期巡检:`SELECT COUNT(*) FROM company` > 1 **且** `users.company_id` 仍有 DEFAULT → 打 ERROR(纳入 `_prod_watch.py` 巡检 ALERTS)。用代码执行,不写进注释。 +`CompanyDefaultGuard`(`@EventListener(ApplicationReadyEvent.class)`)8 例: + +| 用例 | 钉住的行为 | +|---|---| +| `secondCompanyWithDefaultStillOnShoutsError` | 2 家公司 + DEFAULT="1" ⇒ ERROR 带 `COMPANY_DEFAULT_STILL_PRESENT` 与公司数 | +| `singleCompanyKeepsQuiet` | 只有一家公司时 DEFAULT 是发布期故意留的(§8.2),不许喊 | +| `droppedDefaultKeepsQuiet` | `COLUMN_DEFAULT` 为 null ⇒ 已摘除,一声不响 | +| `blankDefaultCountsAsDropped` | 空串/空白也按"已摘除"处理 | +| `noCompanyAtAllKeepsQuiet` | 0 家公司时**连列都不去查**(短路顺序也是断言对象) | +| `probeFailureIsAnnouncedNotSwallowed` | 探针抛错 ⇒ WARN 带 `COMPANY_DEFAULT_PROBE_FAILED`,不许静默读成"检查过了" | +| `probeReadsTheRightColumn` | 捕获真实 SQL,必须探 `information_schema.COLUMNS` 的 `'users'` / `'company_id'`(表名列名写错等于没探) | +| `guardRunsWhenTheApplicationIsReady` | 反射断 `checkOnStartup` 上挂着 `@EventListener(ApplicationReadyEvent.class)`——漏注解这哨兵永远不跑 | + +两个标记串故意用 **ASCII**:巡检是靠 `docker logs | grep -aiE` 匹配的,中文一旦在容器里变了编码整条签名静默失效。 +`scripts/_prod_watch.py` 的 `SIGNATURES` 增 `('公司DEFAULT未摘', 'COMPANY_DEFAULT_STILL_PRESENT', True)`(第 12 条,实跑 `scripts/tests` 全绿)。 +`COMPANY_DEFAULT_PROBE_FAILED` 故意**不**进 ALERTS:生产 MySQL 账号本就缺 `information_schema` 读权限(见运维要点),把它做成告警只会变成常驻噪声;它出现在 WARN 里,人工核查时看得到。 + ### 6.4 迁移自检 `MODIFY ... NOT NULL` 本身即闸门(§3)。 @@ -249,9 +295,120 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 盘点文档取号起点不跟着改、盘点文档文件数不跟着改。 另跑 `MigrationInventoryTest` 确认版本连续、命名合规、历史校验和未变。 -### 6.5 全量回归 +### 6.5 公司目录:读写收窄与出厂一致性(§2.3) -`mvn test`(不许 skipTests)+ `scripts/tests`(当前 137 绿)+ `admin-frontend-vue` 的单测与 e2e(`tests/`、`e2e/`)+ 两个前端各自的 `npm run build`(`frontend-vue` 的 build 含 vue-tsc 类型检查)。 +后端 4 个测试类共 26 例(`mvn -o test -Dtest="Company*Test"`): + +| 测试类 | 例数 | 钉住的行为 | +|---|---|---| +| `CompanyServiceDirectoryTest` | 17 | 超管列全部(**不带任何查询条件**)、公司内 admin 只列自己公司、无角色与无公司归属一律 403、`admin_companies` 菜单闸门、写接口仅超管、名称 trim + 唯一(改名校验排除自身)+ 不超列宽、备注不超列宽、状态只能是 0/1 | +| `CompanyControllerEndpointTest` | 5 | 每个 handler 先 `requireAdminOrInternal` 再碰目录(`InOrder` 断言调用次序)、路由与后台前端逐字一致、**不暴露 DELETE**、列表返回 VO 而非实体、写接口回保存后的公司 | +| `CompanyVoTest` | 1 | 过真 `ObjectMapper` 序列化,键名恰好 `id/company_name/status/remark/created_at/updated_at`,日期 `yyyy-MM-dd HH:mm`、空日期出 `""` | +| `CompanyServiceRequireActiveTest` | 3 | `requireActive`(§2.2 那批用例):本轮只把构造器补到 3 参,断言未动 | + +前端 2 个文件共 15 例:`tests/company-user-list.test.ts`(7,含一条**反向排他**——解析器读到 camelCase `companyId/companyName` 必须忽略,防止前后端各猜一套)、`tests/company-user-create.test.ts`(8)。 + +实跑证据(2026-10-04 04:45–05:11;日志文件属 `target/` 产物,收尾已删,下面的数字取自当轮回显): +`baseline: 26 例全绿` → 16 条变异 **16/16 KILLED**(每条都打印了它红的那一例)→ +`restore check: all files byte-identical to pre-injection`(三个文件还原后 sha1 与注入前逐字节一致)→ +`SURVIVORS/PROBLEMS: 0`、`PY_RC=0`。 + +16 条变异自证(脚本注入缺陷 → 指定的那几例必须红 → 用**注入前读进内存的字节**还原,不许 `git checkout`): +`admin-directory-loses-own-company-filter`、`super-admin-directory-also-filtered`、`admin-without-company-falls-back-to-all`、 +`menu-gate-removed`、`role-gate-removed`、`super-admin-write-gate-removed`、`company-name-not-trimmed`、 +`duplicate-name-check-removed`、`duplicate-check-includes-self`、`status-range-check-removed`、`name-length-check-removed`、 +`remark-length-check-removed`、`vo-loses-snake-case-name`、`controller-create-skips-auth`、 +`controller-gets-a-delete-endpoint`、`controller-route-typo`。 + +两条踩过的坑,留给后续同类用例: + +- **断言要打在"有没有带值的条件"上,不是打在列名上**。`company` 表压根没有 `company_id` 列,最初写的 + `getSqlSegment()).contains("company_id")` 一条恒假、配套的"超管不带条件"一条恒真,两条一起绿等于没断言。 + 改成 `getParamNameValuePairs()).isEmpty()`(超管)对 `containsValue(2L)`(公司内 admin)。 + 另两个 API 坑:`Wrapper` 不暴露 `getParamNameValuePairs()`,捕获类型必须是 `LambdaQueryWrapper`; + 且要先碰一次 `getSqlSegment()` 参数才会被铺出来。MP 3.5.7 的 `insert`/`updateById` 有 `Collection` 重载, + `any()` 有歧义,必须写 `any(CompanyEntity.class)`。 +- **变异脚本每轮开跑前要把所有被注入的文件写回 pristine**(实测两批都栽了)。第一版只在 `finally` 里统一还原, + 于是每轮只重写"本轮那个文件":第 13 轮改 `CompanyVo` 时,第 12 轮改 `CompanyService` 的缺陷还留在盘上, + 红名单里混进上一轮的用例 ⇒ 日志里"红名单共 N 例"这个数字整批失真。 + 16 条 KILLED 本身仍可采信,因为**每条变异期望红的那一例都只在自己那一轮出现**(已按用例名做过归因矩阵); + 但要是两轮期望的用例同名,就会被静默假判 KILLED。脚本已补上"逐轮回写 pristine"。 +- **变异脚本的锚点在 Windows 上要先对齐行尾**。源码是 CRLF,`decode("utf-8")` 不转换行尾,锚串里的 `\n` + 会 0 命中 ⇒ 注入静默失败 ⇒ 那一轮"没红"会被误读成"变异存活"。脚本因此加了 `align()` 和 + `--check-anchors` 预检(16 条锚点全部 hits=1 才开跑)。 + +### 6.6 第二批变异自证:登录态、移人、启动哨兵、列表公司列 + +覆盖 §2.4(登录/current-user 带出公司身份)、§6.2(移人不变式)、§6.3(DEFAULT 哨兵)、§2.3(列表公司列与筛选), +被注入的 7 个类共 **39 例**(首轮 37 例,补进 2 例后 39 例)。脚本 `target/mutation_company_phase2.py`,表内 29 条变异 +(条目数由 AST 数出,不是手数),开跑前 `anchor pre-check: 29/29 锚点各命中 1 次`。 + +首轮实跑(2026-10-04 06:02–06:47,日志 `target/mutation_phase2.log`): + +``` +baseline: 37 例全绿(报告 7 份,rc=0) +SUMMARY: 25/28 KILLED, SURVIVED=2 ['names-by-ids-loses-dedupe', 'move-gate-for-company-admin-removed'], + INCONCLUSIVE=1 ['move-only-request-rejected-as-empty-edit'], restore_ok=True +PY_RC=1 +``` + +三条问题全部是**用例侧/脚本侧**的洞,不是实现有缺陷(实现一行没改): + +- `names-by-ids-loses-dedupe` 存活:`AdminUserListCompanyTest` 把 `CompanyService` 整个 mock 掉了, + 捕获的是**调用方传出去的参数**,永远摸不到 `namesByIds` 内部的去重。全仓 grep 证明没有任何用例用**真实对象** + 调过这个方法 ⇒ 这条被注释宣称的护栏从未被证明过。修法:`CompanyServiceNameLookupTest`(真实 `CompanyService` + + mock mapper)补 2 例——重复 id 折成一次查询且 `IN` 参数每家公司只出现一遍(用 `in(col, coll)` 每元素一个 + MPGENVAL 参数来钉去重)、空列表与 `null` 一条 SQL 都不发。 +- `move-gate-for-company-admin-removed` 存活:断言写的是 `contains("公司")`,而"移人闸门"与"创建人同公司不变式" + 两条 403 文案**都含"公司"**——删掉闸门后仍由后者抛 403,用例"因为错的原因过"。修法:两条断言各钉自己的文案 + (`contains("超级管理员")` / `contains("创建人")`)。 +- `move-only-request-rejected-as-empty-edit` INCONCLUSIVE:变异串本身不是合法 Java(整行替换成 `)` 丢了 `{` + ⇒ 花括号失衡 ⇒ 编译失败 ⇒ 压根没有报告)。4 次尝试全 rc=1 且无 `TEST-*.xml` 即为此症。修法:替换串保留花括号。 + +修补后只复跑受影响的 4 条(06:53–07:00,`target/mutation_phase2b.log`,`--only` 过滤后"表内 29 条,本轮跳过 25 条"): + +``` +baseline: 39 例全绿(报告 7 份,rc=0) +[04] names-by-ids-loses-dedupe KILLED red=1/39 期望红=命中=batchLookupSendsEachCompanyIdOnce +[05] names-by-ids-queries-on-empty-input KILLED red=1/39 期望红=命中=batchLookupOnEmptyInputSkipsTheTable +[11] move-only-request-rejected-as-empty-edit KILLED red=5/39 期望红=命中=movingAloneIsAValidEdit +[13] move-gate-for-company-admin-removed KILLED red=1/39 期望红=命中=onlySuperAdminMayMoveAccounts +SUMMARY: 4/4 KILLED, SURVIVED=0, INCONCLUSIVE=0, restore_ok=True(表内 29 条,本轮跳过 25 条) +PY_RC=0 +``` + +两个 7 文件的还原读数(首轮与复跑一致,sha256 前 12 位与注入前逐项相同):`CompanyService.java` +`93513896eb9a`、`AuthService.java` `d35d7715b509`、`AdminConsoleController.java` `9102c2967947`、 +`AdminUserService.java` `cf1d200c49ee`、`CompanyDefaultGuard.java` `2900ed07c35c`、`AdminUserItemVo.java` +`8ee2c28e9c9f`、`AdminUserController.java` `5849f9b48b39`,全部 `byte-identical`。 +复跑后 `13` 那轮的红名单恰好只有 `onlySuperAdminMayMoveAccounts` 一例——这本身就是"断言收紧后只咬它自己那条闸门"的证据。 + +29 条变异清单:`name-or-empty-queries-on-null-id`、`name-or-empty-throws-when-company-missing`、 +`name-or-empty-hides-disabled-company`、`names-by-ids-loses-dedupe`、`names-by-ids-queries-on-empty-input`、 +`login-loses-company-name`、`login-loses-company-id`、`login-gates-on-company-active`、 +`current-user-company-key-snake-cased`、`current-user-drops-company-identity`、 +`move-only-request-rejected-as-empty-edit`、`same-company-naming-treated-as-a-move`、 +`move-gate-for-company-admin-removed`、`move-target-company-existence-unchecked`、`creator-invariant-check-removed`、 +`super-admin-creator-not-exempted`、`null-creator-blocks-the-move`、`move-does-not-write-the-column`、 +`admin-cross-company-filter-falls-through`、`super-admin-filter-adds-no-condition`、 +`unknown-company-row-crashes-the-item`、`empty-page-still-asks-for-names`、`item-vo-company-name-loses-snake-case`、 +`company-filter-param-becomes-required`、`guard-threshold-off-by-one`、`guard-treats-blank-default-as-dropped`、 +`guard-probe-failure-is-swallowed`、`guard-never-runs-on-startup`、`guard-probes-the-wrong-column`。 + +新增一条规矩(第一条就栽过):**变异点落在被 mock 掉的依赖内部,用例必然咬不住**。判存活时先怀疑 mock 边界, +再怀疑脚本;这类护栏要用真实对象另建一组用例,注释里写"已覆盖"不作数。 + +### 6.7 全量回归 + +`mvn test`(不许 skipTests、主树禁 clean):**2026-10-04 07:09 全量实跑 `Tests run: 3589, Failures: 0, Errors: 0, Skipped: 7`,`BUILD SUCCESS`,耗时 04:52**(日志 `target/mvn_full.log`,收尾已删)。 ++ `scripts/tests`(2026-10-04 06:12 实跑 **155 passed**,设计文档早前写的 137 已过期)+ `admin-frontend-vue` 的 `npm test`(06:25 复跑 **1678/1678**,RC=0)+ `frontend-vue` 的 `npm test`(06:20 复跑 **672/672**,RC=0,含本轮新增的下线清键 1 例)+ 两个前端各自的 `npm run build`(build 脚本自带 `vue-tsc --noEmit`,`frontend-vue` 06:21 RC=0,`admin-frontend-vue` 06:35 RC=0)。 +**这一轮全量绿是在「本批公司改动 + 另一批未提交的 task-center 改动」的同一棵工作区树上跑出来的**,提交只含前者。 +两者互不依赖已逐个取证:task-center 那 8 个改动/新增的 java 文件里 `compan` 关键词逐个文件命中 0 行(逐文件 `grep -ci`,不是全树一次过),本批改动的文件零引用 `taskcenter`; +本批唯一改签名的方法 `AdminUserService.listUsers`(加 `companyIdFilter` 形参)在 HEAD 与工作区都只有 +`AdminUserController` 一个调用方,而它就在同一笔提交里;其余改动是纯增字段。 +提交子集本身没有单独再跑一遍 mvn(约 5 分钟),要更硬的证据可在干净 HEAD worktree 上只叠本批重跑。 +**e2e 没跑**:`admin-frontend-vue` 的 Playwright 用例(`e2e/*.spec.ts`,`npm run test:browser`)要起着前端与后端才成立,本轮未起服务,公司目录页也没有对应 spec——这一条是缺口,不是已通过项。 +SFC 那一行清键(`DesktopLoginPage.vue` 的登出/切号分支)没有自动化用例覆盖:`handleKicked` 那条有,另一条靠人肉读代码确认。 既有红按差分读,不当回归:客户端批量测试有 8 例既有红、task_220 有 3 例既有红(已用干净 HEAD worktree 证实)。 门禁不要与 Nuitka 打包并行跑(计时用例会假红)。 @@ -271,7 +428,7 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 ### 7.2 数据隔离(方案②:中央 scope + 逐出口接入 + 护栏) - `CompanyScopeSupport`:`currentCompanyId(user)` / `memberUserIds(companyId)` / `assertSameCompany(...)`;`role=super_admin` 豁免(**按 role 判,不按 company_id 判**) -- 需要叠公司边界的是**范围大于一人**的出口:5 套并行 scope(9 文件 37 处)、27 文件 219 处 super_admin 分支中「看全部」的部分、3 处集合式过滤、`AdminUserService.adminPage` 超管分支 +- 需要叠公司边界的是**范围大于一人**的出口:5 套并行 scope(9 文件 37 处)、27 文件 219 处 super_admin 分支中「看全部」的部分、3 处集合式过滤、`AdminUserService.listUsers` 超管分支 - 77 处 `eq(getUserId, userId)` 由 §2.2 的 `created_by_id` 同公司不变式覆盖,**无需逐个改** - 护栏:AST/正则扫描——对公司归属表的 `getUserId` 过滤若未走 scope 即红;变异自证(把 `in` 改回 `eq`、删掉超管豁免,必须被抓到) - 不给业务表冗余 `company_id`:与「数据按账号归属、公司维度跟着账号走」的定案相反。若日后 `IN (成员列表)` 在热表上撑不住,再单独议是否给那两三张表冗余 @@ -308,9 +465,14 @@ WHERE c.column_key = 'admin_companies'; -- 期望 1 --- -## 9. 待确认 +## 9. 待确认(一期按下列默认口径已实现,若要改请在此推翻) -1. `company` 是否需要 `company_code`(英文短码)?二期登录定位用公司名还是短码?一期我按只用 `company_name` 做。 -2. 顶栏显示公司名——§5 目前按**两端都显示**写(后台 `AdminLayout.vue`、用户端 shell)。若只要用户端,删掉 §5.1 最后两行即可。 -3. 账号列表一期是「只显示公司列」还是「同时支持按公司筛选」?(§2.3 按后者写) -4. 公司内 admin 是否应看到本公司其他 admin 名下的账号?现状只能看名下 1 层(`AdminUserService.java:78-86`)。这属二期隔离口径,但会影响一期公司目录页的可见范围。 +1. **不加 `company_code`**。一期没有任何消费点:目录页、建号下拉、顶栏显示全都用 `company_name`。 + 二期登录定位若真遇到跨公司同名账号,让用户在"先选公司"的下拉里挑比记短码更直观,短码只会多一处唯一索引 + 录入校验。 +2. **两端都显示公司名**——后台 `AdminLayout.vue` 用户名下方一行、用户端 `AmazonTopBar.vue` 用户名左侧,均已在做(§5.1/§5.2)。 + 两处都是"后端没带 `companyName` 就整段不渲染",不显示 `undefined`。 +3. **既显示列,也支持筛选**(§2.3 口径已实现)。筛选下拉**仅超管可见**:公司内 admin 的读接口已被后端收窄到本公司, + 给它一个只能选到自己公司的筛选框是假功能。 +4. **公司内 admin 一期仍只看自己名下 1 层账号**(`AdminUserService.java:92-102` 现状不变:列表的非超管分支只放行「自己」或「自己创建的 normal」)。 + 一期定案是"业务代码零改动",把可见范围放宽与 89 处数据出口叠公司边界放到同一批(§7.2); + 因此公司目录页对 admin 只显示自己这一家,**不承诺**"看见本公司全部账号"。