From a11b55713f99a5640cb221ca611aae61b16d3195 Mon Sep 17 00:00:00 2001
From: zichun <zhuzichunhogan@gmail.com>
Date: Fri, 15 May 2026 10:02:35 +0800
Subject: [PATCH] feat(usr): ErrorCode 新增 40003 + PageResult 通用类 REQ-USR-004

---
 backend/src/main/java/com/xly/erp/common/response/ErrorCode.java     |  1 +
 backend/src/main/java/com/xly/erp/common/response/PageResult.java    | 18 ++++++++++++++++++
 backend/src/test/java/com/xly/erp/common/response/ErrorCodeTest.java |  6 ++++++
 3 files changed, 25 insertions(+), 0 deletions(-)
 create mode 100644 backend/src/main/java/com/xly/erp/common/response/PageResult.java

diff --git a/backend/src/main/java/com/xly/erp/common/response/ErrorCode.java b/backend/src/main/java/com/xly/erp/common/response/ErrorCode.java
index d27de50..c344f44 100644
--- a/backend/src/main/java/com/xly/erp/common/response/ErrorCode.java
+++ b/backend/src/main/java/com/xly/erp/common/response/ErrorCode.java
@@ -11,6 +11,7 @@ public final class ErrorCode {
     public static final int OK                  = 200;
 
     public static final int BAD_REQUEST         = 40001;
+    public static final int INVALID_ENUM_PARAM  = 40003;
     public static final int COMPANY_NOT_FOUND   = 40004;
 
     public static final int BAD_CREDENTIALS     = 40101;
diff --git a/backend/src/main/java/com/xly/erp/common/response/PageResult.java b/backend/src/main/java/com/xly/erp/common/response/PageResult.java
new file mode 100644
index 0000000..075bb98
--- /dev/null
+++ b/backend/src/main/java/com/xly/erp/common/response/PageResult.java
@@ -0,0 +1,18 @@
+package com.xly.erp.common.response;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 通用分页响应包装。docs/04 § 3.2。
+ */
+@Data
+@Builder
+public class PageResult<T> {
+    private List<T> records;
+    private long total;
+    private int page;
+    private int size;
+}
diff --git a/backend/src/test/java/com/xly/erp/common/response/ErrorCodeTest.java b/backend/src/test/java/com/xly/erp/common/response/ErrorCodeTest.java
index 5165a3e..d83b32e 100644
--- a/backend/src/test/java/com/xly/erp/common/response/ErrorCodeTest.java
+++ b/backend/src/test/java/com/xly/erp/common/response/ErrorCodeTest.java
@@ -17,6 +17,12 @@ class ErrorCodeTest {
     }
 
     @Test
+    void httpMappings_coverNewCodes_v004() {
+        assertEquals(400, ErrorCode.toHttpStatus(ErrorCode.INVALID_ENUM_PARAM));
+        assertEquals(40003, ErrorCode.INVALID_ENUM_PARAM);
+    }
+
+    @Test
     void httpMappings_coverNewCodes_v003() {
         assertEquals(403, ErrorCode.toHttpStatus(ErrorCode.USER_FORBIDDEN_SELF_DEACTIVATE));
         assertEquals(404, ErrorCode.toHttpStatus(ErrorCode.USER_NOT_FOUND));
--
libgit2 0.22.2