# GoBricks 项目业务功能总结
## 项目概述
GoBricks 是一个面向全球市场的乐高积木零件电商平台,采用现代化的微服务架构,为玩家提供零件清单管理、智能购物车、多币种结算等完整的购物体验。
## 核心业务功能
**零件清单管理**:支持创建、编辑和管理零件清单,提供XML、CSV、LDraw等多种格式导入,支持清单分享和协作。
**智能购物车系统**:支持三种商品类型(单个零件、零件清单、套装),采用双层结构设计,支持部分结算和匿名购物车合并。
**运费计算引擎**:基于购物车内容、配送地址等维度动态计算运费,支持多种配送方式和实时运费预估。
**多币种汇率系统**:实时获取和计算多币种汇率,支持汇率历史查询,确保全球用户价格准确性。
**营销促销体系**:支持优惠券、促销码、阶梯折扣、使用限制等多种营销玩法,支持Campaign活动管理。
**订单处理流程**:完整的订单创建、支付、履约、取消流程,支持订单推送到第三方系统(聚水潭、GoBricks),采用异步处理机制。
**用户中心**:提供用户注册、登录(支持Google OAuth等第三方登录)、密码重置、个人信息管理等完整功能。
## 技术架构亮点
**双后端架构设计**:采用 **Medusa.js**(电商核心框架)和 **NestJS**(业务逻辑服务)双后端架构,Medusa提供标准化电商能力,NestJS处理复杂业务逻辑和数据处理。
**双数据库存储**:**PostgreSQL**(Medusa)存储电商核心数据,**MongoDB**(NestJS)存储业务数据和零件信息,通过数据同步机制保持一致性。
**模块化架构**:采用高度解耦的模块化设计,包括零件清单、购物车、运费、汇率等模块,每个模块独立开发、测试和部署。
**数据同步机制**:实现GoBricks API数据自动同步,支持全量和增量同步,通过定时任务保障数据实时性。
**性能优化**:使用Redis缓存提升查询性能,实现零件信息、价格等热点数据的缓存机制。
**文件解析引擎**:支持多种格式的零件清单文件解析(XML、CSV、LDraw等),自动提取零件信息并匹配系统数据。
**异步处理机制**:订单取消、数据同步等耗时操作采用异步处理,提升系统响应速度。
**工作流引擎**:基于Medusa Workflow实现复杂的业务流程编排,如购物车结算、促销应用等,确保流程的可追溯性和可扩展性。
## 技术栈
- **后端框架**:Medusa.js v2、NestJS
- **数据库**:PostgreSQL、MongoDB
- **缓存**:Redis
- **语言**:TypeScript
- **日志**:Winston
- **云存储**:阿里云OSS
采用 Medusa.js 电商框架 + NestJS 微服务双架构,搭配
PostgreSQL+MongoDB+Redis 三层数据存储,统筹集成 Stripe/PayPal 支付、Google/Facebook OAuth、阿里云 OSS、物流跟踪、ERP 对接、搜索引擎等多第三方服务,落地动态折扣、自动化运费 计算等核心业务;带领团队借助大模型工具(cursor/claude4/deepseek-v3)完成需求分析、架构设计及 API 开发,高效落地复杂项目。