shanxia2.0/docs/bx-migration/01-api-inventory.md

报销系统 API 全量清单（移植后路径保持不变）

源：shanxia/bx/bx-backend/app/routers/ + shanxia/bx/bx-web/src/api/index.ts
挂载：门户 API_V1_PREFIX=/api + router prefix（不含 /api 前缀）

---

费用项目 /api/expense-items

方法	路径	说明
GET	/api/expense-items/tree	费用项目树
GET	/api/expense-items/{item_id}	详情
POST	/api/expense-items/	新增
PUT	/api/expense-items/{item_id}	更新
DELETE	/api/expense-items/{item_id}	软删除

---

工作流 /api/workflows

方法	路径	说明
GET	/api/workflows/	分页列表（page, pageSize）
GET	/api/workflows/biz/{biz_type}	按业务类型（advance / reimburse）
GET	/api/workflows/{workflow_id}	详情（含节点）
POST	/api/workflows/	新增（body 可含 nodes）
PUT	/api/workflows/{workflow_id}	更新
PUT	/api/workflows/{workflow_id}/nodes	保存节点列表
DELETE	/api/workflows/{workflow_id}	软删除

---

备用金 /api/advances

方法	路径	说明
GET	/api/advances/	列表（status, keyword, applicantId, applyDate）
GET	/api/advances/my	我的申请
GET	/api/advances/my/stats	我的统计
GET	/api/advances/stats/status-counts	状态计数
GET	/api/advances/pending-approval	待我审批
GET	/api/advances/pending-approval/stats	待审批统计
GET	/api/advances/approved-by-me	我已审批
GET	/api/advances/{advance_id}	详情
GET	/api/advances/{advance_id}/approvals	审批记录
POST	/api/advances/	新增
PUT	/api/advances/{advance_id}	更新
POST	/api/advances/{advance_id}/submit	提交
POST	/api/advances/{advance_id}/approve	审批通过
POST	/api/advances/{advance_id}/reject	审批驳回
DELETE	/api/advances/{advance_id}	软删除

---

报销 /api/reimburses

方法	路径	说明
GET	/api/reimburses/generate-title	自动生成标题
GET	/api/reimburses/	列表
GET	/api/reimburses/my	我的申请
GET	/api/reimburses/my/stats	我的统计
GET	/api/reimburses/stats/status-counts	状态计数
GET	/api/reimburses/pending-approval	待我审批
GET	/api/reimburses/pending-approval/stats	待审批统计
GET	/api/reimburses/approved-by-me	我已审批
GET	/api/reimburses/{reimburse_id}	详情
GET	/api/reimburses/{reimburse_id}/approvals	审批记录
POST	/api/reimburses/	新增（含明细）
PUT	/api/reimburses/{reimburse_id}	更新
POST	/api/reimburses/{reimburse_id}/submit	提交
POST	/api/reimburses/{reimburse_id}/approve	审批通过
POST	/api/reimburses/{reimburse_id}/reject	审批驳回
DELETE	/api/reimburses/{reimburse_id}	软删除

---

支付 / 发放 /api/payments

方法	路径	说明
GET	/api/payments/pending	待支付报销列表
GET	/api/payments/stats	财务统计
GET	/api/payments/processed	已处理列表
POST	/api/payments/{id}/pay	报销发放
POST	/api/payments/{id}/offset	单笔冲抵
POST	/api/payments/{id}/batch-offset	批量冲抵
GET	/api/payments/advance-issues	备用金发放列表
GET	/api/payments/advance-issues/stats	发放统计
GET	/api/payments/advance-issues/export	导出 CSV（StreamingResponse）
POST	/api/payments/advance/{advance_id}/issue	备用金发放
GET	/api/payments/advance/{advance_id}/offset-records	备用金被冲抵记录
GET	/api/payments/{id}/offset-records	报销冲抵记录

---

附件 /api/attachments

方法	路径	说明
POST	/api/attachments/upload	上传（multipart: file, biz_type, biz_id）
GET	/api/attachments/download/{attachment_id}	下载文件流
GET	/api/attachments/preview/{attachment_id}	预览 URL
GET	/api/attachments/list	按 biz_type、biz_id 列表
PUT	/api/attachments/bind-biz	绑定业务单（query: ids, biz_type, biz_id）
DELETE	/api/attachments/{attachment_id}	软删除

---

响应格式（所有 JSON 接口）

{
  "code": 0,
  "msg": "success",
  "data": { }
}

分页 data 结构：

{
  "rows": [],
  "total": 0,
  "page": 1,
  "pageSize": 10
}

---

不移植的 API

前缀	说明
/api/auth/*	门户登录
/api/users/*	sys_user
/api/roles/*	sys_role
/api/menus/*	sys_menu（门户菜单接口）