feat: 用户管理页面重构,部门/用户字段统一使用 id,API 层类型私有化

This commit is contained in:
2026-05-15 18:49:00 +08:00
parent 5d8ddd2bd7
commit ff54a2bba5
8 changed files with 425 additions and 105 deletions

View File

@@ -158,9 +158,15 @@ const res = await get<User[]>('/api/users');
// res.code / res.msg / res.data / res.ok / res.time
```
## API 层规范
- **数据结构不导出**`src/api/` 目录下的 interface / type 不得加 `export`,禁止其他模块 import
- **组件自定类型**:页面组件如需使用数据结构,在组件文件内自行定义,不依赖 API 层的类型
- **mock 文件同理**`src/mock/` 下的文件也需自行定义类型,不导入 `src/api/` 中的类型
- API 函数可以内部使用类型,但签名中避免使用导出的复杂类型(可用 `Record<string, unknown>``any` 代替)
## 参考文档
- Rsbuild: https://rsbuild.rs/llms.txt
- Rspack: https://rspack.rs/llms.txt
- antd v6 完整文档(中文): https://ant.design/llms-full-cn.txt
- antd v6 组件单页(中文): https://ant.design/components/{组件名}-cn.md如 button-cn.md
- antd v6 组件导航文档: https://ant.design/llms.txt