FastAPI 后端 API 索引

P0 Skeleton:当前读取 JSON 样本,后续接 PostgreSQL、权限中间件、审计日志。

当前状态

Smoke overall ok: True

Endpoint test count: 9

Mode: JSON Demo

启动方式

cd /root/.openclaw/workspace/talent-review-system
bash scripts/run_backend_dev.sh

Docs: http://127.0.0.1:18080/docs

API 清单

MethodPath说明
GET/health健康检查
GET/api/me?user_id=E100当前用户身份 Demo
GET/api/import-plan数据库导入计划
GET/api/employees?current_user_id=E100员工列表 API
GET/api/employees/{employee_id}员工详情 API
GET/api/permissions/rules-summary权限规则摘要
POST/api/permissions/check-page页面权限检查
POST/api/permissions/check-field字段级权限检查
POST/api/permissions/check-data-scope数据范围权限检查
API 化人才洞察前端
新增 API 化洞察验证页,直接调用 FastAPI 后端接口,不再依赖静态 JSON / localStorage / 页面内 mock 数据。用于验证算法输出、九宫格、标签、风险、组织洞察和员工报告的 API 化链路。
覆盖 API
9
数据来源
FastAPI
权限
后端控制
状态
已验证
员工算法报告 / 干部档案页面
新增员工算法报告前端页面,读取 /api/algorithm/report/{employee_id},聚合员工基础信息、测评画像、算法输入、算法输出、九宫格、人才标签、风险标签、字段脱敏结果和审计摘要。
报告 API
DB-backed
权限
字段脱敏
审计
可追溯
状态
已验证
正式 API 化洞察页面
新增 4 个正式 API 化洞察页面,替代旧静态 JSON / localStorage 页面主方向:算法输出、九宫格、标签风险、组织洞察均直接读取 FastAPI 后端。
算法输出页
API
九宫格页
API
标签风险页
API
组织洞察页
API
登录与会话 / Auth Session
新增前端登录态接入页,支持 /api/auth/me、/api/auth/demo-login、/api/auth/logout、/api/navigation/menu 验证。Demo 阶段使用 X-Demo-User-Id,后续切换真实飞书登录与 hrms_session。
高管人才驾驶舱 / Boss One-page Dashboard
新增高管汇报版 Dashboard,读取真实 FastAPI 后端接口,聚合组织人才总览、九宫格结构、关键人才池、风险名单、部门人才密度、风险密度和建议动作分布,面向老板 / 高管一页纸快速阅读。
视图类型
高管一页纸
数据来源
FastAPI
权限
后端控制
状态
已验证
飞书 OAuth 接入准备
新增飞书 OAuth 管理员准备页,用于检查飞书应用配置、回调地址、HRMS Session、Cookie、安全策略和 Demo Login 关闭条件。
Identity Binding 管理员审核
新增身份绑定管理员审核页,用于查看 pending 飞书身份绑定申请,并支持 approve / reject。
真实飞书联调 Readiness
新增真实飞书联调红绿灯页面,用于检查配置、OAuth state、callback、identity binding 和安全开关状态。