|
@@ -69,9 +69,9 @@
|
|
|
|
|
|
|
|
### 3.2 接口与响应契约
|
|
### 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)。
|
|
- 错误码分段(与后端一致):`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`。
|
|
- 命名:入参/出参 `camelCase`;组件 `PascalCase`;组合式函数 `useXxx`。
|
|
|
|
|
|
|
|
### 3.3 路由与鉴权
|
|
### 3.3 路由与鉴权
|