From f9356e95c925cf9befe6fc57f8e365749917b50a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Sun, 4 Oct 2026 16:15:22 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=AE=A1=E5=88=92):=2018=20=E5=8F=B7?= =?UTF-8?q?=E8=AE=A1=E5=88=92=E8=A1=A5=E6=89=A7=E8=A1=8C=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=EF=BC=8C=E5=86=99=E6=B8=85=20Task=203=E2=80=938=20=E5=B7=B2?= =?UTF-8?q?=E5=81=9C=E3=80=81=E4=B8=B2=E6=89=B0=E4=BB=8D=E6=9C=AA=E8=A7=A3?= =?UTF-8?q?=E5=86=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 计划正文不改写(它记的是当时的判断),以「执行记录」段做对账: Task 0/1/2 完成与两处被实查数据推翻的偏离、Task 3–8 按用户指令停止、Task 9 取消并反向执行。 最关键的一条要留在文档最显眼处:**V145 单独上线不解决跨公司串扰**, A 公司导入的 ASIN 仍会被 B 公司的去重掉,止血点在消费侧那四个裸 SQL 出口(Task 5–6)。 哪天接着做,从这里接。取号起点同时订正为 V146。 --- .../18-brand-dedupe-company-isolation.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/plans/18-brand-dedupe-company-isolation.md b/docs/plans/18-brand-dedupe-company-isolation.md index d0eddb5c6..0d683ba75 100644 --- a/docs/plans/18-brand-dedupe-company-isolation.md +++ b/docs/plans/18-brand-dedupe-company-isolation.md @@ -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。