2 Commits

Author	SHA1	Message	Date
yueli	29fc00a818	fix(my-requests): 修正 withdraw_endpoint 路径前缀导致撤回 404 ... 现象 ---- 在「我的申请单」页面点撤回，前端控制台报： POST /api/api/v1/outbound/request/351/withdraw 404 根因 ---- aggregate 端点在每条记录上回传 withdraw_endpoint，但拼接时多写了 /api： 返回的: /api/v1/outbound/request/351/withdraw axios baseURL: /api 实际请求: /api + /api/v1/... = /api/api/v1/... → 404 后端路由本身是对的（/api/v1/outbound/request/<id>/withdraw 已正确注册）， 问题纯在前端拼接。其它 API 封装的正确写法是只传 baseURL 之后的部分 （如 url: '/v1/outbound/my-requests'），本处是唯一破坏该约定的地方。 修复 ---- 返回 /v1/... 而非 /api/v1/...，并加注释说明约定。 借库项同时从 close 改为 withdraw（配合上一提交的申请人端点）。 验证方式 -------- 按**前端真实的拼接方式**验证（'/api' + endpoint），而非直接调后端路由： [outbound] /v1/outbound/request/381/withdraw → 200 [borrow ] /v1/transactions/borrow/request/44/withdraw → 200 [scrap ] /v1/scrap/request/5/withdraw → 200 教训：上一轮用 test_client 直接调后端路由验证，绕过了 axios 的 baseURL 拼接，所以后端测试全绿、前端一跑就 404。验证「前端能否调通」必须模拟 前端的请求方式。	2026-09-10 15:47:02 +08:00
yueli	b67d577616	feat(my-requests): 跨模块聚合端点，一个页面看全部申请 ... 动机 ---- 出库/借库/报废三个模块各有一套审批流，申请人此前没有统一入口。 新增只读聚合视图，把三类单据合并返回。 为什么单独建蓝图 ---------------- 权限模型不同：审批端点是「管理视角」，本端点是「申请人视角」。 把两者塞进同一端点（if not privileged: applicant_id = me）会让管理逻辑 与用户逻辑混流，一旦 is_privileged_viewer() 判定出错即越权。 本模块从设计上就没有「看别人」的分支 —— applicant_id 硬编码为当前用户。 只读保证 -------- 本模块只做查询，不修改任何数据。撤回等写操作仍由各模块自己的端点承担 （因为三者释放逻辑不同：出库/借库已接入预占，报废尚未接入）。 把风险锁在只读层，即使聚合逻辑有 bug 也不会破坏业务数据。 字段归一化 ---------- 三个模块的 items_json 存在差异，统一在服务端抹平： · 数量字段：报废用 scrap_qty，出库/借库用 quantity → 统一为 quantity · 库位字段：报废用 location → 统一为 warehouse_location 这专门避免「报废行的数量列显示空白」这类不报错的隐性 bug。 健壮性 ------ 单个模块查询失败时记日志并跳过，其余模块照常返回 （例如某张表尚未迁移时，其它两类仍可用）。 响应中附带 withdraw_endpoint 字段，前端据此分发撤回请求， 无需硬编码三个模块的 URL 映射。 实测 ---- 普通员工（INBOUND 角色，无任何审批权限）访问 → 200，18 单 三类单据齐全，type_label 正确 报废明细数量字段归一化成功（quantity=1.0） B 看不到 A 的单 → 0 条 type=scrap 过滤 → 全部为报废	2026-09-10 15:37:05 +08:00