diff --git a/docs/plans/19-company-tab.md b/docs/plans/19-company-tab.md index 74eebd209..1d8e03a93 100644 --- a/docs/plans/19-company-tab.md +++ b/docs/plans/19-company-tab.md @@ -2419,6 +2419,8 @@ SELECT source, COUNT(*) FROM device_log_file GROUP BY source; - 客户端占多数 ⇒ 留在批次 1,Step 1 起往下做。 - 结果抄进本任务的提交信息。**"0 命中"或只出一个 source 时先怀疑抓错表**:配一个 `SELECT COUNT(*) FROM device_log_file` 做非零对照(memory「grep -v 过滤器连 stdout 一起吞、0 命中≠没有」)。 +✅ **已实跑(2026-10-05 15:1x,主机 A 业务库只读,非零对照齐全)**:`COUNT(*)` = **1028**;`GROUP BY source` = `client` **831** / `maixiang` **197**(831+197=1028,与对照逐数相符)⇒ **客户端占多数 ⇒ 这页留在批次 1,`companyScoped` 照声明,Step 1 起往下做**。另有一条本任务要用:`WHERE uid IS NULL GROUP BY source` = `client` **22** / `maixiang` **197** ⇒ 那 22 行是"有 source=client 但没有账号可归属"的一族,`(maixiang OR uid IN (成员集))` 那个形状照样会把它们抹掉 ⇒ Step 1 的用例要替它们说句话(放行还是接受消失,二选一写进附B,不许沉默)。 + - [ ] **Step 1: 写失败的测试(这条测试的价值全在"麦象行不许消失")** ```java @@ -2625,8 +2627,8 @@ git diff --name-only e42b37c1..<本批次构建的commit> -- backend-java/src/ma - **建号**:超管切到第 2 家 tab 建一个账号 → 查库确认新账号 `company_id` 是**1**(超管自己那家),没跟着 tab 走 —— 这是设计(`AdminUserService.resolveTargetCompanyId`,spec §6.3)。 - **店铺**:⚠️ **这页的预期完全不同**。店铺的 `created_by_id` 来自请求体(Task 11 Step 4 那条更正),所以"新建店铺的归属跟着 tab 走吗"这个问题问错了。要验的是两件事:① 负责人选超管自己 ⇒ `created_by_id=超管`、这家账号所属公司为 1;② 负责人选 `users.id=1193` ⇒ 店铺**就归第 2 家**(今天已经能做,本轮没改它)。**别把 ② 报成"tab 生效了"**,那是负责人字段生效,与 tab 无关。 - 两条都要再验一次"切 tab 不改变上述任何一条"。测完删掉测试行(只交付命令,用户执行)。 -5. **凭据读出口随 tab 收窄**(Task 11 Step 3(d) 的账,这条 `mvn test` 验不到):超管切到第 2 家 tab → 从 Network 里取一个**第 1 家**店铺的 id 直接请求 `GET /api/admin/shop-manages//credential` → **403**,不是 200 + 明文密码。反向再验一次:不切 tab(或切回第 1 家)同一请求必须 200,否则就是闸门写死成了"非当前 tab 全禁"。 -6. **麦象日志不消失**(Task 12 的账):切任意公司 tab,日志管理里 `source=maixiang` 的行必须还在。 +5. **凭据读出口按会话收窄**(Task 11 Step 3(d) 的账,这条 `mvn test` 验不到)。⚠️ **2026-10-05 执行时订正原预期**:原写「超管切到第 2 家 tab → 按 id 请求 ⇒ 403」,实现做出来是**另一件事**,而那一件才是 §6.1 要的。理由:`adminCredential` 若靠调用方自己带 `company_id` 才收窄,**不带参数的请求就绕过闸门**——而按 id 读明文密码的越权面,越权的人本来就不会替你把 tab 的公司 id 带上;那等于"只拦老实人"的装饰,落进 memory「护栏要做进代码出口」的反面。本仓已有的范形是 Task 8 的 `AdminImageVideoTaskController.detail/download-zip`:私有 `scopeOf(operator)` = `readScope(operator, null)` ⇒ **超管不筛(tab 不是安全边界,Constraint 2),非超管与内部令牌按其可见成员集收窄**。⇒ 这条验收改成两读:① 用一个**主管**账号(不是超管)从 Network 里取一个不属于它可见集的店铺 id 请求 `GET /api/admin/shop-manages//credential` → **403**,不是 200 + 明文密码;② 超管在**任意 tab** 下同一请求必须 **200**——若这里红了,说明闸门被写死成"非当前 tab 全禁",那是回归不是收紧。③ 顺手确认这条**没有**波及 `GET /credential?shopName=`(4.0.44 客户端与 Python 自动化走的那条,本轮刻意不动)。 +6. **麦象日志不消失**(Task 12 的账):切任意公司 tab,日志管理里 `source=maixiang` 的行必须还在。⚠️ 生产只读实测(10-05,`device_log_file` 共 1028 行):`client` 831 / `maixiang` 197,**但 `client` 里有 22 行 `uid IS NULL`**(22/831=2.6%)——这 22 行按「`source='maixiang' OR uid IN (成员集)`」的形状仍会被筛掉,Task 12 要么给它一条同族的"无法归属"放行腿,要么在附B 里明写这 22 行在各 tab 下消失是设计。 7. **保存权限不炸**(Task 4 的账):给一个历史带 `admin_companies` 授权的账号保存一次权限 → 成功 + 日志 `GRANT_SUPER_ADMIN_ONLY_STRIPPED`。 8. **文案这三眼看**(§9.3 / §5 的账,`node --test` 只能验"字符串在不在",验不到"读的人怎么理解"):①超管在任意一页看到引导条那句"超级管理员可用页面上方的公司 tab 切换公司"时,tab 条**确实在它上方**(Task 7 Step 4 挂的是 `` 与 `` 之间,顺序反了这句话就指错了方向);②引导条被收起过的人看不见这句——找一个 `localStorage.shufuAdminGuideCollapsed='1'` 的浏览器确认这不是硬伤,并在运维手册里说明这句的位置;③非超管账号读同一句时不会去找那个他根本不会有的控件(这句以"超级管理员"开头就是为这一步,若真读着别扭,改法是加 `isSuperAdmin` 分支而不是改回祈使句)。 - [ ] **Step 4: 更新两份文档 + 清掉我自己留下的临时件**