feat(菜单权限): 每家公司一套菜单树(V149)+ 公司 tab 只在注册表页渲染

本批两件事,加上随本批一起入仓的并行会话在制品:

一、菜单权限按公司隔离(批次 6)
- V149 给 columns 加 company_id:先可空加列(末位、ALGORITHM=INSTANT)→ 回填公司 1 →
  MODIFY 收紧 NOT NULL;三段式缺一即撞 1048。同时建 (company_id, column_key) 复合键、
  把公司 2 的 16 笔授权按 column_key 改指向它自己的副本,三类 menu_type 全复制,
  admin_companies 作为角色内生闸门行不复制(D3)。
- 第三道归属门 PermissionMenuService.resolveScopeCompanyId:站点超管可带 company_id
  读写任意公司,非超管锁本公司、越界 403。它注册进 CompanyIdParamGoesThroughReadScopeTest
  的 SCOPE_DOORS,四条判据与 readScope / readCompanyIdOrOwn 共用——护栏在代码出口,不靠清单。
- 旁路种子 PermissionMenuSchemaInitializer 只种公司 1:31 段种子逐条钉公司,
  按 column_key 点查的 14 段全部带 company_id,否则摘了 DEFAULT 就是跨公司串写。
- CompanyService.create 同一次写入里给新公司复制模板树(D4)。

二、公司 tab 收口(批次 b)
tab 条挂在壳层,对 22 页全画;改为按正列表 companyTabAppliesTo(menuKey) 判定,
只有注册表页渲染。护栏钉在用户看见的那个出口。

三、并行会话在制品(控制方「全部提交」,未单独拆分——见下)
- V150 店铺密钥 biz_shop_key 按公司(readCompanyIdOrOwn + writeCompanyId 两道门)
- V151 品牌库/商品类目推翻为全平台共享:只退唯一键、company_id DEFAULT 保留为
  NOT NULL 承重约束(摘了每条 1364);删掉 ProductCategoryControllerCompanyScopeTest
  那支"按公司隔离"的旧护栏,readCompanyId 方法一并移除
- invalidasin 字段与外观专利合批的连带改动

为什么不拆笔:后端 3891 例 / 0 红、前端 1731 例 / 0 红这两个读数是"合起来的树"的读数,
拆成多笔会让每一笔落到从未一起验过的组合上,而这一版要直接上两台。

回滚脚本在 backend-java/docs/rollback-V149/V150/V151-*.sql,不放进 Flyway 扫描路径。
设计记录:docs/ops/menu-company-tree-design-2026-10-06.md
This commit is contained in:
2026-10-06 17:17:14 +08:00
parent e635fa8dcd
commit b7acfc0eef
84 changed files with 5118 additions and 1421 deletions
@@ -0,0 +1,311 @@
# 菜单权限按公司一套树 · 设计(2026-10-06)
控制方要求:「菜单权限也加字段来区分,现在的默认归到 admin 下」,并在两个档位里选了重的那一档——
**每家公司一套菜单树**(不是"只给字典行打个归属标记")。
关联:`company-multi-tenant-design-2026-10-04.md`(账号归属,已上线)、
`brand-dedupe-company-isolation-design-2026-10-04.md`(规则库每公司一套,同一形状)。
## 1. 线上家底(2026-10-06 主机A 业务库只读实查,不是估的)
| 事实 | 读数 |
| --- | --- |
| `columns` 行数 | 52 = admin 26(id 4…109)+ app 24(id 1…96)+ internal 2(id 69、95) |
| `columns` 列 | id/parent_id/name/column_key/menu_type/route_path/sort_order/created_at/updated_at,**无 company_id** |
| 唯一键 | **两条**:`uk_column_key(column_key)`、`uk_menu_type_route_path(menu_type, route_path)` |
| 其他索引/约束 | `PRIMARY(id)`、`idx_columns_parent_sort_id`、`idx_menu_type_sort_id`、`fk_columns_parent_id`→`columns(id)` |
| `user_column_permission` | 784 笔 / 133 只账号 / 34 个被授权 column_id |
| 授权按公司分布 | 公司 1(厦门米椿花)131 人 768 笔;公司 2(德阳)2 人 **16 笔** |
| 同 key 重复行 | 0 行 ⇒ 原地换复合键不会因重复失败 |
| `admin_companies`(id 109)授权 | 0 笔(10-04 事故后的既定状态) |
`PermissionMenuSchemaInitializer` 生产是关的(`application.yml:259` 默认 `false`),但它是 JdbcTemplate
旁路,十几条种子 SQL 的幂等守卫全是裸 `NOT EXISTS(column_key)`——换键后它不改就会一声不响地不再插行。
本批已把这条通道的 31 段种子语句逐条钉上 `company_id = 1`(落法与理由见 §5 末条,护栏见 §8)。
## 2. 三档定案(控制方「直接开干」,按推荐档落)
- **D1 存量授权**:V149 同笔把公司 2 那 16 笔授权按 `column_key` 重指向本公司副本。
不留成人工动作,否则德阳那 2 只账号一上线就掉光菜单(隐藏=静默删除)。
- **D2 谁能编辑别家的树**:站点超管可带 `company_id` 读写任意公司的树;非超管恒锁本公司,
传了别人的 `company_id` 一律 403。今天就是超管在给 133 只账号配权限,锁死本公司等于把这件活关掉。
- **D3 复制范围**:admin + app + internal 三种 `menu_type` 全复制(客户端账号同样分属两家公司,
只复制 admin 会留半棵共享树);**`admin_companies` 那一行不复制**——它是角色内在闸门
(`SUPER_ADMIN_ONLY_KEYS`),公司 2 的树里根本没有这行,比"有一行但看不见"更干净。
- **D4 之后新建的公司**:V149 只补当时已存在的公司,「公司管理 → 新增公司」必须同批建树,
否则新租户是一个零菜单行的公司(账号登录侧边栏全空、授权树一个勾都没有,全程不报错)。
落法见 §5 的 `copyTreeFromTemplate`,与建号同一次写入、不留"上线后手工再跑一遍复制段"。
## 3. 数据模型(V149)
1. `ADD COLUMN company_id bigint NULL`(末位)→ `UPDATE ... SET company_id = 1 WHERE company_id IS NULL`
→ `MODIFY COLUMN company_id bigint NOT NULL DEFAULT 1`。第三句同时是回填自检闸门:漏一行就抛 1048
(V143 同形)。`DEFAULT 1` 只为混合版本窗口的旧 jar 存在(旧 jar 的实体没这字段,严格模式建菜单会 1364),
摘除动作是下一版的一条纯元数据操作 `ALTER TABLE columns ALTER COLUMN company_id DROP DEFAULT`(**禁 MODIFY**,
重建会按当时的列默认值物化历史行),取号见 `backend-java/docs/migration-inventory.md`(当前 V152 起)。
哨兵 `CompanyDefaultGuard.WATCHED_TABLES` 已把 `columns` 探进清单——摘之前巡检每天多喊一条
`COMPANY_DEFAULT_STILL_PRESENT`,那是哨兵在干活,不是新故障。
2. 两条唯一键**先 ADD 后 DROP**(中间任一步失败都至少还有一个键在守并发):
`uk_company_column_key(company_id, column_key)`、
`uk_company_menu_type_route_path(company_id, menu_type, route_path)`。
新键是旧键的严格放宽 ⇒ 不会因重复失败。索引字节预算(utf8mb4):8+256=264、8+80+1020=1108,都远低于 3072。
3. 不加 `company_id` 的单列索引:新唯一键的最左前缀就是它,52 行的表再开索引就是 V139 那轮清理掉的冗余形状。
4. 复制:按「`company` 全表 × 公司 1 的字典行」插副本(不是硬编码公司 2,第三家开通时不用再改迁移),
`parent_id` **先留 NULL**,再由下一条 UPDATE 沿 `(company_id, column_key)` 把父指向重映射到同公司副本——
与插入顺序无关,两级三层都成立。带源值插入是错的:那是全局 id,副本会跨公司挂到厦门米椿花的分组上,
而 FK 只保证父行存在、挡不住挂在别家。
5. 授权重指向:`user_column_permission` 按「账号公司 = 行公司」重算 `column_id`。
重跑是 no-op(驱动条件要求行还挂在公司 1 上且账号不属于公司 1);重指前先摘掉"源行 + 副本"并存的重复授权,
否则重指会撞 PK `(user_id, column_id)` 报 1062。
6. 四道自检闸门(临时表 `must_be_zero INT NOT NULL`,V143 那个"约束替我喊"的家族):
① 每家公司的树与公司 1 一样齐(专防复制段被 `NOT EXISTS` 守卫一声不响挡掉一整家);
② 跨公司父指向残留 = 0;③ 跨公司授权残留 = 0;④ `company_id` 不为 NULL/不为 0。
不为 0 就让迁移失败,而不是留下一个静默分叉的树。
外键 `fk_columns_parent_id` 只保证父行存在,**挡不住跨公司挂父**,所以同公司判定必须在应用层(§4)。
## 4. 后端读侧:出口一起收窄
判据只有一个来源:`loadRawMenus(companyId, menuType)`。它是 `hasAnyAdminMenu`、`expandDescendantIds`、
`superAdminOnlyMenuIds`、授权树、有效菜单、`resolveGrantableMenuIds` 的共同上游,剪这一处等于剪一片。
| 出口 | 现在的形状 | 改成 |
| --- | --- | --- |
| `list()` 目录(菜单管理页) | 全量 52 行 | 按**操作者**公司;超管可用 `?company_id=` 指定 |
| `list(operator, type, true)` 授权树 | 操作者范围 | 范围集按操作者公司算,跨公司项永不下发 |
| `getUserColumnPermissions()` 有效菜单(登录/侧边栏) | `loadMenus(type)` 全表 | 按**被授权账号**公司 |
| `getUserColumnIds()` 回填集 | 同上 | 按目标账号公司 |
| `findDataPermission()`(`selectOne + LIMIT 1`) | 全局按 key 点查 | **必须带公司**:换键后同 key 有 N 行,`LIMIT 1` 会跨公司借位拿到别家的数据权限行——本次最危险的一处静默失效 |
| `hasEffectiveColumnPermission()` | 查得到就展开判定 | 行公司与账号公司不同 ⇒ 直接 false |
| `ensureUniqueColumnKey()` / `ensureUniqueRoutePath()` | 全局查重 | 本公司内查重;不改的话德阳在公司 1 建过的 key 上**根本建不出来** |
| `resolveSortOrder()` / `reorder()` | 同类型全局 MAX+1 / 兄弟集 | 同公司内 |
| `resolveMenuTypes()`(建号/编辑拆分 admin+app) | 按 id 归类 | **归类本身不带公司**(它按 id 批量取行,跨公司照样归得出类型);真正挡下别家 id 的是它下游的出口 3——`updateUserColumnPermissions` 的有效计数与 `loadMenus` 都按**目标账号公司**取,别家 id 在那里被抛 400「存在无效或不属于当前类型的菜单权限项」。这条要写准,否则下一个人会到 `resolveMenuTypes` 里找一道并不存在的公司闸门 |
| 两个数据范围授权端点 | 只挡超管,用户列表全量 | 数据权限行按公司解析,用户列表按公司筛 |
`hasEffectiveColumnPermission` 那处保守方向要说清:跨公司拿不到行时判"无权限",是拒绝而不是放行。
**"请求里的 `company_id` 到底在哪一步被收窄"要说准**:不在 controller 里写 `if`,也不在各页 service 里各写一遍,
而是收参数的当场交给 `PermissionMenuService.resolveScopeCompanyId(operator, companyId)`(公开方法,
把返回值**往下传**而不是丢掉),六个带这参数的 handler 全部同形——目录 GET/POST、两个数据范围授权的 GET 与 PUT:
```java
AdminUserEntity operator = requireAdmin(request);
Long scopeCompanyId = permissionMenuService.resolveScopeCompanyId(operator, companyId);
return ApiResponse.success(permissionMenuService.list(operator, menuType, grantableOnly, scopeCompanyId));
```
这条出口注册进了 `CompanyIdParamGoesThroughReadScopeTest` 的 `SCOPE_DOORS`(现在是**三道门**:
`readScope(`、`readCompanyIdOrOwn(`、`resolveScopeCompanyId(`),A/B/C/D 四条判据共用:
handler 收了 `company_id` 就必须走门、取到的绑定名必须真的出现在下游实参里。
所以"控制器多写一个带 `company_id` 的口却没过归属判定"是编译后跑一条用例就红,不靠人记着。
`PUT /permission-users/{userId}/columns` 与 `update`/`delete`/`reorder` 故意不带这个参数:
它们按行 id 或按被授权账号定位,归属在 service 里判(§5),前端再猜一个公司参数只会多出一个可伪造的入口。
## 5. 后端写侧
- `ensureAdminOperatorIfPresent` 只判 `isAdmin`,这是写侧唯一的洞——非超管今天能改整张目录。
补两条:目标行公司 = 操作者公司(超管除外,`ensureMenuWritable`);`ensureParentValid` 对**整条祖先链**
判同公司(一个同公司的父、上面挂着别家的分组,落库后这行在两棵树里都渲染不出)。
- `delete` 与 `reorder` 都先过 `ensureMenuWritable`;`reorder` 原来不带操作者(控制器那一层),已补。
- 新增菜单的归属:由**端点的 `company_id` 参数(缺省=操作者公司)**决定,前端不靠猜;超管传别家=给别家建。
读侧与写侧共用同一个判据 `resolveScopeCompanyId`——分成两个迟早漂移成「读能看别家、写挡不住」。
- `copyTreeFromTemplate(companyId, templateCompanyId)`(D4):`CompanyService.create` 在建号那笔事务里
调它,模板公司是**操作者本公司**(参数由调用方给,方法内部不编默认值;缺归属直接拒)。
两趟写与 V149 第 6/7 段同形:第一趟只管插、父先留空,第二趟按 `column_key` 认父;
`SUPER_ADMIN_ONLY_KEYS` 那行不进副本;目标公司已有的 key 原样保留 ⇒ 重跑只补差集。
- **旁路种子(`PermissionMenuSchemaInitializer`)只种公司 1**:七条 `INSERT INTO columns` 的列清单显式写
`company_id`、投影写真常量 `1`;判存守卫、认父 JOIN、按 key 的 UPDATE、三条下划线→连字符改名,
全部带 `company_id = 1`。理由是换键之后 `column_key` 只在单家公司内唯一——一条裸
`WHERE column_key = ...` 在这张表上的语义是"把每一家的同名行都改一遍"(别家副本的 parent 被拍平、
初始授权发给别家的行 id),而 `executeQuietly` 把 1048/1062 吞成一行 debug 日志,表现是"某一家
一声不响少一套菜单"。`grantInitialShopDataCrawlDataPermissions` 那条 JOIN 另加
`data_col.company_id = old_col.company_id`。显式写公司还有一层作用:这条通道不再依赖列上那条
`DEFAULT 1`,于是 §3 待办里那句 `DROP DEFAULT` 落地时不会让建号变成 1364。
别家公司的树不由这里插行——存量归 V149 的复制段,新建归 `copyTreeFromTemplate`。
## 6. 前端
每个响应只含一家公司的行 ⇒ `column_key` 在单响应内仍唯一,侧边栏、路由守卫、`hasMenuKey`、
`menu-route-map`、`parseMenuTree` 全不用改。这条不变量的看守是"查询条件必须带公司"本身
(§8 的 `everyMenuQueryCarriesTheOperatorsCompany` + `onlyTheSiteSuperAdminMayCrossCompanies`:
不传 `company_id` 时锁操作者本公司,超管显式指定才换家),不是"响应里数一遍 key 有没有重复"——
后者在假数据上永远为真,杀不掉任何变异。
- 「菜单管理」(`admin_columns`) 把 10-06 摘掉的公司 tab 装回来:`COMPANY_SCOPED_PAGES` 加一行
(正向清单 `companyTabAppliesTo` 自动放行,不需要新代码),`MenusPage.vue` watch `tab.activeId`
清掉本页那两个客户端筛选项(菜单名称/类型不进请求)并重取数。
- **「菜单管理」这一页带 `company_id` 的只有两个口**:`fetchMenuManageNodes`(GET 目录)与 `createMenu`(POST 新建)。
`updateMenu`/`deleteMenu`/`reorderMenus` 故意不带——它们按行 id 定位,归属判定在后端
(`ensureMenuWritable` 比较行公司与操作者公司,跨公司 403);前端再从树里猜一个公司参数只会多出一个可被伪造的入口。
- **用户管理里的授权弹窗必须带 `company_id`**(本条推翻初稿写的"不加参数:树按被授权账号的公司出,
载荷里的 id 天然同公司"——那句在 V149 之后是错的):一棵树一套 id,
授权树若按**操作者**公司下发,而目标账号在另一家(超管切了 tab 或在给自己以外公司的账号配权限),
则该账号已有的 `column_id` 全都不在这棵树里 ⇒ 已授权一项勾不上,点保存又被
`ensureGrantable` 判「无效的菜单权限项」,整页授权直接不可用。所以读侧(`fetchGrantableMenus`)
与写侧(按范围整树替换)必须同时收窄,只窄一侧等于把授权藏掉。
取值来源分两处、各对应后端真正会用的那一家:编辑弹窗用 `companyTab.requestCompanyId`
(列表本来就由它筛 ⇒ 行公司 = tab 公司),新建弹窗用 `form.companyId`(建号弹窗里选的那家,
与 `user-create-model` 下发给后端的 `payload.companyId` 同一个值;未选则为 null,后端落操作者本公司)。
- **两处没做界面暴露(本批只到后端)**:图片视频任务、店铺数据任务那两个「数据范围授权」弹窗
(`fetchImageVideoPermissionUsers` / `fetchShopDataTaskPermissionUsers` 及其 PUT 孪生)仍然一个公司参数都不发。
后端那两个端点本批已经收下 `company_id`(缺省=操作者本公司 ⇒ 与改动前同义,不是回归),
但站点超管在那两页切 tab 时弹窗候选不会跟着换家。这属于"新维度的界面暴露",按口径要单独批准,不在本批顺手做。
## 7. 发布顺序与混合版本窗口
路线甲(选定):V149 与 jar 同批发,双台同窗口(A 金丝雀过了立刻补 B),迁移在首台启动期执行。
V149 不是单独一支 jar:按 `backend-java/docs/migration-inventory.md`,下一版要连着跑 `V150__shop_key_company_scope`
与 `V151__rule_tables_shared_across_companies`(同批待发的另外两路),三条按序、一次启动跑完;
取号只认"当前最大值 + 1",V148 已随它被推翻的口径退役,不许回填。
窗口内旧 jar 的后果逐条列清:
- 目录/授权树会短时出现两排同名菜单(难看,不伤人);
- `findDataPermission` 的 `LIMIT 1` 借到公司 1 的行时,判的是"本公司授权集合里没有这个 id" ⇒ **拒绝而不是放行**;
- 建菜单会误报"菜单标识已存在"(旧 jar 的全局查重撞副本)。
都是分钟级、方向保守。路线乙(新 jar 带"本公司无行就回落公司 1"的临时分支)否决:那条回落正是
`ProductCategoryService` 这一轮刚拆掉的"哨兵 0 可见集"形状,而且公司 2 在两批之间看不到自己的树。
## 8. 自证(落码后按实物补,不写"补一些用例"这种没法核对的话)
| 面 | 看守 | 数量 |
| --- | --- | --- |
| 迁移形状 | `MenuTreeCompanyMigrationV149Test`:列存在且 NOT NULL、两条新复合键在、两条旧键已摘、`company_id` 无 NULL/无 0、复制段与重指段的驱动条件逐条在场、四道 `_v149_gate` 自检各就各位、回滚脚本不在 Flyway 扫描路径、**旁路种子逐条钉公司**(`schemaInitializerSeedsEveryRowIntoTheTemplateCompany`:31 段种子/14 段按 key 认菜单,取样集有下限,且喂一条已知违规必须被抓到) | 20 例 |
| 读侧收窄 | `PermissionMenuServiceCompanyScopeTest`:`loadRawMenus`/`findDataPermission`(`LIMIT 1` 借位那一形)/`hasEffectiveColumnPermission`/祖先链/重名查重/授权有效性计数/`resolveScopeCompanyId` 各按公司取;反向钉"不许出现回落公司 1 的临时分支" | 16 例 |
| 控制器 | `PermissionMenuControllerTest`:`company_id` **先过 `resolveScopeCompanyId` 再往下传**(六个 handler 各验一次,桩返回 `99L` 与原始 `7L` 不同值 ⇒ "传了原值"和"传了判定值"不可能双双通过),缺省 `null` 那两例同样进门而不是编一个默认公司 | 10 例 |
| 归属正门 | `CompanyIdParamGoesThroughReadScopeTest`:`SCOPE_DOORS` 从两道门加到三道(`readScope(` / `readCompanyIdOrOwn(` / `resolveScopeCompanyId(`),A/B/C/D 四条判据共用;新增三条 `menuScopeDoor*` 探针,其中"取到范围却丢掉"和"门参数列表里没有那个绑定名"两条必须红 | 3 例(含全部页面的取样) |
| 哨兵 | `CompanyDefaultGuardTest`:`columns` 同时进 `WATCHED_TABLES` 与探测 SQL 的 IN 清单(双向钉同源) | 14 例 |
| 闸门行不旁路 | `PermissionCompanyMenuHiddenTest`:本批给建树加了**第四处**出口,`SUPER_ADMIN_ONLY_KEYS` 的引用从"两处负向 + 一处反解"改成三处负向(`list` / `getUserColumnPermissions` / `copyTreeFromTemplate`)+ 一处正向反解,且只数剥掉注释后的可执行行——旧写法"整份文本里出现 ≥4 次"被 1 处定义 + 4 处 javadoc 就凑得满,三处过滤器全删照样绿 | 7 例 |
| 前端接线 | `company-tab-wiring.test.ts`:`admin_columns` 进 `COMPANY_SCOPED_PAGES` + `SEND_POINTS` 登记三处新发送口(全表 21 处 / 按 (文件,整行) 聚成 17 组,与真文件条数逐处对平)、`WATCH_BODY_PINS` 加 `MenusPage.vue` 一对(共 10 对) | `node --test` 1731 例全绿 |
| 前端文案 | `align-operation-guide.test.ts`:`admin_columns` 的引导文案补上公司 tab 那句(句子本体与分母规则见 `company-tab-design-2026-10-04.md`,不在本文件里):带 tab 那句的页面集合 = 注册表 16 页减去唯一豁免 = 15 页,多一页少一页都红 | 同一批 1731 例内 |
| 建司种子 | `CompanyServiceDirectoryTest`:`create` 在插公司行之后同一次写入里调 `copyTreeFromTemplate(新公司, 操作者本公司)`(`InOrder` 钉顺序);重名被拒那一笔反向钉"不许留下一套挂在不存在公司上的菜单" | 19 例(本批新增 2 例) |
| 类型 | `vue-tsc --noEmit` | 0 错误 |
| 全量(主树 2026-10-06 16:59 / 17:0x 实跑) | 后端 `mvn -o test`(无 skipTests)`Tests run: 3891, Failures: 0, Errors: 0, Skipped: 7` / BUILD SUCCESS,460 支测试类(逐类相加同为 3891);前端 `node --test tests/*.test.ts` 1731 例 / 0 红 | 本轮跑出的三条红见下节末「补记」 |
变异自证(已实跑,2026-10-06,在 `tmp/v149-wt` 独立 worktree 里,主树 `PermissionMenuService.java`
全程 md5 `2f29aa0bb39447dcab6f68878bd546b3` 未动):对 `PermissionMenuService` 逐点注入
"把 `.eq(…companyId…)` 改成 `.eq(false, …companyId…)`"(这一形就是"列名还在、值被丢"的静默失效原型)
以及三条建树/归属语义的反向改写,12 个点各开一次 mvn,分母恒为 `PermissionMenuServiceCompanyScopeTest` 的 16 例:
```
PRISTINE bytes=86315 lines=1615
BASELINE tests=16 failures=0 errors=0 rc=0 (401s)
KILLED loadRawMenus drops company red=4/16 (286s)
KILLED reorder siblings drop company red=1/16 (354s)
KILLED grant validity count drops target company red=1/16 (317s)
KILLED findDataPermission drops company (LIMIT 1 borrow) red=1/16 (211s)
KILLED ensureUniqueColumnKey drops company red=1/16 (193s)
KILLED grantableUserQuery drops company red=1/16 (216s)
KILLED resolveScopeCompanyId lets anyone cross companies red=1/16 (182s)
KILLED ensureMenuWritable stops guarding red=1/16 (135s)
KILLED hasEffectiveColumnPermission stops denying foreign id red=1/16 (163s)
KILLED ensureParentValid stops checking ancestor chain red=2/16 (208s)
KILLED copyTree clones the role-intrinsic gate row red=1/16 (193s)
KILLED copyTree no longer short-circuits self-copy red=1/16 (137s)
RESTORE-CHECK ok
SUMMARY injected=12 killed=12 survived=0 void=0
```
`red=4/16` 那一处(`loadRawMenus`)是唯一的公共读口,四条用例同时红;其余各点各红 1 条,
`ensureParentValid` 红 2 条。两条 `copyTree` 变异分别被「建树:三种 menu_type 全复制、闸门行不复制」
和「建树不许靠默认值兜」这两条打死——D3(不复制 `admin_companies`)与"不自拷"都由这套用例独立看守,
不是靠读侧顺带压住的;本轮选中的类只有 `PermissionMenuServiceCompanyScopeTest`(分母恒 16),
所以这 12 条红全部出在它内部。`CompanyService.create` 那一笔种树调用另由
`CompanyServiceDirectoryTest` 的「插行之后同一次写入里复制菜单树」与「建公司被拒时不建树」两条钉住
(验的是调用点与顺序,不在变异分母里)。
**补记(那 12 轮之后全量跑出的三条红,加一处顺带收口)**:上面那份日志的 md5 只覆盖到扫描时点,
之后的改动不在那 12 个点里,各自另加了尺子——
1. **后端红**:控制器六个 handler 收了 `company_id` 却没走任何归属出口
(`CompanyIdParamGoesThroughReadScopeTest` 断言 A 红)。修法不是往 `READ_SCOPE_ALLOWLIST` 里添六条豁免,
而是把 `resolveScopeCompanyId` 注册成**第三道正门**,并给它配三条自己的探针(能过 / 取了丢掉 / 传 null),
让"下一个新页面忘了收口"这件事仍然是编译后跑一条用例就红。
2. **后端红**:`copyTreeFromTemplate` 是 `SUPER_ADMIN_ONLY_KEYS` 的第四处引用点
(`PermissionCompanyMenuHiddenTest` 红)。这条 SDD 台账里预先写过(要求加变异 + 把期望从
"恰 2 负 + 恰 1 正 + ≥4"往前挪),本批按它挪成 **恰 3 负 + 恰 1 正 + 定义与出口共 ≥5 行**;
对应变异就是那份日志里的第 11 轮 `copyTree clones the role-intrinsic gate row`(已被打死,`red=1/16`)。
3. **前端红**:`align-user-menu-grantable.test.ts:105` 原本把控制器的调用形状钉成
`list(requireAdmin(request), menuType, grantableOnly, companyId)`(原值透传),本批改过门之后它红。
这条不是"测试写错了",而是**前端侧唯一读 Java 控制器源的那把尺子**——挪成新形状时补了一条
`doesNotMatch(/menuType, grantableOnly, companyId\s*\)/)` 反向钉:不许有人图省事把 tab 原文再透传回去。
4. **顺带收口**:旁路种子(`PermissionMenuSchemaInitializer`)的 31 段种子逐条钉上 `company_id`,
并加 `schemaInitializerSeedsEveryRowIntoTheTemplateCompany` 反向钉住——这条通道的失效形状是
`executeQuietly` 把 SQL 错误吞成 debug 日志,"某一家少一套菜单"不会喊。
这些都不在变异分母 16 例里(护栏形状与文件形状,不是运行时行为),靠的是各自用例里的取样下限 +
已知违规探针;验收读数是本轮主树实跑:后端 `mvn -o test` **3891 例 / 0 红 / 7 skip**(460 支类,逐类相加同为 3891),
前端 `node --test tests/*.test.ts` **1731 例 / 0 红**。
线上复验探针(发版后只读跑):`scripts/_probe_menu_company_shape.py` 在原有 8 条之后加了 5 条——
各家 × `menu_type` 的行数(每家必须与公司 1 一样齐)、跨公司挂父 = 0、跨公司授权残留 = 0、
`admin_companies` 那一行不在公司 1 之外、`columns.company_id` 的 `COLUMN_DEFAULT`(摘 DEFAULT 那条待办的复验口)。
发版前跑这五条会各回一条 `Unknown column 'company_id'`——那是列还没有,不是探针坏,五条各有 `@@` 标记互不牵连。
生产写操作一律先取证 → 备份 → `--apply`,由控制方执行或明确授权后代跑。
## 9. 回滚
`backend-java/docs/rollback-V149-permission-menu-company.sql`(Flyway 扫描路径之外):
授权重指回公司 1 的行 → 删副本 → 换回两条旧唯一键 → `DROP COLUMN company_id` →
删 `flyway_schema_history` 的 version=149 行 → 回滚 jar → 起应用。
副本 `column_id` 一旦有新增授权,回滚脚本先报数再停手,不做静默删除。
## 10. 发版命令包(本批 0 手工 SQL:迁移在 jar 启动期由 Flyway 跑)
前提:两支待发的后端批次(V149 本批 + V150/V151 店铺密钥与规则库)都要先进同一个提交,
出包树才能同时带上三条迁移;前端要带本批的 `admin_columns` 接线与 10-06 那三个公司 tab 文件。
提交与推送由控制方决定,代跑生产写操作需要明确授权。
**下面每一行都在同一个目录下跑:工作区根 `D:\todesk\副业\数富AI`**(`scripts/` 在这一层,
`crawler-plugin/` 也在这一层)。前面那条 `cd` 会把后面几行带到别的目录里去,所以每条需要换目录的
都用子 shell 括号包住,不留状态。
**发版前取证(只读,我可以自己跑)**
```
python scripts/_probe_jar_md5.py # 两台现网 jar 的 md5 与体积(回滚点)
python scripts/_probe_menu_company_shape.py # 基线:前 8 条有数,后 5 条回 Unknown column 'company_id' 才是对的
```
**出包(本地,从干净 worktree;入口与输入件路径 10-06 逐条 `-e` 验过存在)**
```
git -C crawler-plugin worktree add crawler-plugin/tmp/v149-build <含本批的提交>
# 三处文档输入未入库,读者是 ExplainIndexAuditDocTest / ArchitecturePlanSection6DocTest / IndexMigrationV101Test:
cp -r crawler-plugin/backend-java/docs/specs crawler-plugin/tmp/v149-build/backend-java/docs/
cp crawler-plugin/backend-java/docs/explain-index-audit.md \
crawler-plugin/backend-java/docs/java-architecture-optimization-plan.md \
crawler-plugin/tmp/v149-build/backend-java/docs/
(cd crawler-plugin/tmp/v149-build/backend-java && mvn -o clean package) # 上线不许 skipTests;clean 只在出包树,主树禁
ls -l crawler-plugin/tmp/v149-build/backend-java/target/*.jar
```
**发布(写生产,两台同窗,逐台健康门禁按主机给端口:A 18080 / B 19080)**
```
python scripts/_deploy_verified_jar.py <jar路径> <期望md5> --check # 只读:记录线上 md5 + 两台健康
python scripts/_deploy_verified_jar.py <jar路径> <期望md5> # 上传 → 校验 → 重启 → 健康 → 复核
(cd crawler-plugin/admin-frontend-vue && npm run build)
python scripts/_deploy_admin_vue.py # dist 只在主机B /var/www,软链原子切
```
**发版后复验(只读)**
```
python scripts/_probe_menu_company_shape.py # cols_by_company 各家行数须等于公司 1;三条残留须为 0;
# admin_companies_outside_company1 须为 0(D3)
python scripts/_prod_watch.py --window 30m # ALERTS 只认 † 那几条;本批预期多一条 COMPANY_DEFAULT_STILL_PRESENT
# (columns 进了哨兵清单,摘 DEFAULT 之前它每天都在喊,那是哨兵在干活)
```
前端两件事各自单独核:**线上树 == 本地构建**用整树聚合摘要(本地在 `dist` 上跑、远端在
`/var/www/admin-vue-<ts>` 上跑同一条管道,两个值必须相等):
```
(cd crawler-plugin/admin-frontend-vue/dist && find . -type f | sort | xargs md5sum | cut -d' ' -f1 | sort | md5sum)
```
**这版到底带没带本批的接线**用扛得住 minify 的字面量数:`dist/assets/MenusPage-*.js` 里 `company_id` 应为 2
(目录 + 新建),带 `grantableOnly` 的那个 UsersPage chunk 里应为 1(授权树)。
本地 10-06 17:05 那版构建(`vue-tsc --noEmit` 0 错误、`npm run build` RC=0)实测就是这两个数:
`MenusPage-Cui-Lsn1.js` `company_id`=2、`UsersPage-DeJ6Wy_U.js` `company_id`=1(同文件 `grantableOnly`=2)。