38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# 前端接口接入说明（`tyt-admin`）
|
||
|
||
## 1. 本次接入范围
|
||
|
||
- 登录页：`/auth/login`，支持可选 `hospitalId`。
|
||
- 首页看板：按角色拉取组织与患者统计。
|
||
- 任务页：接入 `publish/accept/complete/cancel` 四个真实任务接口。
|
||
- 用户页：修复用户列表响应结构、组织字段联动、工程师分配医院参数。
|
||
- 患者页：接入真实患者字段与生命周期查询参数（`phone + idCardHash`）。
|
||
|
||
## 2. 接口契约对齐点
|
||
|
||
- `GET /users` 当前返回数组，前端已在 `api/users.js` 做本地分页与筛选适配。
|
||
- `PATCH /b/users/:id/assign-engineer-hospital` 参数为单个 `hospitalId`，非数组。
|
||
- `GET /b/patients` 返回数组，前端已改为本地分页与筛选。
|
||
- `GET /c/patients/lifecycle` 必须同时传 `phone` 和 `idCardHash`。
|
||
- 任务模块暂无任务列表接口，前端改为“表单操作 + 最近结果”模式。
|
||
|
||
## 3. 角色权限提示
|
||
|
||
- 任务接口权限：
|
||
- `DOCTOR`：发布、取消
|
||
- `ENGINEER`：接收、完成
|
||
- 患者列表权限：
|
||
- `SYSTEM_ADMIN` 查询时必须传 `hospitalId`
|
||
- 用户管理接口：
|
||
- `SYSTEM_ADMIN/HOSPITAL_ADMIN` 可访问列表与创建
|
||
- 删除和工程师绑定医院仅 `SYSTEM_ADMIN`
|
||
|
||
## 4. 本地运行
|
||
|
||
在 `tyt-admin` 目录执行：
|
||
|
||
```bash
|
||
pnpm install
|
||
pnpm dev
|
||
```
|