- 商品与订单
- 支付与库存
- 异步事件
- 说明书问答
二手商品常常只有少量库存。买家可能反复点击支付,多个人也可能同时购买同一件商品。另一边,买家还会不断询问成色、参数和使用方法,卖家却未必在线。这个项目从这两种压力出发,将交易服务与智能服务放在同一个业务场景中设计。
项目背景与设计目标
ReTrade Agent Mall 是个人二手交易项目。Mall 负责商品、订单、钱包、秒杀、聊天和售后,Agent 负责商品推荐、订单咨询、卖家离线回复与产品手册问答。交易服务保存事实并决定状态能否迁移,智能服务通过受控接口读取信息并组织回答。
需要保证的业务结果很具体。同一订单最终只支付一次,钱包和库存的变化能够追溯,异步任务失败后仍有恢复入口,模型回答能够关联到商品与说明书证据。支付失败、搜索暂时滞后、模型超时,分别在各自边界内处理。
从业务压力选择组件
| 组件 | 在这个项目中承担的职责 | 引入后的成本 |
|---|---|---|
| Gin 与 Go | 承接 Mall HTTP 请求,将鉴权、参数校验和交易逻辑组织为明确入口 | 需要自行维护领域层和事务边界 |
| MySQL | 保存订单、钱包、库存、流水与可靠消息,通过唯一键、行锁和条件更新仲裁并发 | 热点行会排队,需要固定锁顺序和短事务 |
| Redis | 提供在线状态、缓存、秒杀原子资格判断和任务状态 | 缓存与数据库之间需要补偿、失效和恢复设计 |
| Kafka | 缓冲异步下单、搜索同步和后台任务 | 重复投递、消费积压及 offset 处理需要显式设计 |
| Elasticsearch | 承担商品全文检索和过滤,索引由交易事实派生 | 搜索短暂滞后,需要版本控制与失败补偿 |
| Agent、模型 API、Milvus | 将说明书解析成带来源的检索块,检索后交给模型回答 | 解析质量、向量成本、引用正确性需要分别评估 |
Mall 和 Agent 的对外入口、内部 RPC、只读工具各有自己的鉴权边界。资料中保留了 HTTP JSON 与服务间 Token 的早期方案,后续专项笔记把 Mall 调 Agent 收敛到 gRPC。本文以这个内部调用版本串起主线,HMAC 作为单独的鉴权设计讨论。
一次交易怎样流过系统
普通下单先创建待付款订单,支付阶段再竞争库存。用户开始支付时,服务先按 pay_request_id 建立处理记录,然后在主事务中锁订单、复检状态、锁商品、锁钱包,完成余额转冻结、库存扣减和审计流水。订单、资金与库存相关的数据库变化共同提交。
秒杀将请求前置到 Redis。Lua 把资格判断、去重和库存预扣作为一个 Redis 原子操作执行,随后写 MySQL pending message,再异步投递 Kafka。消费者以数据库唯一约束和条件扣库存决定订单能否成立。前端通过请求 ID 查询最终结果。
交易完成后,订单过期、搜索索引和其他派生任务由后台推进。可以与订单同事务写入的事件使用 Outbox;跨 Redis 预扣与 MySQL 落消息的链路保留跨存储窗口,通过补偿和校准处理。
智能服务怎样进入交易场景
用户先经过 Mall 的登录认证和资源权限校验。Agent 通过只读工具读取允许访问的商品或订单字段,模型可以建议回答内容,资金和订单状态仍由 Mall 的确定性接口处理。
卖家离线时,Mall 先持久化买家消息,再尝试生成自动回复。模型失败后,已成功保存的聊天消息继续成立。说明书索引在商品审核通过后异步建立,下载、解析、切块、Embedding 和 Milvus 写入从审核请求中移出。
查询阶段先以商品和文档元数据限定检索范围,再结合向量、词法、章节、FAQ 和表格行候选。精确子块定位答案,少量父章节补足适用条件,最后将证据类型、页码和编号交给模型。
真正决定正确性的三个边界
请求身份与业务状态。 同一个支付请求的重放由支付日志约束,不同请求竞争同一订单则由订单行锁和状态机约束。两层都要存在,才能把网络重试和业务并发分别收敛。
本地事务与异步恢复。 MySQL 事务约束资金、订单和库存同成同败。Kafka、Redis、ES 和向量库跨越存储边界,成功与失败可能发生在不同时间,需要保留事件、批次或任务身份,让重试有据可依。
检索命中与证据使用。 检索指标回答正确片段是否进入候选,生成评测回答模型是否正确使用该片段。结构化证据输入和拒答策略承担生成侧约束,不能只用一个相似度分数代表整套问答质量。
怎样阅读这组笔记
先读交易模型与服务边界,建立用户、订单、商品和 Agent 的责任边界。随后沿支付、秒杀、后台事件与搜索和售后退款读完确定性交易闭环。
再进入说明书异步入库和检索、证据与评测。这里关心的是长任务怎样恢复、块结构怎样保留,以及模型怎样根据证据回答。
验证方式与当前边界
交易验证应检查订单是否只迁移一次、钱包净变化是否匹配唯一成功订单、库存是否为负、消息是否最终进入可解释终态。接口返回成功和高吞吐都无法单独证明业务不变量。
RAG 验证需要固定手册版本、解析与切分规则、Embedding 模型和问题集,再分别统计召回、排序、引用和拒答。资料中有 120 道说明书问题的历史评测描述,本次整理没有复跑原始实验,因此项目页聚焦实验口径和机制。
项目目前仍有需要完善的跨组件窗口,包括秒杀预扣后落消息前的崩溃、入库状态依赖 Redis 的持久性,以及补偿与版本切换的完整闭环。这些边界决定下一轮工程投入的顺序。
本文整理依据
内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。
- ReTrade Agent Mall/0-简历分析/简历题分析.md
- ReTrade Agent Mall/Agent/2026-07-22-说明书RAG问答复习汇总.md
- ReTrade Agent Mall/Agent/Agent复习笔记.md
- ReTrade Agent Mall/Agent/Agent深挖复习笔记.md
- ReTrade Agent Mall/Mall/1.鉴权方案实现.md
- ReTrade Agent Mall/Mall/2.支付链路复习.md
- ReTrade Agent Mall/Mall/3.订单超时取消后台任务链路复习.md
- ReTrade Agent Mall/Mall/4.订单状态机链路复习.md
- ReTrade Agent Mall/Mall/5.秒杀链路复习.md
- ReTrade Agent Mall/Mall/6.商品ES同步与搜索链路复习_优化版.md
- ReTrade Agent Mall/Mall/7.售后退款链路复习.md
- ReTrade Agent Mall/Mall/8.db和tx事务边界笔记.md
- ReTrade Agent Mall/Mall/Mall复习笔记.md
- ReTrade Agent Mall/Mall和Agent的RPC调用笔记.md
- ReTrade Agent Mall/ReTrade Agent Mall 复习笔记.md