docs(计划): 18 号计划补执行记录,写清 Task 3–8 已停、串扰仍未解决

计划正文不改写(它记的是当时的判断),以「执行记录」段做对账:
Task 0/1/2 完成与两处被实查数据推翻的偏离、Task 3–8 按用户指令停止、Task 9 取消并反向执行。

最关键的一条要留在文档最显眼处:**V145 单独上线不解决跨公司串扰**,
A 公司导入的 ASIN 仍会被 B 公司的去重掉,止血点在消费侧那四个裸 SQL 出口(Task 5–6)。
哪天接着做,从这里接。取号起点同时订正为 V146。
This commit is contained in:
2026-10-04 16:15:22 +08:00
parent ce69fa217c
commit f9356e95c9
@@ -22,7 +22,7 @@
1. **不许原地改已应用到生产的迁移。** V142(校验和 `1152261840`)、V143(`1539570901`)已封死;V144 已在生产应用,其校验和由 Task 2 Step 1 实查后补进冻结清单。`spring.flyway.validate-on-migrate=true` 是硬编码,改字节 = 下次启动两台 java 都起不来。
2. **迁移逐条幂等**(spec §5.1):`ADD COLUMN`/`ADD INDEX` 先查 `information_schema` 再 `PREPARE`,`DROP INDEX` 先判存在,`UPDATE` 用 `WHERE ... IS NULL` 限定。理由:`flyway repair` + 重启会从第一条语句重跑整个文件,而 MySQL DDL 不进事务。
3. **回滚不写成 `V146`**(spec §5.6):`src/main/resources/db/` 是 Flyway 扫描路径,版本化回滚等于让人工决定自己发生。回滚 = `backend-java/docs/rollback-V145-company-scope.sql`。
4. **取号看盘点文档**:当前最大 `V144`、143 个文件,`docs/migration-inventory.md` 已写明"后续新增迁移从 **V145** 起取号"。不许为没写出来的迁移预留号段(1..max 留洞会让 `MigrationInventoryTest#integerVersionsSequentialFromOne` 红)。
4. **取号看盘点文档**:V145 已落盘(当前最大 `V145`、144 个文件),`docs/migration-inventory.md` 已写明"后续新增迁移从 **V146** 起取号"。不许为没写出来的迁移预留号段(1..max 留洞会让 `MigrationInventoryTest#integerVersionsSequentialFromOne` 红)。
5. **写侧不得依赖数据库 `DEFAULT 1` 兜住漏传**(spec §6.3):实体进 mapper 前 `company_id == null` 必须抛异常。这条 DEFAULT 只为混合版本窗口存在(spec §11.2),且失败很安静——`CollectDataInvalidAsinBatchWriter.java:58-60` 会 `catch (RuntimeException) → log.warn` 跳过整批,接口照样返回成功。
6. **不许用前缀索引迁就长度**(spec §4,依据 `db/V135:6-9`):去重库 `data_value` 的前缀唯一索引会把"前 N 字符相同"的不同值误判为重复。字节预算已算:`uk_company_value_brand` = 8 + 128×4 + 191×4 = **1284 B**;`uk_company_data_value` = 8 + 512×4 = **2056 B**;都 < 3072(DYNAMIC + utf8mb4)。
7. **两张 jar 必须同版**:后台 `/api` 经主机 B 的 clb 打到两台。**逐节点复验不能打 `0.0.0.0:18080`**(那是 nginx 轮询池),主机 B 的 java 在 `127.0.0.1:19080`。
@@ -57,6 +57,23 @@
---
## 执行记录(2026-10-04 15:5x,计划与现状的对账,后来者先读这段)
**已完成:** Task 0(生产只读取证)、Task 1(`CompanyScopeSupport`,已提交 `8cb53e6b`)、Task 2(V145 + 回滚脚本 + 审计用例 + 哨兵扩容 + V144 进冻结清单)。Task 2 的验证:`CompanyScopeMigrationV145Test` 13 例、`CompanyMigrationV144Test` 8 例、`CompanyDefaultGuardTest` 12 例、`MigrationInventoryTest` 8 例全绿;变异自证 17 轮全被杀(含"摘掉 INSTANT 钉法""用 MODIFY 收 nullability""反推 UPDATE 丢幂等限定""回滚把 DROP COLUMN 变成默认动作""原地改已应用的 V144 一个空格")。
**两处对计划的偏离(都是实查数据推翻计划,计划正文未改写,以此段为准):**
1. **Task 2 没按三段式写。** 计划抄的是 V143 的「加可空列 → 全表回填 → MODIFY 收 NOT NULL」。生产 `biz_dedupe_total_data` 实测 **507,306 行 / 181.3 MB**、MySQL **8.4.8**:非末位加列与 `MODIFY` 改 nullability 都要重建表,单语句全表回填会对所有扫描行持 X 锁。V145 因此改成**末位加列 + 显式钉 `ALGORITHM = INSTANT`**、列直接建成 `NOT NULL DEFAULT 1`、索引四条钉 `INPLACE, LOCK = NONE`,回填那一步换成一条**由 users 驱动、带 `d.company_id = 1` 幂等限定**的反推 UPDATE(只动第 2 家账号上传的行,走 `idx_uploader_user_id_id` 点查)。
2. **DEFAULT 的摘除时点被现实压缩。** 计划假定"第二家公司开通前摘掉 DEFAULT",实际 `company.id=2` 已于 **10-04 14:55 开通**(账号 `users.id=1193`,140 个账号里唯一 `company_id<>1`)。所以 V145 保留 `DEFAULT 1`(混合版本窗口必需),把"紧随本次发布出 V146 摘 DEFAULT"写进头注释,并让启动期哨兵 `CompanyDefaultGuard` 从只探 `users` 扩成探 `users` + 两张规则库表。**注意:摘 DEFAULT 必须用 `ALTER TABLE t ALTER COLUMN company_id DROP DEFAULT`(纯元数据),不能照 V144 用 MODIFY——表重建会按当时的列默认值物化 instant 列,把反推好的归属洗回 1。**
**Task 3–8:停止(用户 10-04 15:5x 指令)。** 写侧/消费侧/读侧的公司维度都没有落地,因此**跨公司串扰仍然存在**:A 公司导入的 ASIN 仍会被 B 公司的去重掉,根因是 `uk_data_value` 全局唯一键之外的消费侧裸 SQL(`CollectDataBatchQuery` 等四个出口)不按公司过滤。V145 单独上线**不解决这件事**——它只是让归属开始被记录、并把新唯一键准备好。
**Task 9:取消,反向执行。** 用户同时定案"公司维度不在前端出现",所以两页不加公司列,反而把一期已上线的公司展示全部摘掉(列/筛选/建号选择/顶栏旁白)。建号请求体不再带 `company_id`,归属由后端 `AdminUserService#resolveTargetCompanyId` 落操作者自己的公司——这条前端删下拉的安全依据被 `admin-frontend-vue/tests/company-user-create.test.ts` 用跨仓读取钉成可执行断言(后端两条"落操作者公司"分支少任何一条,前端测试即红)。保留:公司管理页(启用/停用)、后端 `company_id` 接口参数。
顺带修一处被这次改动变成假话的文案:「公司管理」页的引导语原写"建号时选哪家公司",下拉删掉后它承诺了一个不存在的选择器;同时"停用后不能再用于新建账号"也不再成立——`companyService.requireActive` 只有两个调用点(`AdminUserService:211`/`:228`),都要求 `company_id != null`,而页面现在一律不传,所以这条从后台 UI 走不到(接口直连的老调用方仍受保护)。文案改为"落在操作者自己所在的公司,要给别家建号请用那家公司自己的管理员登录",并由 `company-user-create.test.ts` 反向断言这三句失效说法不得回流。
---
## Task 0: 上线前生产只读取证(把 spec §5.4 那两个空填上)
**Files:** 无代码改动;结果写进 Task 2 的迁移头注释与 spec §5.4。