feat: 完善后端 API OpenAPI 文档与统一错误响应 schema

document/development/backend_api/interface_inventory.md

@@ -0,0 +1,100 @@
+# Backend API Interface Inventory
+
+- Generated at: `2026-05-11 04:14:05 UTC`
+- API title: `X-Financial`
+- API version: `0.1.0`
+- Total paths: `28`
+
+## Tag Overview
+
+### agent-assets
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/agent-assets` | 查询 Agent 资产列表 |
+| `POST` | `/api/v1/agent-assets` | 创建 Agent 资产 |
+| `GET` | `/api/v1/agent-assets/{asset_id}` | 读取 Agent 资产详情 |
+| `PATCH` | `/api/v1/agent-assets/{asset_id}` | 更新 Agent 资产 |
+| `POST` | `/api/v1/agent-assets/{asset_id}/activate` | 激活资产当前版本 |
+| `POST` | `/api/v1/agent-assets/{asset_id}/reviews` | 创建资产审核记录 |
+| `GET` | `/api/v1/agent-assets/{asset_id}/versions` | 查询资产版本列表 |
+| `POST` | `/api/v1/agent-assets/{asset_id}/versions` | 创建资产版本 |
+
+### agent-runs
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/agent-runs` | 查询 Agent 运行日志 |
+| `GET` | `/api/v1/agent-runs/{run_id}` | 读取单次 Agent 运行详情 |
+
+### audit-logs
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/audit-logs` | 查询审计日志 |
+
+### auth
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `POST` | `/api/v1/auth/login` | 用户登录 |
+
+### bootstrap
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/bootstrap` | 读取初始化状态 |
+| `POST` | `/api/v1/bootstrap` | 写入初始化配置 |
+
+### employees
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/employees` | 查询员工列表 |
+| `POST` | `/api/v1/employees` | 创建员工 |
+| `GET` | `/api/v1/employees/meta` | 读取员工目录元数据 |
+| `GET` | `/api/v1/employees/{employee_id}` | 读取员工详情 |
+| `PATCH` | `/api/v1/employees/{employee_id}` | 更新员工 |
+| `POST` | `/api/v1/employees/{employee_id}/disable` | 停用员工 |
+
+### health
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/health` | 服务健康检查 |
+
+### knowledge
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `POST` | `/api/v1/knowledge/documents` | 上传知识库文档 |
+| `DELETE` | `/api/v1/knowledge/documents/{document_id}` | 删除知识库文档 |
+| `GET` | `/api/v1/knowledge/documents/{document_id}` | 读取知识库文档详情 |
+| `GET` | `/api/v1/knowledge/documents/{document_id}/content` | 下载或预览知识库原文 |
+| `GET` | `/api/v1/knowledge/documents/{document_id}/onlyoffice-config` | 读取 ONLYOFFICE 预览配置 |
+| `POST` | `/api/v1/knowledge/documents/{document_id}/onlyoffice/callback` | 接收 ONLYOFFICE 回调 |
+| `GET` | `/api/v1/knowledge/documents/{document_id}/onlyoffice/content` | 读取 ONLYOFFICE 文档源文件 |
+| `GET` | `/api/v1/knowledge/library` | 查询知识库目录 |
+
+### reimbursements
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/reimbursements` | 查询报销申请列表 |
+| `POST` | `/api/v1/reimbursements` | 创建报销申请 |
+| `GET` | `/api/v1/reimbursements/{request_id}` | 读取报销申请详情 |
+
+### root
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/` | 服务根检查 |
+
+### settings
+
+| Method | Path | Summary |
+| --- | --- | --- |
+| `GET` | `/api/v1/settings` | 读取系统设置 |
+| `PUT` | `/api/v1/settings` | 保存系统设置 |
+| `POST` | `/api/v1/settings/model-connectivity` | 测试模型连通性 |
+| `GET` | `/api/v1/settings/runtime-models/{slot}` | 读取 Hermes 运行时模型配置 |