海外华人群体规模庞大，在异国生活中面临独特的二手交易困境：
- 平台割裂：主流二手平台（eBay、Facebook Marketplace）以英文为主，语言障碍高，且缺乏针对华人文化习惯的交互设计
- 信任缺失：在陌生平台与素不相识的人交易，缺乏社区归属感和信任背书
- 支付壁垒：国际转账手续繁琐，华人惯用的支付方式与当地平台不兼容
- 信息分散：华人卖家/买家分散在各个微信群、论坛，交易效率极低，商品曝光有限
解决方案：
鲤鱼市集是专为海外华人社区打造的二手交易平台，以微信小程序为主要载体，无需下载 App，打开即用。平台以华语为核心语言，结合熟悉的社交生态（微信生态），降低使用门槛，同时引入正规支付（Stripe）保障交易安全，让海外华人的闲置物品流转更加便捷、可信。
1. 商品管理
发布、编辑、下架二手商品，支持多图上传、分类标签、新旧程度标注、地理位置标记。买家可通过分类、地区、价格区间、商品状态进行多维筛选。
2. AI 智能搜索 & 对话助手
- 语义搜索：基于 OpenAI Embedding + Weaviate 向量数据库，支持模糊自然语言搜索（如"适合宿舍用的小家电"），突破关键词精确匹配的局限
- AI 对话助手：集成 LangGraph 构建的 Agent，可识别用户意图（直接搜索 / 推荐对比 / 价格行情），自动提取商品类别、价格区间等参数，支持 RAG
增强推荐和价格分析
3. 订单 & 支付
完整的订单生命周期管理（创建 → 支付 → 确认 → 完成/取消），集成 Stripe Connect 实现平台收款后自动分账至卖家，支持部分退款和全额退款，内置
Webhook 事件幂等处理。
4. 即时通讯
买卖双方可在商品详情页发起私信会话，支持多会话管理、未读消息计数。基于 Redis Pub/Sub 实现 WebSocket 跨节点消息广播，支持水平扩展。
5. 促销系统
基于 WHO-WHAT-WHEN 规则引擎的灵活促销体系：
- 支持首单优惠、满减、百分比折扣、平台手续费减免等多种促销类型
- 基于乐观锁（version 字段）防止并发超额使用预算
- 促销状态流转：预留 → 确认（支付成功）/ 取消
6. 评价 & 关注系统
交易完成后双方可互评，买家可关注感兴趣的卖家，获取其新品动态通知。
7. 地址 & 地点管理
用户收货地址管理，支持默认地址设置；集成地点搜索服务，商品可关联具体地理位
后端：FastAPI
数据库和中间件：MongoDB，Weaviate，Redis，AWS SQS
外部工具：Stripe，OpenAI API， LangGraph，Twilio
前端：uni-app，React
部署：AWS ECS
架构与实现亮点
1. 混合搜索
将 Weaviate 向量语义搜索与 MongoDB 条件过滤结合：先用向量搜索召回语义相关商品集合，再用 MongoDB执行分类/价格/地理位置等精确过滤，兼顾搜索质量与过滤灵活性。游标分页（Cursor Pagination）代替 offset，在大数据集下保持稳定性能。
2. LangGraph AI Agent
用 LangGraph 构建有向图工作流，将用户自然语言输入分为三类意图（直接搜索 / RAG 推荐 /价格行情），各意图走不同节点处理链路，最终统一格式化输出。OpenAI Function Calling 负责结构化参数提取（关键词、分类、价格区间等），降低 Prompt工程复杂度。
3. Stripe分账
平台采用 Stripe Connect 目的地收款模式，买家付款后由平台统一收取再自动划转至卖家子账户，支持卖家自主提现。Webhook处理三类事件源（主账户、子账户、Payout），所有处理逻辑均为幂等设计，防止 Stripe 重试导致重复操作。
4. 促销系统
促销预算使用 MongoDB findOneAndUpdate + version 字段实现乐观锁，高并发抢券场景下无需分布式锁，冲突时返回错误由用户重试，兼顾性能与正确性。
5. WebSocket 跨节点广播
即时消息模块使用 Redis Pub/Sub 作为消息总线，每个服务实例订阅频道并将消息推送至本节点的 WebSocket，实现无状态水平扩展，多实例部署时消息不丢失。
评论