Skip to content

feat(rate): 好评后自动向买家发送配置消息 - #332

Merged
zhinianboke merged 1 commit into
zhinianboke:mainfrom
skyzhao1223:feat/thanks-message-after-rate
Sep 19, 2026
Merged

zhinianboke merged 1 commit into
zhinianboke:mainfrom
skyzhao1223:feat/thanks-message-after-rate

Conversation

@skyzhao1223

Copy link
Copy Markdown
Contributor

功能说明(#232)

「希望增加好评后自动发送指定内容给客户」——自动评价给买家好评成功后,自动把卖家配置的致谢/售后消息私聊发给买家(每个订单仅发送一次)。

配置入口:账号管理 → 自动评价配置 → 好评后自动发送消息(开关 + 消息内容,存于 AutoRateConfig.thanks_enabled/thanks_content,不新增表)。

实现设计

三条评价路径全部挂钩,共用订单级 is_thanks_sent 标记跨路径去重(沿用 is_red_flower/is_rated 既有模式):

路径 发送方式
websocket 实时评价(收到「快给ta一个评价吧」) 复用当前会话 send_msg 直发
scheduler 定时补评价 内部接口 create-chat + send-message(与定时私信/补发货同模式)
backend 批量补评价 同上

关键细节:

  1. 收件人加固:评价请求是系统卡片消息(message_handler.py 中此类消息 send_user_name="系统"),其 send_user_id 不一定是买家,而 send_msg 会把它写入 LWP actualReceivers。websocket 路径优先取订单表中的权威 buyer_id(新增 get_order_buyer_id 辅助),订单缺失时回退卡片发送者(与确认收货消息取值一致)。
  2. 失败隔离:三处钩子均在评价成功之后、独立 try 内——发送失败/异常仅记日志,绝不影响评价主流程与批量计数。
  3. 拦截识别:wait_result=True 等待服务端结果,send_status=failed(如 CSI_FORBID 安全拦截)不标记去重、保留原因日志;unknown(超时未确认)视为已发出并标记,防止重复打扰买家(与 dm_send_task 语义一致)。
  4. 配置校验:PUT 接口开启时必须填写内容(400),关闭时清空内容避免残留;前端同步校验。
  5. 迁移:init_database 新装 DDL + 老库自动加列(xy_auto_rate_configs.thanks_enabled/thanks_content、xy_orders.is_thanks_sent),条目格式与既有迁移一致。
  6. 批量补评价路径直接按内部接口契约构造 payload,未使用 websocket_client.send_message(其字段与内部接口不一致,fix: 修复 /api/v1/messages/send 无法把消息发送给买家 #326 正在修复,避免依赖冲突)。

触发语义与已知边界

  • 触发点是「本系统评价买家成功」,因此需同时启用自动评价(UI 已注明);卖家在闲鱼 APP 内手动评价不触发
  • 实时与定时路径极端并发下理论上可能重复发送一次(check-then-send 非原子,与既有 is_red_flower 同级别风险,窗口极小)
  • 若需「收到买家好评后发送」(需捕获收到的评价列表接口,参数与响应结构无法离线验证),可作为后续迭代,本 PR 的去重标记与发送链路可直接复用

验证

  • 41 个单元用例全部通过(sqlite 真实 DB + mock HTTP/WebSocket):
    • 配置读取(未启用/空内容/纯空白/strip)与去重标记(含不存在订单)11 例
    • scheduler 路径 11 例:成功 payload 断言、建会话失败、缺 chat_id、缺买家/商品、发送失败、CSI_FORBID 拦截、unknown 标记、HTTP 异常
    • websocket 路径 9 例:收件人 DB 买家优先/回退发送者/双缺失跳过、发送失败不标记、异常吞掉
    • backend 10 例:PUT 校验 400、关闭清空残留、持久化读回、批量钩子各分支
  • py_compile 全部通过;前端 tsc --noEmit + vite build 生产构建通过
  • 已 rebase 至最新 main(6397dcf)后全量回归通过

关联 #232

- AutoRateConfig 新增 thanks_enabled/thanks_content 配置,
  自动评价配置弹窗内增加开关与消息内容输入
- 三条评价路径全部挂钩,订单级 is_thanks_sent 标记跨路径去重:
  1. websocket 实时评价:复用当前会话直发,收件人优先取订单买家ID
     (评价请求为系统卡片消息,send_user_id 不一定是买家)
  2. scheduler 定时补评价:内部接口 create-chat + send-message
  3. backend 批量补评价:同上
- 发送失败/被安全拦截仅记日志,不影响评价主流程;
  wait_result 识别 CSI_FORBID 拦截,unknown 视为已发出防重复打扰
- init_database 支持新装 DDL 与老库自动加列
@zhinianboke
zhinianboke merged commit 6ad38cc into zhinianboke:main Sep 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants