Преглед на файлове

docs(readme): 统一分页契约对齐后端嵌套 PageData

- §3.2 信封去 total? 字段 → {code, data, message, success}
- 分页统一读 res.data.{list,total,page,pageSize,pages},useListPage<T> 收口
Q преди 4 дни
родител
ревизия
8e8d3d5fb9
променени са 1 файла, в които са добавени 2 реда и са изтрити 2 реда
  1. 2 2
      README.md

+ 2 - 2
README.md

@@ -69,9 +69,9 @@
 
 ### 3.2 接口与响应契约
 
-- 统一「**HTTP 恒 200 + body `code`**」信封 `{code, data, message, total?, success}`;判成功读 `code === 200`,错误文案读 `message`,**不靠**拦截器 reject、**不靠** HTTP status(源自教务 Go 重构在产验证)。
+- 统一「**HTTP 恒 200 + body `code`**」信封 `{code, data, message, success}`;判成功读 `code === 200`,错误文案读 `message`,**不靠**拦截器 reject、**不靠** HTTP status(源自教务 Go 重构在产验证)。
 - 错误码分段(与后端一致):`1xxx` 认证/权限 · `2xxx` 参数 · `3xxx` 数据 · `4xxx` 依赖 · `5xxx` 系统;`1001/1002` 统一跳登录(refresh 失败才跳,access 过期先静默 refresh)。
-- 分页:请求 `page`/`pageSize`(上限 200);列表读**顶层** `total`。
+- **统一分页**:请求 `page`/`pageSize`(默认 1/10,上限 200);响应 `data` 恒为 `PageData` 对象 `{list, total, page, pageSize, pages}`,前端统一读 `res.data.list` / `res.data.total`(`useListPage<T>` 收口,不再区分分页/非分页两套读法)。
 - 命名:入参/出参 `camelCase`;组件 `PascalCase`;组合式函数 `useXxx`。
 
 ### 3.3 路由与鉴权