duxingchen/KCGL
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(borrow): 转交改为整单覆盖 + 双向握手，并修复接收人可见性

Browse Source 
一、整单覆盖（修复漏行 / 单内撕裂）
----
transfer_borrow 现在按 borrow_no 定位**整张单**，覆盖全部未还明细；accept 时
整批转移持有权。原先只改传入的那一行，2 明细的单转完会出现两个持有人。

新增 _load_slip_for_update()：按单号锁整单，且按 id 升序取行锁 —— 并发下所有
事务以相同顺序加锁，避免与归还/转交交叉加锁死锁。

二、双向握手
----
· transfer_borrow（发起）：只落一条 PENDING 流水，**不再改主表 current_holder**。
  东西还没到对方手上，责任仍归原持有人 —— 这是与旧实现最本质的区别。
  同一单号已有 PENDING 时拒绝再次发起，避免两个接收人争抢同一批实物。
· accept_transfer：流水置 ACCEPTED，把该单**全部未还明细**的持有人改为接收人。
. reject_transfer：流水置 REJECTED，主表不动。
  两者都强校验「当前登录人 == to_user_id 本人」。

★ accept/reject 刻意**不加 permission_required**：这不是库管职权，而是员工对
  自己名下资产的确认动作，加库管权限会把接收人挡在门外。

三、接收人可见性（OR 过滤）
----
get_records 普通用户过滤原先只比对 borrower_name，接收人在自己的列表里看不到
已经接收的东西。现改为三种关系任一成立：
    ① 我是借用人
    ② 我是**当前持有人**（转交接收后）
    ③ 有一条**待我接收**的 PENDING 转交 —— 东西还在对方手上、主表尚未转移，
       ② 匹配不到，必须单独并入，否则接收人看不到待办、无从确认
ID 与姓名双口径并存，兼容只有姓名没有 ID 的历史行。

列表项附加 pending_transfer（含后端判定的 is_mine）—— 前端 localStorage 里
只有 username 没有 user_id，靠姓名比对既有歧义又不可靠，故由后端标记。

四、验证（合成 2 明细单，25 项断言全通过）
----
· 发起后两条明细持有人均未变（责任未转移）
· 非接收人无法 accept / reject；重复发起被拒
· ★ accept 后**两条明细**持有人一并转移（漏行修复的核心）
· 接收前凭 PENDING 分支可见、接收后凭 current_holder 可见
· reject 后主表持有人不变
· 全程 available_quantity 无变化，库存精确还原、零残留数据
This commit is contained in:
yueli
2026-09-17 10:04:12 +08:00
parent b271ca3a49
commit 1a8e3e3dc0
2 changed files with 323 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
inventory-backend/app/api/v1/transactions.py
View File

@ -246,21 +246,32 @@ def get_records():
from app.utils.advanced_filter import parse_advanced_filters
advanced_filters = parse_advanced_filters(request.args.get('advancedFilters', ''))
# ★ 数据权限：普通用户只看“借用人=本人姓名(不含账号前缀)”的借还记录；管理者看全部
# ★ 数据权限：普通用户只看与自己有关的记录（借用人 / 当前持有人 / 待我接收的
# 转交），管理者看全部。两个口径都要传下去：
# viewer_user_id —— 精确锚点，覆盖转交接收人（此前只按姓名过滤，
# 接收人在自己的列表里看不到东西）
# borrower_name —— 姓名口径，兼容只有姓名、没有 ID 的历史行
borrower_name = None
viewer_user_id = None
current_user_id = None
_identity = get_jwt_identity()
if _identity:
current_user_id = int(_identity) # 供「是否待我接收」判定，与可见性无关
if not is_privileged_viewer():
_identity = get_jwt_identity()
if _identity:
from app.models.system import SysUser
_u = SysUser.query.get(int(_identity))
_uname = _u.username if _u else ''
borrower_name = _uname.split('/')[0].strip() if _uname else None
if _u:
viewer_user_id = _u.id
_uname = _u.username or ''
borrower_name = _uname.split('/')[0].strip() if _uname else None
res = TransService.get_records(
page=page, limit=10, status=status, keyword=keyword,
search_type=search_type, borrower_name=borrower_name,
start_date=start_date, end_date=end_date,
advanced_filters=advanced_filters,
advanced_filters=advanced_filters, viewer_user_id=viewer_user_id,
current_user_id=current_user_id,
)
# ★ service 层异常时：code==500 的字典（带 traceback），需要直通到前端，便于排查
@ -602,7 +613,7 @@ def get_borrow_user_options():
})
# --- 执行借库转交 ---
# --- 发起借库转交（双向握手第一步）---
@trans_bp.route('/borrow/<int:borrow_id>/transfer', methods=['POST'])
@jwt_required()
# ★ 幂等锁置于 permission_required 内层：prevent_double_submit 依赖
@ -611,20 +622,25 @@ def get_borrow_user_options():
@permission_required('borrow_transfer')
def transfer_borrow(borrow_id):
"""
借库转交：把一张借出单的持有权从当前持有人**整单**转给另一人。
发起借库转交：把一张借出单的持有权**整单**转给另一人，等待对方确认。
请求体:
{
"transfer_qty": 10, # 必填，一期必须严格等于待还量
"transfer_qty": 10, # 可选，传入时须等于整单待还量（一致性校验）
"to_user_id": 12, # 必需，接收人ID（唯一身份锚点）
"to_user_name": "张三", # 可选，仅作兼容；落库姓名以 to_user_id 反查为准
"remark": "..." # 可选
}
★ 双向握手：本接口**只落一条 PENDING 流水，不改主表 current_holder**。
东西还没到接收人手上，责任仍归原持有人 —— 接收人在自己的列表里确认
（POST /borrow/transfer/<id>/accept）后才真正转移。
★ 覆盖范围是**整张单**（borrow_no）的全部未还明细，不是传入的这一行，
避免同一张单出现两个持有人。
★ 严禁触碰库存：转交是纯持有权变更，实物不出入库，
stock_buy / stock_semi / stock_product 的任何字段都不会被修改。
★ 一期仅支持整单全量转交：部分转交会被拒绝（详见 service 层说明）。
"""
try:
data = request.get_json() or {}
@ -639,7 +655,7 @@ def transfer_borrow(borrow_id):
return jsonify({
'code': 200,
'msg': '转交成功',
'msg': f'已发起转交，等待【{transfer.to_user_name}】确认接收',
'data': transfer.to_dict(),
}), 200
@ -650,6 +666,65 @@ def transfer_borrow(borrow_id):
return jsonify({'code': 500, 'msg': f'服务器内部错误: {str(e)}'}), 500
# --- 确认接收转交（双向握手第二步）---
@trans_bp.route('/borrow/transfer/<int:transfer_id>/accept', methods=['POST'])
@jwt_required()
@prevent_double_submit(lock_timeout=5)
def accept_borrow_transfer(transfer_id):
"""
接收人确认接收转交 —— 责任正式转移。
★ 权限：**不加 permission_required**。这不是库管职权，而是员工对自己名下
资产的确认动作；service 层强校验当前登录人 == to_user_id 本人。
★ 副作用：该单号下全部未还明细的 current_holder 一并改为接收人。
转交是整单行为，不允许单内出现两个持有人。
"""
try:
transfer, affected = TransService.accept_transfer(
transfer_id=transfer_id,
user_id=get_jwt_identity(),
)
return jsonify({
'code': 200,
'msg': f'已接收，{affected} 项资产的持有权已转移到您名下',
'data': transfer.to_dict(),
}), 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
# --- 拒绝转交 ---
@trans_bp.route('/borrow/transfer/<int:transfer_id>/reject', methods=['POST'])
@jwt_required()
@prevent_double_submit(lock_timeout=5)
def reject_borrow_transfer(transfer_id):
"""
接收人拒绝转交 —— 主表不动，责任仍在原持有人。
权限同 accept：仅 to_user_id 本人。
"""
try:
data = request.get_json() or {}
transfer = TransService.reject_transfer(
transfer_id=transfer_id,
user_id=get_jwt_identity(),
reason=data.get('reason'),
)
return jsonify({
'code': 200,
'msg': '已拒绝该转交',
'data': transfer.to_dict(),
}), 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
# --- 借出单的流转历史（转交链 + 逐次归还）---
@trans_bp.route('/borrow/<int:borrow_id>/history', methods=['GET'])
@jwt_required()