weiyi
项目ReTrade

交易模型与服务边界

先确定谁保存业务事实、谁拥有写权限,再讨论订单、鉴权与内部调用。

从一件商品建立交易模型

普通商品数量有限。创建订单时保存商品、数量和金额快照,进入待付款状态;库存直到支付阶段才扣减。这样未付款订单不会长期占用库存,代价是买家创建订单后仍可能在支付时遇到售罄。

秒杀先把活动数量从普通库存划出,形成独立活动库存。活动结束和取消后的剩余库存归还也需要身份、状态和流水,否则两种库存池之间的转移无法解释。

状态机连接角色与资金

订单沿待付款、已付款待发货、已发货待收货、已完成推进,另有取消、退款和争议分支。每个入口同时检查当前角色和旧状态。例如只有买家可以确认收货,只有卖家可以发货,待付款订单才能被超时取消。

支付把买家可用余额转入冻结余额,确认收货再完成结算。订单状态解释交易进度,资金状态解释钱在哪里。两种状态关联保存,退款与收货才能共享清晰的判断依据。

并发执行时,支付、取消和售后相关入口需要竞争相同订单记录,并在拿到行锁后复检状态。带旧状态条件的更新及 RowsAffected 可以进一步把合法迁移约束放进数据库。

用户认证与资源授权

用户访问 Mall 使用 access token 与 refresh token。RS256 让签发方用私钥签名,校验方用公钥检查签名。短期 access token 降低每次请求查询会话存储的成本,refresh token 的 Redis 白名单支持撤销和续期控制。

验签解决请求身份问题,订单归属、买卖角色和资源可见性由业务接口继续检查。即使用户登录有效,也只能读取自己获准访问的订单信息。刷新与登出路径还要统一处理令牌过期、撤销和会话状态。

Mall 到 Agent 的调用

后续 RPC 专项将调用组织为 Assist、OfflineReply、UploadManual、DeleteManual、GetManualTask 和 RiskReviewProduct 等方法。Mall 先做用户鉴权和资源校验,再通过内部 gRPC 调用 Agent,metadata 携带内部 Token,由服务端拦截器检查来源。

资料中的客户端保留了旧 PostJSON 风格方法名,底层映射成 gRPC 方法并使用自定义 JSON Codec。因此当前 RPC 改造提供了服务与方法边界,完整 protobuf 消息生成契约仍是可以演进的方向。

HMAC 专项讨论了签名、时间窗和 nonce 防重放。它与静态内部 Token 是不同版本的鉴权路径,配置和实现应对应使用。内部调用成功也不能替代 Mall 对最终用户资源权限的检查。

工具调用如何控制业务影响

Agent 的商品与订单工具只读 Mall 暴露的接口。Workflow 决定每类意图能访问哪些工具、需要哪些参数以及如何超时降级。模型负责路由和解释,Mall 继续仲裁交易写入。

离线聊天先保存买家消息,再请求自动回复。模型超时后可以返回模板或暂不生成,已成立的聊天事实继续保留。Agent 的知识库和推理故障因此有独立处理边界。

排查时沿什么顺序看

先检查登录身份,再查资源归属,然后看订单旧状态和数据库事务,最后查看内部调用的超时、返回语义及工具结果。单纯检查 HTTP 200 或 RPC OK,会遗漏“调用成功但业务状态不允许”的情况。

面试时可以沿一个用户请求讲清三层判断,身份是否可信、资源是否可见、状态是否允许动作。这样鉴权、状态机和 Agent 边界会落到同一条实际链路上。

本文整理依据

内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。

  • ReTrade Agent Mall/Mall/1.鉴权方案实现.md
  • ReTrade Agent Mall/Mall/4.订单状态机链路复习.md
  • ReTrade Agent Mall/Mall和Agent的RPC调用笔记.md
  • ReTrade Agent Mall/Agent/Agent深挖复习笔记.md