feat(borrow): 拒收须告知发起方(责任回到他手上,不能静默)
背景
----
双向握手补上了「接收人确认」,却只做了单向告知:接收人能看到待办,发起方却
对结果一无所知。**被拒绝时物品责任仍在发起方手上** —— 他若不主动查列表,
就会误以为已经交接出去,责任链出现静默断点。
(ACCEPTED 不需要告知:东西已经交出去了,发起方无需动作。)
改动
----
· trans_borrow_transfer 新增 reject_seen_at(NULL 且 REJECTED = 尚未告知)。
★ 为什么需要持久标记而不是前端去重:换台电脑、换个浏览器就会重新提醒;
而这条信息的分量(责任归属)值得一个持久标记。
★ 存量已拒绝的流水一律标记为已告知:它们产生于本功能上线之前,
追溯提醒只会打扰(实测仅 1 条:#22,验收时的测试数据)。
· get_unseen_rejects(user_id):返回「我发起、被拒、尚未告知我」的转交,
并批量解析物料名 —— 只说「某笔转交被拒」发起方仍不知是哪件东西还在
自己手上,必须让他一眼认出来。
· ack_rejects(user_id, ids):发起方确认后写 reject_seen_at,幂等。
· GET .../transfer/pending-count 的响应并入 rejects:与待接收数量共用同一次
轮询,前端不必多打一个请求。
· POST .../transfer/reject-ack:无 permission_required,同 accept/reject。
顺带补一处同源显示缺口
----
流转时间线里,被拒绝的转交与成功的长得一模一样 —— 发起方翻记录时同样会
误判。现将转交状态一并带出时间线事件。
验证(15 项断言全通过)
----
发起方收到待告知的拒绝(含物料名/接收人/拒绝原因);接收人与无关人看不到;
ack 后不再提醒且幂等;ACCEPTED 不产生告知;None/非法 user_id 均安全返回;
库存零副作用、数据零残留。
This commit is contained in:
@ -164,6 +164,11 @@ class TransBorrowTransfer(db.Model):
|
||||
borrow_no = db.Column(db.String(100), index=True)
|
||||
# ★ 状态机:见文件顶部常量
|
||||
status = db.Column(db.String(20), nullable=False, default=TRANSFER_STATUS_PENDING, index=True)
|
||||
# ★ 发起方看到「被拒绝」提醒并确认的时间。
|
||||
# 被拒绝时物品责任仍在发起方手上 —— 他若不查列表就会误以为已经交接出去,
|
||||
# 责任链出现静默断点。故必须告知,且必须能标记「已告知」,
|
||||
# 否则发起方每次登录都收到同一条提醒,从提醒退化成骚扰。
|
||||
reject_seen_at = db.Column(db.DateTime)
|
||||
|
||||
# 转出方(= 转交前的 current_holder)
|
||||
from_user_id = db.Column(db.Integer)
|
||||
@ -191,6 +196,8 @@ class TransBorrowTransfer(db.Model):
|
||||
TRANSFER_STATUS_ACCEPTED: '已接收',
|
||||
TRANSFER_STATUS_REJECTED: '已拒绝',
|
||||
}.get(self.status, self.status),
|
||||
# 仅供发起方「被拒绝」提醒使用,判断是否需要告知由 reject_seen_at 决定
|
||||
'reject_seen': self.reject_seen_at is not None,
|
||||
'from_user_id': self.from_user_id,
|
||||
'from_user_name': self.from_user_name,
|
||||
'to_user_id': self.to_user_id,
|
||||
|
||||
Reference in New Issue
Block a user