浏览代码

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

- §3.2 信封去 total? 字段 → {code, data, message, success}
- 三端统一读 res.data.{list,total,page,pageSize,pages},useListPage<T> 收口
Q 4 天之前
父节点
当前提交
ac88667150
共有 1 个文件被更改,包括 2 次插入 和 1 次删除
  1. 2 1
      README.md

+ 2 - 1
README.md

@@ -76,8 +76,9 @@
 
 ### 3.2 接口与响应契约
 
-- 统一「**HTTP 恒 200 + body `code`**」信封 `{code, data, message, total?, success}`;判成功读 `code === 200`,错误文案读 `message`,不靠拦截器 reject、不靠 HTTP status。
+- 统一「**HTTP 恒 200 + body `code`**」信封 `{code, data, message, success}`;判成功读 `code === 200`,错误文案读 `message`,不靠拦截器 reject、不靠 HTTP status。
 - 错误码分段(与后端/PC 端一致):`1xxx` 认证/权限 · `2xxx` 参数 · `3xxx` 数据 · `4xxx` 依赖 · `5xxx` 系统;`1001/1002` 走 identity 统一刷新/重登流程(并发只刷一次)。
+- **统一分页**:请求 `page`/`pageSize`(默认 1/10,上限 200);响应 `data` 恒为 `PageData` 对象 `{list, total, page, pageSize, pages}`,三端统一读 `res.data.list` / `res.data.total`(`useListPage<T>` 收口,不再区分分页/非分页两套读法)。
 - AI 类异步结果(批改/分析):**派发成功 ≠ 完成**,轮询任务终态或业务表,前端展示"处理中"态而非静默。
 - 命名:入参/出参 `camelCase`;组件 `PascalCase`;组合式函数 `useXxx`。