a0929de768
- 配置 pnpm workspace monorepo 基础结构 - 初始化 .blueprint/ 蓝图：6 个业务模块、21 张任务卡 - 目标：Z Fold 6 折叠屏不动产物品摸底统计 App（React Native + Expo） Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
31 lines
1.0 KiB
Markdown
31 lines
1.0 KiB
Markdown
---
|
||
id: api-client
|
||
name: API 客户端层
|
||
area: frontend
|
||
status: concept
|
||
---
|
||
|
||
## 概述
|
||
|
||
封装后端 API 调用，包含统一鉴权、错误处理和接口类型定义。以 packages/api 形式跨 app 共享，或在各 app 内独立维护。
|
||
|
||
## 任务卡
|
||
|
||
### 💭 HTTP 客户端实例配置
|
||
- status: concept
|
||
- complexity: M
|
||
- files: packages/utils/src/request.ts, apps/app-one/src/api/client.ts
|
||
- acceptance: 配置 baseURL、超时时间，请求拦截器自动附加 Authorization header，响应拦截器统一处理 401/403/500 错误码
|
||
|
||
### 💭 API 接口类型化封装
|
||
- status: concept
|
||
- complexity: M
|
||
- files: apps/app-one/src/api/types.ts, apps/app-one/src/api/auth.ts
|
||
- acceptance: 每个 API 模块导出类型安全的请求函数（入参和返回值均有 TS 类型），不使用 any
|
||
|
||
### 💭 数据请求缓存与 SWR 集成
|
||
- status: concept
|
||
- complexity: M
|
||
- files: apps/app-one/src/api/hooks/useAuthQuery.ts
|
||
- acceptance: 基于 SWR 或 React Query 封装常用接口 hook，支持缓存、重试、乐观更新，避免重复请求
|