一根筋程序员

# 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