feat(scrap): 报废全链路收口到审批流
系统自陈的规则是「报废一律需审批」（SCRAP_ALWAYS_REQUIRES_APPROVAL = True），
但实际有 4 条写 TransScrap 的路径，其中 3 条绕过审批。本提交把三条旁路
全部收口，只保留「申请 → 审批 → 执行」一条写入路径。
【删除】直接报废 POST /api/v1/scrap
同时移除 ScrapService.process_scrap()。该路径的一个连带影响是
「维修件报废」能力随之消失 —— process_scrap 的 trans_repair 分支是
repair_status='报废转出' 的唯一写入点。实测该能力零使用（报废转出 0 条、
trans_scrap 来源 0 条），且早已半死：审批流的扫码校验会拒绝 trans_*
来源。repair_service.py 的误导文案（原文指引操作员「前往报废管理进行
扫码操作」，而那条路根本不通）已改为「维修件报废暂未开放」。
权限元素 scrap_create:operation 保留不删 —— add_scrap_perm.sql 以它为
scrap_apply/scrap_execute 的授权来源。
【改造】借库转报废 POST /borrow/scrap → POST /borrow/scrap-request
TransService.scrap_borrow() 删除，逻辑迁入 BorrowScrapAdapter。
沿用 op_return:operation 权限（零授权变更）。已归还/已报废的记录改为
**直接报错**，不再静默 continue 返回 count=0（原缺陷：用户以为成功）。
【改造】不良品报废 POST /defective/<id>/scrap → POST /defective/<id>/scrap-request
申请时**不预占** remaining_qty（与报废模块「仅锁定意向，不扣库存」的
既有哲学一致）。副作用：同一批坏件可重复提交多张申请单，执行期由适配器
按 Fail-Closed 拒绝超额的那几张。已在该接口注释与前端提示中写明。
【服务层】ScrapApprovalService 接入来源适配层
- submit_approval 改由 get_adapter() 分派，并新增整单 scrap_mode 一致性
校验（混合「需扫码/免扫码」两类来源直接拒绝，让 execute 分流保持简单）
- _build_scanned_index 的来源校验改为 is_scan_source()：语义上是**收窄**
而非放宽，扫码通道永远不接纳 trans_* 来源
- execute 按模式分流：scan 项走原有扫码匹配（索引只由 scan 项构建），
auto 项按批准量执行。签名与调用契约不变。
- _match_key 加入来源表：不良品 SKU 是从原库存行复制的，不带来源时
同一张单里的两者会**必然串键**，扫码量算到错误对象上。纯库存单两侧
同源、键仍匹配，对既有流程零行为变更。
【修复】approve() 的 fail-open
原实现 `if user_entries and str(operator_id) not in user_entries` ——
allowed_approvers 为空时条件短路为假，**任何登录用户都能审批**。
这与「报废一律需审批」直接矛盾，留这扇门等于没有审批。改为无名单即拒绝。
已实测存量「无审批人」的在途单为 0 张，不会卡死历史数据。
【扫码通道】scrap/scan 的 trans_repair 分支改为 trans_defective_goods
在管不良品按 SKU 匹配，在管量回填到既有字段形状，前端无需按来源分支。
【清理】scrap_approval_service 的 _stock_models 与 TransScrap 导入已移除
（来源差异全部收敛到适配层）；trans_service / inventory_reservation 中
指向已删方法的注释已更新指向 BorrowScrapAdapter。
This commit is contained in:
yueli
@ -111,31 +111,104 @@ def submit_return():
|
||||
return jsonify({'code': 400, 'msg': str(e)}), 400
|
||||
|
||||
|
||||
# --- 借库报废（未归还直接报废，关联报废单流程）---
|
||||
@trans_bp.route('/borrow/scrap', methods=['POST'])
|
||||
# --- 借库报废申请（未归还 → 提交报废申请，需审批）---
|
||||
@trans_bp.route('/borrow/scrap-request', methods=['POST'])
|
||||
@jwt_required()
|
||||
@permission_required('op_return:operation') # 复用归还权限：能归还的库管即可报废
|
||||
def scrap_borrow():
|
||||
@permission_required('op_return:operation') # 复用归还权限：能归还的库管即可申请报废
|
||||
# ★ 幂等锁置于 permission_required 内层：prevent_double_submit 依赖
|
||||
# get_jwt_identity()，放外层会因 JWT 未验证而抛错、被自身 except 捕获后降级放行
|
||||
@prevent_double_submit(lock_timeout=5)
|
||||
def submit_borrow_scrap_request():
|
||||
"""
|
||||
借库未归还直接报废（库管/主管操作）
|
||||
请求体: { "record_ids": [1, 2, 3], "reason": "物品丢失" }
|
||||
提交「借出未归还」的**报废申请**（需审批人审批，通过后由库管执行报废）。
|
||||
|
||||
请求体:
|
||||
{
|
||||
"record_ids": [1, 2, 3], # 必填，trans_borrow.id 列表（按整条待还量报废）
|
||||
"reason": "物品丢失", # 可选，写入申请单备注
|
||||
"approver_id": 7 # 必填，指定审批人
|
||||
}
|
||||
|
||||
★ 为什么改走审批：
|
||||
原先 POST /borrow/scrap 直接写 trans_scrap 并扣总库存，绕过审批，与系统
|
||||
自陈的「报废一律需审批」冲突，构成职责分离漏洞 —— 同一个库管可自行宣告
|
||||
实物损失而无人复核。现统一走：申请 → 审批 → 执行。
|
||||
|
||||
★ 执行方式：本来源为「免扫码」—— 东西在借用人手上，物理上不可能扫码；
|
||||
且执行只改台账与总库存，不产生任何可被挪用的可用库存。
|
||||
"""
|
||||
data = request.get_json() or {}
|
||||
record_ids = data.get('record_ids', [])
|
||||
reason = data.get('reason', '')
|
||||
record_ids = data.get('record_ids') or []
|
||||
reason = (data.get('reason') or '').strip()
|
||||
approver_id = data.get('approver_id')
|
||||
|
||||
if not record_ids:
|
||||
return jsonify({'code': 400, 'msg': '请选择要报废的借出记录'}), 400
|
||||
return jsonify({'code': 400, 'msg': '请选择要申请报废的借出记录'}), 400
|
||||
if not approver_id:
|
||||
return jsonify({'code': 400, 'msg': '请选择审批人'}), 400
|
||||
|
||||
operator_name = _current_username() or 'Unknown'
|
||||
try:
|
||||
result = TransService.scrap_borrow(record_ids, operator_name=operator_name, reason=reason)
|
||||
return jsonify({'code': 200, 'msg': f'已报废 {result["count"]} 条借出记录', 'data': result})
|
||||
from app.models.transaction import TransBorrow
|
||||
|
||||
# 逐条载入并校验。
|
||||
# ★ 已归还/已报废的**直接报错**，不静默跳过 —— 旧实现是 `continue`
|
||||
# 然后返回 count=0，用户以为成功实则什么都没发生（缺陷）。
|
||||
items = []
|
||||
missing = []
|
||||
for rid in record_ids:
|
||||
try:
|
||||
rid = int(rid)
|
||||
except (TypeError, ValueError):
|
||||
raise ValueError(f'借出记录 ID 无效：{rid}')
|
||||
record = TransBorrow.query.get(rid)
|
||||
if not record:
|
||||
missing.append(str(rid))
|
||||
continue
|
||||
if record.is_returned:
|
||||
raise ValueError(
|
||||
f"借用记录【{record.borrow_no or rid}】已归还或已报废，不可再申请报废"
|
||||
)
|
||||
pending = (float(record.quantity or 0)
|
||||
- float(record.returned_quantity or 0))
|
||||
if pending <= 0:
|
||||
raise ValueError(
|
||||
f"借用记录【{record.borrow_no or rid}】无待还数量，无需报废"
|
||||
)
|
||||
items.append({
|
||||
'source_table': 'trans_borrow',
|
||||
'stock_id': record.id,
|
||||
'scrap_qty': pending,
|
||||
})
|
||||
|
||||
if missing:
|
||||
raise ValueError(f'以下借出记录不存在：{"、".join(missing)}')
|
||||
if not items:
|
||||
raise ValueError('所选借出记录均无待还数量，无需报废')
|
||||
|
||||
from app.services.scrap_approval_service import ScrapApprovalService
|
||||
|
||||
req = ScrapApprovalService.submit_approval(
|
||||
applicant_id=get_jwt_identity(),
|
||||
items=items,
|
||||
remark=reason or None,
|
||||
approver_id=approver_id,
|
||||
)
|
||||
|
||||
return jsonify({
|
||||
'code': 200,
|
||||
'msg': f'报废申请已提交（{len(items)} 条明细），待审批人审批',
|
||||
'data': {
|
||||
'request_id': req.id,
|
||||
'request_no': req.request_no,
|
||||
'count': len(items),
|
||||
},
|
||||
}), 200
|
||||
|
||||
except ValueError as e:
|
||||
return jsonify({'code': 400, 'msg': str(e)}), 400
|
||||
except Exception as e:
|
||||
traceback.print_exc()
|
||||
return jsonify({'code': 500, 'msg': f'报废失败: {str(e)}'}), 500
|
||||
return jsonify({'code': 500, 'msg': f'提交报废申请失败: {str(e)}'}), 500
|
||||
|
||||
|
||||
# --- 记录列表 ---
|
||||
|
||||
Reference in New Issue
Block a user