diff --git a/docs/plans/19-company-tab.md b/docs/plans/19-company-tab.md index 3324f6069..c355e25cd 100644 --- a/docs/plans/19-company-tab.md +++ b/docs/plans/19-company-tab.md @@ -2719,4 +2719,16 @@ git commit -m "docs(公司tab): 批次 0-1 出厂记录 + 批次 2/3 前置闸 处置只有两条,都由用户决定:① 把这 4 行的 `created_by_id` 归到在职账号名下(`UPDATE`,我只交付命令不执行); ② 接受这 4 行只存在于库里、界面上不再出现。**注意这两行的凭据仍可按 id 读到**(超管走 `superAdmin` 短路、 `/{id}/credential` 不收 tab),所以"看不见"不等于"读不到",验收时别把这两件事混报(Task 11 评审遗留项,已取证)。 +- **日志管理那 22 行 `source='client'` 且 `uid IS NULL` 的匿名客户端日志:选了公司就不出现(定案 (a),代码刻意不加 `IS NULL` 那条腿)**: + 2026-10-05 15:1x 主机 A 业务库只读实查 `device_log_file` 共 **1028** 行(`client` **831** / `maixiang` **197**),其中 `uid IS NULL` 的 + `client` **22** 行(22/831 = 2.6%,22/1028 = 2.1%)⇒ `(source='maixiang' OR uid IN (成员集))` 这个形状会把它们抹掉。 + **为什么不放行**:麦象那 197 行能进每一家 tab,前提是它是**平台自己的采集机**(基础设施,不属于任何一家);这 22 行的性质是"桌面端没登录", + 它们是某家的资产、只是没有账号替它们认领。给它们加一条 `uid IS NULL` 腿 = 让同一条**无归属**行在家家 tab 各出现一次,那是错的归属, + 并且把"这家有多少条日志"这个数变成不可用;而且 `uid IS NULL` 对将来任何新来源同样成立(今天钉 22 行,明天就是"凡没账号的都全局可见")。 + **代价要说比例,别只说"仍拿得到全量"**:① 这 22 行**在界面上点不回来**——tab 条按 §12 第 2 条没有「全部公司」那一枚,默认落在 `id` 最小的启用公司; + ② 兜底只在后端成立:`GET /api/admin/device-logs/files` 的 `company_id` 是 `required = false`,不传 ⇒ unfiltered ⇒ 一条条件都不叠 + (`nullMemberSetKeepsOldBehaviour` 钉着),要看全量只能走接口、不能走这页的界面;③ 这页 9 支端点全在 `requireSuperAdmin` 之后, + **不存在超管之外的读者**,所以"消失"是过滤器效果,既不是越权面收窄、也不影响任何账号的日常使用。 + 若将来要让它们在界面上可见,正路不是加 SQL 腿,而是给 tab 条补一枚「全部公司」⇒ 那是 §12 第 5 条**未批**的界面暴露,要单独授权。 + (Task 12 定案,2026-10-05 记;钉住这个形状的实跑用例是 `DeviceLogServiceTest.anonymousClientRowsFallOutOfEveryCompanyTabByDecision`。) - 不碰二期的 V145 迁移文件(已在 `b7873209` 提交,本计划不改它、不替它决定上线时机——上线时机是 Task 13 Step 2 那条要用户拍板的显式决定)。