From 07757b9f6d5a8d842d9e249e6f46dfc5b38a6eba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Sat, 10 Oct 2026 11:47:21 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AF=B9=E5=B9=B3(=E4=B8=A4=E6=9D=A1=E6=97=A2?= =?UTF-8?q?=E6=9C=89=E5=8F=B0=E8=B4=A6=E7=BA=A2):=20=E8=BF=81=E7=A7=BB?= =?UTF-8?q?=E7=9B=98=E7=82=B9=E6=96=87=E6=A1=A3=E8=A1=A5=20V156=20?= =?UTF-8?q?=E4=B8=80=E8=B7=B3=E3=80=81=E9=A1=B5=E7=A0=81=E5=8F=B0=E8=B4=A6?= =?UTF-8?q?=E6=8C=89=E6=8B=BC=E5=86=99=E5=88=86=E5=BC=80=E7=99=BB=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 出包前实测 master 头全量红在这两条上(都不是本批引入,已在干净 HEAD worktree 复跑坐实): 1. docs/migration-inventory.md:磁盘 154 支版本化迁移、整数版本到 V156,文档还停在 153 / V1..V155,"最新版本"一行也没写 V156 的文件名 ⇒ CompanyMigrationV143Test 的三条对账(文件数/范围/含最新文件名)红。取号起点 V157 本来就对,没动。 旧版文件名一个没挤掉(V155/V154/V153/V152 仍在链条里,CompanyDefaultDropV152Test 钉着)。 2. PageDefaultsLedgerTest:同一个断言同时套在 #page_size= 与 #pageSize= 两种拼写上, 而 camelCase 那族实际只用得到 2 种常量(另外 2 种只以 snake_case 出现)⇒ 恒红, 红的是写法不是有人新增了默认值。改成逐拼写登记 + 两拼写并集仍只许四种, "长出第五种要红"这条保护不降。 用户拍板"对平两条账后整批发",故本笔与外观那两笔同树出包。 --- backend-java/docs/migration-inventory.md | 6 ++--- .../common/api/PageDefaultsLedgerTest.java | 23 ++++++++++++++----- 2 files changed, 20 insertions(+), 9 deletions(-) diff --git a/backend-java/docs/migration-inventory.md b/backend-java/docs/migration-inventory.md index a7c719ef4..e22916ad2 100644 --- a/backend-java/docs/migration-inventory.md +++ b/backend-java/docs/migration-inventory.md @@ -5,10 +5,10 @@ ## 概览 -- 版本化迁移文件数:**153**(`src/main/resources/db/V*.sql`,其中整数版本 152 个 + 小版本 V25_1) -- 整数版本范围:**V1..V155**,其中 V132/V133/V148 为已退役空号(见下),其余连续 +- 版本化迁移文件数:**154**(`src/main/resources/db/V*.sql`,其中整数版本 153 个 + 小版本 V25_1) +- 整数版本范围:**V1..V156**,其中 V132/V133/V148 为已退役空号(见下),其余连续 - 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留) -- 最新版本:**V155__users_disabled_at.sql**(上一版 **V154__biz_dedupe_total_data_company_id_drop_default.sql**,再上一版 **V153__shop_manage_group_company_id.sql**,其前 **V152__columns_shop_key_company_id_drop_default.sql**——概览往下推时旧文件名一个不许挤掉,`CompanyDefaultDropV152Test.inventoryDocTracksV152` 就是钉这件事的) +- 最新版本:**V156__dedupe_total_data_pioneer_backfill.sql**(上一版 **V155__users_disabled_at.sql**,再上一版 **V154__biz_dedupe_total_data_company_id_drop_default.sql**,其前 **V153__shop_manage_group_company_id.sql**,再往前 **V152__columns_shop_key_company_id_drop_default.sql**——概览往下推时旧文件名一个不许挤掉,`CompanyDefaultDropV152Test.inventoryDocTracksV152` 就是钉这件事的) - 待下一次 jar 发版执行:**V154、V155**(V152、V153 已于 10-09 09:50 随 jar `69d2ebb0` 双台同版应用——启动日志实查 "Current version of schema `aiimage`: 153 / Schema `aiimage` is up to date. No migration necessary.";V149/V150/V151 已于 10-06 17:32 应用。V153 给分组表加 `company_id` 并把分组名从"全平台唯一"收窄成"同公司唯一",**写侧代码必须同批**,两个方向单独发都不行——见 V153 头注释第 6 段;V154 只摘一列的默认值,前提逐条取证见下面的 V154 条目;V155 只给 `users` 加一列可空 `disabled_at`,140 行全取 NULL、对旧 jar 零行为差异,但它必须与读这列的代码同版——只发迁移则停用无人执行,只发 jar 则启动期读列即 1054) - 已应用:V142(10-03 18:23)、V143(10-04 10:48)、**V144(10-04 13:22)**、`V145__brand_dedupe_company_scope.sql`(10-05 13:01)、`V146__users_expires_at_admin_expiry.sql`(10-05 13:01)、**`V147__product_category_company_scope.sql`(10-06 11:03)**、`V149__permission_menu_company_tree.sql` / `V150__shop_key_company_scope.sql` / `V151__rule_tables_shared_across_companies.sql`(三条均为 10-06 17:32) - 末段 `flyway_schema_history` 为 2026-10-07 主机A 只读实查(`success` 全 1,最大整数版本 151),不是从 jar 版本推的 diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/api/PageDefaultsLedgerTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/api/PageDefaultsLedgerTest.java index b60139719..ef0217eb9 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/common/api/PageDefaultsLedgerTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/common/api/PageDefaultsLedgerTest.java @@ -121,12 +121,23 @@ class PageDefaultsLedgerTest { assertThat(kindsUsing(actual, "page", "FIRST_PAGE")) .as("页码口径只有一套:全部从 1 起") .isEqualTo(21); - for (String kind : List.of("page_size", "pageSize")) { - assertThat(distinctConstants(actual, kind)) - .as(kind + " 的默认容量集合:15/20/50/1000 四种各自登记,新来第五种要红") - .containsExactlyInAnyOrder("USER_LIST_PAGE_SIZE", "ADMIN_LIST_PAGE_SIZE", - "TASK_LIST_PAGE_SIZE", "FULL_EXPORT_PAGE_SIZE"); - } + assertThat(distinctConstants(actual, "page_size")) + .as("page_size 的默认容量集合:15/20/50/1000 四种各自登记,新来第五种要红") + .containsExactlyInAnyOrder("USER_LIST_PAGE_SIZE", "ADMIN_LIST_PAGE_SIZE", + "TASK_LIST_PAGE_SIZE", "FULL_EXPORT_PAGE_SIZE"); + // 同一个语义有两种拼写(@RequestParam(name = "page_size") 与 camelCase 的 pageSize), + // 而两种拼写实际用到的常量本来就不同。原来把同一个四项清单套在两种拼写上, + // 红的是台账写法而不是有人新增了默认值——2026-10-10 出包前对平这一条。 + assertThat(distinctConstants(actual, "pageSize")) + .as("pageSize 拼写目前只用得到这两种") + .containsExactlyInAnyOrder("ADMIN_LIST_PAGE_SIZE", "USER_LIST_PAGE_SIZE"); + java.util.Set bothSpellings = new java.util.TreeSet<>(); + bothSpellings.addAll(distinctConstants(actual, "page_size")); + bothSpellings.addAll(distinctConstants(actual, "pageSize")); + assertThat(bothSpellings) + .as("两种拼写合起来仍只许那四种容量:谁长出第五种,这里就红") + .containsExactlyInAnyOrderElementsOf(java.util.List.of("USER_LIST_PAGE_SIZE", + "ADMIN_LIST_PAGE_SIZE", "TASK_LIST_PAGE_SIZE", "FULL_EXPORT_PAGE_SIZE")); assertThat(distinctConstants(actual, "limit")) .as("limit 是「本次最多返回几条」,不许和 page_size 混用同一批常量") .containsExactlyInAnyOrder("DEFAULT_RESULT_LIMIT", "ADMIN_SCAN_LIMIT");