跨境乐高零件电商平台-高砖积木

# 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 开发，高效落地复杂项目。