diff --git a/backend-java/src/main/java/com/nanri/aiimage/common/api/PageDefaults.java b/backend-java/src/main/java/com/nanri/aiimage/common/api/PageDefaults.java index 650a4b992..19b1bbd4a 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/common/api/PageDefaults.java +++ b/backend-java/src/main/java/com/nanri/aiimage/common/api/PageDefaults.java @@ -5,7 +5,7 @@ package com.nanri.aiimage.common.api; * {@code defaultValue} 里 15/20/50/1000 四种并存,31 处魔法数)。 * *

这里没有"全局统一默认页容量"这一说,而且是故意的。 - * 实测 49 处数字型 {@code defaultValue}(21 处页码 + 28 处条数)分属不同的真实用途: + * 实测 53 处数字型 {@code defaultValue}(23 处页码 + 30 处条数)分属不同的真实用途: * 用户端列表、超管台、任务历史、扫描上限、导出取全量——把它们拍成一个值是改行为, * 不是清理。本类只做一件事:让每个数字有一个说明它为什么是这个数的名字, * 并让"同一个用途冒出第二个默认值"变成判据红({@code PageDefaultsLedgerTest})。 @@ -21,9 +21,9 @@ public final class PageDefaults { private PageDefaults() { } - // ---- 页码:21 处全是 1,这一族本来就是单一口径 ---- + // ---- 页码:23 处全是 1,这一族本来就是单一口径 ---- - /** 起始页码。全树 21 处分页入口一致取 1(不是 0);改这个数等于把所有列表第一页翻空。 */ + /** 起始页码。全树 23 处分页入口一致取 1(不是 0);改这个数等于把所有列表第一页翻空。 */ public static final String FIRST_PAGE = "1"; /** {@link #FIRST_PAGE} 的数字镜像。 */ 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 ef0217eb9..03468aa79 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 @@ -18,7 +18,7 @@ import org.junit.jupiter.api.Test; * 分页/条数默认值的逐点台账 + 棘轮(2026-10-09 评审「可读 5.0 / 交互 5.5」项 5)。 * *

评审量到的是"15/20/50/1000 四种并存、31 处 {@code defaultValue}"。本轮实测更细: - * 数字型 {@code defaultValue} 共 49 处,其中 48 处是分页/条数口径(21 处页码 + 27 处容量与上限), + * 数字型 {@code defaultValue} 共 53 处,其中 52 处是分页/条数口径(23 处页码 + 29 处容量与上限), * 另有 1 处是 {@code timeout_minutes=30},不是分页。 * *

这里不规定"全局统一默认页容量"——把 15/20/50/1000 拍成一个数是改行为。判据只做两件事: @@ -39,7 +39,7 @@ class PageDefaultsLedgerTest { /** * 出站点台账:{@code 文件#参数 -> 该页当前默认值的具名出处}。 - * 48 条,逐条对应一次真实翻页行为;加页要登记,改值要表态。 + * 52 条,逐条对应一次真实翻页行为;加页要登记,改值要表态。 */ private static final List LEDGER = List.of( "AdminUserController.java#page=FIRST_PAGE", @@ -54,6 +54,9 @@ class PageDefaultsLedgerTest { "AdminImageVideoTaskController.java#page_size=ADMIN_LIST_PAGE_SIZE", "AdminNotificationController.java#page=FIRST_PAGE", "AdminNotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE", +// (本批 /groups 端点:参数名与默认值和列表端点同,台账按出站点计数、不去重) + "AdminNotificationController.java#page=FIRST_PAGE", + "AdminNotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE", "AppearancePatentController.java#limit=DEFAULT_RESULT_LIMIT", "CollectDataController.java#page=FIRST_PAGE", "CollectDataController.java#page_size=TASK_LIST_PAGE_SIZE", @@ -66,6 +69,9 @@ class PageDefaultsLedgerTest { "InvalidAsinDataController.java#page_size=USER_LIST_PAGE_SIZE", "NotificationController.java#page=FIRST_PAGE", "NotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE", +// (本批 /groups 端点:参数名与默认值和列表端点同,台账按出站点计数、不去重) + "NotificationController.java#page=FIRST_PAGE", + "NotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE", "PriceTrackController.java#page=FIRST_PAGE", "PriceTrackController.java#page_size=FULL_EXPORT_PAGE_SIZE", "ProductCategoryController.java#page=FIRST_PAGE", @@ -101,10 +107,10 @@ class PageDefaultsLedgerTest { List constants = actual.stream().filter(s -> !s.contains("LITERAL")).sorted().toList(); assertThat(constants) - .as("48 处分页/条数出站点的具名默认值必须与台账一一对应") + .as("52 处分页/条数出站点的具名默认值必须与台账一一对应") .isEqualTo(LEDGER.stream().sorted().toList()); // 同口径非零对照:台账不是空的,扫描器也确实数得出 48 处 - assertThat(constants).hasSize(48); + assertThat(constants).hasSize(52); } @Test @@ -120,7 +126,7 @@ class PageDefaultsLedgerTest { List actual = sites(); assertThat(kindsUsing(actual, "page", "FIRST_PAGE")) .as("页码口径只有一套:全部从 1 起") - .isEqualTo(21); + .isEqualTo(23); assertThat(distinctConstants(actual, "page_size")) .as("page_size 的默认容量集合:15/20/50/1000 四种各自登记,新来第五种要红") .containsExactlyInAnyOrder("USER_LIST_PAGE_SIZE", "ADMIN_LIST_PAGE_SIZE",