KCGL/inventory-backend at b53e22f53685b1fadf419170d3165bf166c10664 - KCGL

Files

yueli 1c58789fd9 feat(borrow): 新增「待我接收」转交数量接口

GET /api/v1/transactions/borrow/transfer/pending-count -> { count: X }

用途：双向握手引入后，发起方提交了转交，接收人若不来借还记录页主动查看就
完全处于盲区 —— 物品挂着「待接收」，责任悬空。该接口供前端做全局强提醒。

设计
----
· 刻意做成极轻量：一次 count，不联表、不解析物料名。轮询接口必须便宜，
  否则会从「提醒」变成「后台噪音」。
· 无 permission_required：接收人可能是普通员工，待办提醒必须人人可见
  （与 accept/reject 同级 —— 员工处置自己名下资产，非库管职权）。
· user_id 为 None / 非法时返回 0 而不是抛错：提醒类接口不该因边界输入 500。

路由无冲突
----
「transfer」匹配不了 <int:borrow_id>，「pending-count」也匹配不了
<int:transfer_id>，Werkzeug 按转换器精确分派。实测：
  GET /borrow/transfer/pending-count -> 401（已注册且受 JWT 保护）
  GET /borrow/11/transfer            -> 405（路径命中但方法不符，证无冲突）

验证（9 项断言全通过）
----
发起后接收人计数 +1、非接收人不变；拒绝/接收后均回落；
None 与非法 user_id 返回 0 不报错；库存零副作用、数据零残留。

2026-09-17 10:30:07 +08:00