Files
crawler-plugin/backend-java/docs/migration-inventory.md
T
huangzd1997 16583f578d feat(公司tab): 批次 2/3/4 再接 8 页,注册表收到 16 页——用户页回流 company_id 按新边界改写反向钉
「切 tab 数据还一样」的根因一直是分母小于现实:批次 1 只登记 8 页,本轮按控制方
三次点名扩到 16 页(company-scope.ts 是唯一清单,routes.ts 的 companyScoped 逐页对平)。

批次 2(五页 ASIN 中心):去重总数据 / 不符合ASIN / 查询ASIN / 最低价ASIN / 商品类目。
批次 3(两页店铺中心):撞款监控、店铺数据记录。这两页没有归属列可筛,归属口径是
「本公司账号名下的店铺」——后端由 DataReadScope 推公司 → 成员账号 → biz_shop_manage.
created_by_id,前端只把 activeId 当 company_id 送下去。空成员集必须交空集合,绝不能
退化成 null(null 在这里=全量,那样第二家会看到全部数据)。
批次 4(用户管理):后端早就认 company_id(只对站点超管生效,公司超管恒锁本公司),
断的是前端——UserListQuery 里连这个字段都没有,三家 tab 看的是同一份全量列表。

三处口径改动,逐条说明:
1)company-user-list.test.ts 的反向钉被改写。2026-10-04 定案把公司维度从用户页整体摘掉,
   那条钉的原文是「列表查询/筛选/行渲染不允许出现公司维度」。控制方 2026-10-05 明确要
   用户管理区分公司 tab,所以钉的边界收窄成两半:渲染层(行级公司列、「所属公司」标签、
   筛选状态、顶栏公司名)仍不得回流;请求层的 company_id 是这次加回来的,尺子换成
   「取值口唯一」——页面每处 companyId 都必须等于 companyTab.requestCompanyId,且
   normalizeUserPageParams/toUserListQuery 两只白名单构造器体内不许出现公司值。
   新增一支行为钉:往归一化里传 companyId 必须被丢掉,这是 users.ts 读原始入参的全部理由
   (写成 normalized.companyId 时 TS 照样绿、运行时恒 undefined)。
2)align-dup-console 那条 watch 看守的 token 扩到含 reload。变异自证里「删掉 void
   loadConsole()」当场全绿:体里的清筛选项守住了,重新取数那半没人守。批次 3/4 三对
   token 一起写到 reload 为止(批次 1/2 的老条目不动)。
3)公司管理页补正/反向两把尺子:company-config-entry-super-only 新增「吃公司 tab 的页面
   集合恰好等于 COMPANY_SCOPED_PAGES 的 pageFiles」——按代码真值比,不按清单比,所以
   清单不改一字而往 CompaniesPage.vue 里塞 store 也会红。谓词带括号,否则 import 行也算消费者。

菜单权限(admin_columns)本轮不动:MenusPage 只消费 /api/admin/permission-menus 这一份全局
菜单字典,切 tab 一样是数据本身全局,不是筛选坏了。真问题在写侧——PermissionMenuService
create/update/delete 只有 ensureAdminOperatorIfPresent(isAdmin 即放行),公司管理员改的是
全平台的菜单行。收窄为仅站点超管 vs 给 permission_menu 加归属列,两种改法代价差一个量级,
留给控制方定档。

护栏:G1 发送口 22 个 / 页面分组 17、watch 体看守 10 对、operation-guide 的 tab 文案 15 页
(撞款监控是显式豁免,另有一条自检盯「豁免落空」)。
变异自证 12/12 全杀(前端 10 + 公司管理反向钉 2),分母钉死在 27 例。
门禁:后端全量 3823 例 / 0 失败 / 0 错误 / 7 skipped,BUILD SUCCESS;admin-frontend-vue
1741 例 / 0 红;vue-tsc rc=0。首轮后端 4 红是另一路 task_partial 改动与本轮编译抢跑,
单跑 13 例已绿,本笔不含他们的任何文件。

未上线:jar 与 admin-vue 都没出包,V147 未在生产执行。
2026-10-06 02:32:59 +08:00

5.2 KiB
Raw Blame History

Flyway 迁移盘点(task-193)

生成方式:src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java(只读审计,可重复)。 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步;2026-10-04 随 V144 同步;2026-10-04 15:1x 随 V145 同步;2026-10-05 随 V146 同步;2026-10-05 23:0x 随 V147 同步。

概览

  • 版本化迁移文件数:146(src/main/resources/db/V*.sql,其中整数版本 145 个 + 小版本 V25_1)
  • 整数版本范围:V1..V147,其中 V132/V133 为已退役空号(见下),其余连续
  • 历史遗留小版本:V25_1__shop_manage_group_bind_user.sql(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
  • 最新版本:V147__product_category_company_scope.sql(上一版 V146__users_expires_at_admin_expiry.sql,再上一版 V145__brand_dedupe_company_scope.sql)
  • 待下一次 jar 发版执行的三条:V145__brand_dedupe_company_scope.sql、V146__users_expires_at_admin_expiry.sql、V147__product_category_company_scope.sql
  • 已应用:V142(10-03 18:23)、V143(10-04 10:48)、V144(10-04 13:22)
  • 重复版本:无
  • 迁移命名:全部符合 V<整数>(_<子版本>)?__<描述>.sql,无空格

生产已执行核对

生产 flyway_schema_history 末段:V125..V131 之后直接是 V134__publish_item_free_text_columns、V135__dedupe_total_data_wide_columns(两条 installed_on 均为 2026-09-25 20:46:16),库内没有 132/133 记录。

V132/V133 空号的来历

本地曾存在 V132__web_config_add_is_latest.sql、V133__hide_redundant_indexes_invisible.sql,与另一分支已在生产落库的 V134/V135 冲突。因 Flyway 未开启 out-of-order,把任何迁移编到 132/133 会在启动期报 "resolved migration not applied";因此这两条改为 V136/V137,132/133 永久退役,不可回填。

后续新增迁移从 V148 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,integerVersionsSequentialFromOne 会红)。V148 的第一件已知待办就是摘掉 biz_product_category.company_id 的 DEFAULT(一条 ALTER … ALTER COLUMN company_id DROP DEFAULT,禁 MODIFY),前提是同批 jar 已双节点上线且写侧都显式落公司。

原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 V139__asin_result_cache.sql 占用,顺延到 V140;V140 已被品牌补测队列表 V140__collectdata_brand_recheck.sql 落用。

已应用迁移的存量校验和(2026-10-04 15:0x 从生产 flyway_schema_history 实查)

版本 文件 校验和 installed_on
142 V142__web_config_sha256.sql 1152261840 2026-10-03 18:23:22
143 V143__company_and_users_company_id.sql 1539570901 2026-10-04 10:48:54
144 V144__users_company_id_drop_default.sql 1833593804 2026-10-04 13:22:00

这三行的字节就此封死。校验和算法是 Flyway 的 CRC32 逐 BufferedReader.readLine() 的 UTF-8 字节累加(行尾不入 CRC,所以 CRLF 工作树与 LF 工作树算出同一个值);上表三个值都被 CompanyMigrationV144Test#appliedMigrationBytesAreFrozenAgainstProdChecksum 用工作树字节复算并比对过。

真事:10-04 上午有人(我)把"摘掉 users.company_id 的 DEFAULT"直接改成原地编辑 V143,取证才发现 V143 已在 10:48 落库——那样发出去的 jar 会让下次启动 Flyway 校验失败、两台 java 都起不来。口径变更因此写成 V144 前向修复,并把"已应用不许原地改"从注释升级成上面那条用例。

约束

  • 审计测试断言:整数版本从 1 到当前最大值连续(RETIRED_HOLES = {132, 133} 内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
  • 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试 + code review 把关(git 层是否改动由 CI/review 校验)。
  • 回滚不得写成版本化迁移。 本目录是 Flyway 扫描路径,任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成 V{N+1}__rollback_*.sql 等于让"决定回滚"这件事在没有人工执行的情况下自己发生。回滚一律是本目录之外的人工补丁脚本(首例:docs/rollback-V143-company.sql),并要按"停应用 → 跑脚本 → 删 flyway_schema_history 对应版本行 → 回滚 jar"的顺序做,漏掉删历史那步会让将来重装时 Flyway 判定"已应用"而跳过重建。
  • 迁移必须可重跑。 MySQL 的 DDL 不进事务:迁移中途失败时前面的语句已经落库,而 flyway repair + 重启会让 Flyway 从第一条语句重跑整个文件。所以建表用 IF NOT EXISTS、插种子行用 INSERT IGNORE 或 WHERE NOT EXISTS、ADD COLUMN/INDEX 先查 information_schema 再 PREPARE(首例:V142 的条件 DDL、V143 全文件)。写成裸 CREATE TABLE / 裸 INSERT ... VALUES 的迁移,恢复路径本身会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库"。