docs(菜单权限): 上线复验记录,并改掉两处与实现不符的注释

§11 记下 17:3x 的实跑读数(jar 08b79b33… / Flyway 到 151 / 库侧三条残留为 0 /
两台逐行一致的行为侧 E2E / admin-vue 聚合摘要对平 / 巡检 3 条告警的归因)。

两处注释是复验当场证伪的:menu-manage-api.ts 与 company-scope.ts 都写着
"超管不带 company_id 拿到的是全部公司的行(两排同名菜单)",实测拿到的是本公司那 26 行
—— resolveScopeCompanyId 在参数为空时对超管也返回操作者本公司。留着这句话,
下一个人会以为不传参也能看到别家,从而把 tab 的显式传参当成多余的。

不改行为:后端这道门本就该默认锁本公司。
This commit is contained in:
2026-10-06 17:46:32 +08:00
parent b7acfc0eef
commit b0444f0903
3 changed files with 54 additions and 2 deletions
@@ -51,7 +51,8 @@ export const COMPANY_SCOPED_PAGES: readonly CompanyScopedPage[] = [
{ menuKey: 'admin_shop_keys', apiFiles: ['src/pages/shop/shop-key-api.ts'], pageFiles: ['src/pages/shop/ShopKeysPage.vue'] },
// 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」,并选了「每家公司一套菜单树」那一档)。
// V149 给 columns 加 company_id 并把 52 行复制成每家一套 ⇒ 同一 column_key 在别家有另一份 id:
// 不带 company_id 时超管拿到的是两家混在一起的目录(两排同名菜单),勾出来的 id 又会撞
// 不带 company_id 时后端只给操作者本公司那一棵(2026-10-06 生产实测),超管切看别家必须显式带;
// 而一旦漏带又去勾别家的项,提交的 id 属于另一棵树,后端按本公司菜单集校验就会撞
// 「无效的菜单权限项」。写侧(编辑/删除/重排)不带参数——归属由那一行的 id 与操作者公司共同判定,
// 跨公司写后端 403(见 docs/ops/menu-company-tree-design-2026-10-06.md §5)。
{ menuKey: 'admin_columns', apiFiles: ['src/pages/account/menu-manage-api.ts'], pageFiles: ['src/pages/account/MenusPage.vue'] },
@@ -16,7 +16,8 @@ export const REORDER_ENDPOINT = '/api/admin/column/reorder'
/** 拉取扁平可编辑菜单节点(全量类型,对齐 admin.js loadColumns 的 /api/admin/columns 语义)。
* 公司 tab 的值由调用方(MenusPage)传 companyTab.requestCompanyId:菜单字典 2026-10-06 起每家公司一套树,
* 不带 company_id 时非超管恒锁本公司、超管拿到的是全部公司的行(两排同名菜单)。 */
* 不带 company_id 时后端一律取操作者本公司(2026-10-06 生产实测:超管不带也只得本公司那 26 行),
* 所以切到别家必须显式传,tab 的值不能省。 */
export async function fetchMenuManageNodes(companyId?: number | null): Promise<MenuManageNode[]> {
const query: Record<string, string | number> = {}
if (companyId != null) query.company_id = companyId
@@ -309,3 +309,53 @@ python scripts/_prod_watch.py --window 30m # ALERTS 只认 † 那几条;
(目录 + 新建),带 `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)。
## 11. 上线后复验(2026-10-06 17:3x–17:4x 实跑读数,不是计划)
**发版**:提交 `1d27806a`(本批 + 并行的 V150/V151 合在一笔,理由见提交说明)→ 出包树
`crawler-plugin/tmp/v149-build`(`mvn -o clean package` 不 skipTests)→ `Tests run: 3891, Failures: 0,
Errors: 0, Skipped: 7` / BUILD SUCCESS → jar `08b79b334091a80e2493d9de1bc9392a` / 137,499,094 B。
两台上传后远端 md5 复核一致、health=200;回滚点 `.bak-20261006173005`(A) / `.bak-20261006173210`(B),
上一版是 `39f6640745b985f5be32cb384eb8e220`。Flyway 到 **151**:rank 59/60/61 = 149/150/151,
`success=1`,时间 17:32:29–30(只在先起的那台跑一次)。
**库侧形状**(`_probe_menu_company_shape.py`):`columns` 52→154 行,每家 admin 26/25/25、app 24、internal 2;
`cross_company_parent` = 0、`cross_company_grant` = 0、`admin_companies_outside_company1` = 0(D3 成立);
旧键 `uk_column_key`/`uk_menu_type_route_path` 已被 `uk_company_column_key`/`uk_company_menu_type_route_path`
替换;`dup_keys` 从发版前 0 变成 51 = 每家一份同名 key 的必然结果(不是回归)。
`grant_shape` 的 788 笔没变、而 `COUNT(DISTINCT column_id)` 从 34 涨到 50 = 恰好 +16,
对上 D1「公司 2 的 16 笔重指向到自己副本」这个数。
`company_id` 仍是 `NOT NULL DEFAULT 1` ⇒ 摘 DEFAULT 那条元数据操作仍欠着(下一版做)。
V150:`biz_shop_key.company_id` 已加、16 行全归公司 1。V151:`biz_invalid_asin_data` 唯一键回到
`uk_data_value_brand(data_value,brand)`、`biz_product_category` 回到 `uk_product_category_key(category_key)`
(412 行 / 412 个不同 key ⇒ 全局唯一 satisfiable)。
**行为侧(内部令牌 + `operatorId`,两台各打一遍,逐行一致)**:
只打 `GET /api/admin/permission-menus?menuType=admin`。**注意判据**:越界时 HTTP 仍是 200,
拒绝在响应体的 `"code":403`(86 B)里 ⇒ 只看 `%{http_code}` 会把 403 读成放行。
行数锚 `"column_key"`(VO 上是 `@JsonProperty("column_key")`,锚 `columnKey` 恒 0)。
| 操作者 | 参数 | 读数 |
|---|---|---|
| 超管 1 | 不带 | 26 行、含 `admin_companies` |
| 超管 1 | `company_id=1/2/3` | 26 / 25 / 25 行,别两家不含 `admin_companies` |
| 公司 2 管理员 1193 | 不带 / `company_id=1` | 25 行 / `"code":403` |
| 公司 1 管理员 3(非超管) | 不带 / `company_id=2` | 26 行 / `"code":403` |
| 公司 3 `company_super_admin` 1201 | 不带 / `company_id=1` | 25 行 / `"code":403` |
两点要记:① **超管不带 `company_id` 拿的是本公司那 26 行,不是三家混合**(`resolveScopeCompanyId`
在 `requestedCompanyId == null` 时直接返回操作者公司,对超管也不例外)—— 前端 `menu-manage-api.ts`
与 `company-scope.ts` 原先写的"超管拿到全部公司的行/两排同名菜单"与实现不符,已随本次复验改口。
② `company_super_admin` 不算站点超管(跨家读被 403 挡住),这与 D2 只放开 `super_admin` 一致。
**前端**:`admin-vue-20261006-173552`(回滚点 `20261006-110820`),远端整树聚合摘要
`eda9c8af236ae46e067e8ddcc0f62a3f` == 本地构建;`MenusPage-Cui-Lsn1.js` `company_id`=2、
`UsersPage-DeJ6Wy_U.js` `company_id`=1。改那两处注释后重建,摘要逐字未变 ⇒ minify 剥注释,
现网 dist 就是改注释之后的构建,不必重发。前端全量 **1731 例 / 0 红**。
**巡检 `--window 30m`**:ALERTS=3 = `公司DEFAULT未摘` 两台各 1(哨兵在干活,本批新增 `columns` 进清单)
+ 主机B `类加载=121`。后者已归因:121 条全部落在重启那一分钟 `09:32Z`(=17:32 本地),之后 12 分钟
12,611 行日志里 0 条,而 A 同版同窗口 0 条 —— 与 10-05 记下的"启动窗口惰性类加载被首批请求抢跑"同形,
不是本批引入。缺的类是 `StandardMultipartHttpServletRequest`、`PropertyMetaData$1`、
`SimilarAsinTaskDetailVo` 这类首次使用才加载的东西,与本批改动无交集。
**未做**:真人浏览器打开「菜单权限」页看两排 tab 与切换后的树,仍欠。