tyt-api-nest/docs/frontend-api-integration.md
2026-03-13 06:10:32 +08:00

1.3 KiB
Raw Blame History

前端接口接入说明(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 必须同时传 phoneidCardHash
  • 任务模块暂无任务列表接口,前端改为“表单操作 + 最近结果”模式。

3. 角色权限提示

  • 任务接口权限:
    • DOCTOR:发布、取消
    • ENGINEER:接收、完成
  • 患者列表权限:
    • SYSTEM_ADMIN 查询时必须传 hospitalId
  • 用户管理接口:
    • SYSTEM_ADMIN/HOSPITAL_ADMIN 可访问列表与创建
    • 删除和工程师绑定医院仅 SYSTEM_ADMIN

4. 本地运行

tyt-admin 目录执行:

pnpm install
pnpm dev