Teanary 多语言多货币外贸商城系统架构与数据流程图

news/2026/1/18 21:36:56/文章来源:https://www.cnblogs.com/teanary/p/19499176

项目地址:https://gitee.com/teanary/teanary_service

系统整体架构

graph TBsubgraph Frontend["🌐 前端层 Frontend Layer"]A[用户浏览器]B[Livewire 组件]C[Blade 模板]D[Tailwind CSS]A --> BB --> CC --> Dendsubgraph Application["⚙️ 应用层 Application Layer"]E[Livewire 组件]F[Service 层]G[Model 层]H[Observer 层]E --> FF --> GG --> Hendsubgraph Services["🔧 业务服务层 Service Layer"]direction TBF1[ProductService 商品服务]F2[PromotionService 促销服务]F3[PaymentService 支付服务]F4[ShippingService 物流服务]F5[SyncService 同步服务]F6[MediaService 媒体服务]F7[CategoryService 分类服务]F8[CartService 购物车服务]F9[LocaleCurrencyService 本地化服务]endsubgraph Data["💾 数据层 Data Layer"]I[(MySQL 数据库)]J[(Redis 缓存)]K[文件存储]endsubgraph Admin["👤 后台管理 Admin Panel"]L[Filament Manager 管理员面板]M[Filament User 用户面板]endsubgraph External["🌍 外部服务 External Services"]N[PayPal 支付网关]O[远程节点 API]P[Ollama AI 翻译服务]endsubgraph Queue["📬 队列系统 Queue System"]Q[队列任务]R[SyncBatchDataJob 批量同步任务]S[ResizeUploadedImage 图片处理任务]T[BatchWriteTrafficStatsJob 流量统计任务]Q --> RQ --> SQ --> TendB --> EF --> F1F --> F2F --> F3F --> F4F --> F5F --> F6F --> F7F --> F8F --> F9G --> IG --> JG --> KL --> FM --> FF3 --> NF5 --> OF9 --> PH --> Qstyle F fill:#e1f5ffstyle G fill:#fff4e1style I fill:#ffe1e1style J fill:#ffe1e1style Q fill:#e1ffe1style Frontend fill:#f0f9ffstyle Application fill:#fef3c7style Services fill:#dbeafestyle Data fill:#fee2e2style Admin fill:#e0e7ffstyle External fill:#f3e8ffstyle Queue fill:#d1fae5

数据流程图

订单处理流程

sequenceDiagramparticipant User as 用户participant Cart as 购物车participant Checkout as 结算页面participant OrderService as 订单服务participant PromotionService as 促销服务participant ShippingService as 物流服务participant PaymentService as 支付服务participant Order as 订单模型participant Observer as 订单观察者participant Notification as 通知系统User->>Cart: 添加商品到购物车Cart->>Cart: 计算小计User->>Checkout: 进入结算页面Checkout->>Checkout: 加载收货地址Checkout->>ShippingService: 获取可用物流方式ShippingService-->>Checkout: 返回物流选项User->>Checkout: 选择物流方式Checkout->>ShippingService: 计算物流费用ShippingService-->>Checkout: 返回费用Checkout->>PromotionService: 计算订单促销PromotionService->>PromotionService: 检查促销规则PromotionService-->>Checkout: 返回促销信息Checkout->>Checkout: 计算订单总价User->>Checkout: 提交订单Checkout->>OrderService: 创建订单OrderService->>Order: 保存订单数据Order->>Observer: 触发 created 事件Observer->>Notification: 发送订单创建通知OrderService-->>Checkout: 返回订单IDCheckout->>PaymentService: 创建支付PaymentService->>PaymentService: 选择支付网关PaymentService-->>Checkout: 返回支付URLCheckout->>User: 跳转到支付页面

多节点数据同步流程

sequenceDiagramparticipant Model as 数据模型participant Observer as 模型观察者participant Syncable as Syncable Traitparticipant SyncService as 同步服务participant SyncLog as 同步日志participant Queue as 队列系统participant SyncJob as 批量同步任务participant RemoteNode as 远程节点participant SyncController as 同步控制器Note over Model,RemoteNode: 数据变更触发同步Model->>Observer: 触发 created/updated/deletedObserver->>Syncable: 检查是否可同步Syncable->>SyncService: recordSync(模型, 操作, 节点)SyncService->>SyncService: 生成同步哈希SyncService->>SyncService: 准备同步数据SyncService->>SyncLog: 创建同步日志记录SyncLog->>SyncLog: 状态: pendingSyncService->>Queue: 分发批量同步任务Queue->>SyncJob: 执行批量同步SyncJob->>SyncJob: 批量获取待同步记录SyncJob->>SyncJob: 按模型类型分组SyncJob->>SyncJob: 打包批量数据SyncJob->>RemoteNode: POST /api/sync/receive-batchNote over RemoteNode: API Key 验证RemoteNode->>SyncController: 接收批量数据SyncController->>SyncController: 验证数据完整性SyncController->>SyncController: 处理批量同步loop 处理每条记录SyncController->>SyncController: 检查是否跳过SyncController->>SyncController: 执行创建/更新/删除SyncController->>SyncController: 更新同步状态endSyncController-->>SyncJob: 返回同步结果SyncJob->>SyncLog: 更新同步状态SyncLog->>SyncLog: 状态: completed/failedalt 同步失败SyncJob->>SyncJob: 自动重试机制end

商品创建流程

flowchart TDA[Chrome 插件/API] --> B[ProductController]B --> C{验证请求}C -->|失败| D[返回错误]C -->|成功| E[开始事务]E --> F[ProductService.createProduct]F --> G[创建 Product 模型]G --> H[ProductObserver]H --> I{需要同步?}I -->|是| J[SyncService.recordSync]I -->|否| K[继续处理]F --> L[MediaService.handleMainImage]L --> M[上传主图]M --> N[创建 Media 记录]N --> O[MediaObserver]O --> P[SyncService.recordSync]F --> Q[CategoryService.findOrCreateCategory]Q --> R{分类存在?}R -->|否| S[创建分类]S --> T[CategoryObserver]T --> U[SyncService.recordSync]R -->|是| V[使用现有分类]F --> W[创建 ProductTranslation]W --> X[ProductTranslationObserver]X --> Y[SyncService.recordSync]F --> Z[创建 ProductVariant]Z --> AA[创建规格关联]F --> AB[提交事务]AB --> AC[返回成功]J --> AD[队列任务]P --> ADU --> ADY --> ADAD --> AE[批量同步到远程节点]style F fill:#e1f5ffstyle J fill:#ffe1e1style AD fill:#e1ffe1

支付处理流程

flowchart TDStart([用户提交订单]) --> CreateOrder[创建订单]CreateOrder --> OrderPending[订单状态: Pending]OrderPending --> GoToPayment[跳转到支付页面]GoToPayment --> CreatePayment[PaymentService.createPayment]CreatePayment --> SelectGateway{选择支付网关}SelectGateway -->|PayPal| PayPalGateway[PayPal 网关]SelectGateway -->|其他| OtherGateway[其他支付网关]PayPalGateway --> GenerateURL[生成支付 URL]GenerateURL --> RedirectPayPal[跳转到 PayPal]RedirectPayPal --> UserPay[用户在 PayPal 完成支付]UserPay --> PaymentResult{支付结果}PaymentResult -->|成功| WebhookSuccess[PayPal Webhook 回调]PaymentResult -->|取消| PaymentCancel[用户取消支付]PaymentResult -->|失败| PaymentFail[支付失败]WebhookSuccess --> VerifyPayment[验证支付签名]VerifyPayment --> UpdateOrder[更新订单状态: Paid]UpdateOrder --> SendNotification[发送通知 用户和管理员]SendNotification --> EndSuccess([支付成功])PaymentCancel --> OrderCancelled[订单状态: Cancelled]OrderCancelled --> EndCancel([订单取消])PaymentFail --> OrderFailed[订单状态: Failed]OrderFailed --> EndFail([支付失败])style CreateOrder fill:#e1f5ffstyle UpdateOrder fill:#e1ffe1style OrderCancelled fill:#ffe1e1style OrderFailed fill:#ffe1e1style EndSuccess fill:#e1ffe1

促销计算流程

flowchart TDA[订单/商品] --> B[PromotionService]B --> C[获取可用促销]C --> D[从缓存获取所有促销]D --> E{缓存存在?}E -->|否| F[查询数据库]F --> G[缓存结果]G --> DE -->|是| H[过滤可用促销]H --> I[检查促销时间]I --> J[检查用户组]J --> K[检查商品关联]K --> L[返回可用促销列表]L --> M[遍历促销规则]M --> N[检查条件类型]N --> O{订单金额条件?}O -->|是| P[比较订单总金额]O -->|否| Q[比较订单数量]P --> R{满足条件?}Q --> RR -->|否| S[跳过此规则]R -->|是| T[计算折扣金额]T --> U{折扣类型?}U -->|固定金额| V[直接使用折扣值]U -->|百分比| W[计算百分比折扣]V --> X[应用折扣]W --> XX --> Y[比较最优折扣]Y --> Z[返回最终价格和促销信息]S --> AA{还有规则?}AA -->|是| MAA -->|否| Zstyle B fill:#e1f5ffstyle D fill:#fff4e1style T fill:#ffe1e1

核心组件说明

1. Service 层架构

Services/
├── ProductService          # 商品业务逻辑
├── PromotionService        # 促销计算逻辑
├── PaymentService          # 支付处理逻辑
├── ShippingService         # 物流计算逻辑
├── SyncService            # 数据同步逻辑
├── MediaService           # 媒体文件处理
├── CategoryService        # 分类管理
├── CartService            # 购物车管理
├── LocaleCurrencyService  # 本地化服务
└── Payments/├── PaymentManager     # 支付网关管理器└── PaypalGateway      # PayPal 支付实现

2. Model 层架构

Models/
├── 核心业务模型
│   ├── Product            # 商品
│   ├── ProductVariant     # 商品规格
│   ├── Order              # 订单
│   ├── Cart               # 购物车
│   └── Promotion          # 促销
├── 关联模型
│   ├── ProductCategory    # 商品分类关联
│   ├── ProductAttributeValue  # 商品属性值
│   └── OrderItem          # 订单项
├── 翻译模型
│   ├── ProductTranslation
│   ├── CategoryTranslation
│   └── PromotionTranslation
└── 系统模型├── SyncLog            # 同步日志├── SyncStatus         # 同步状态└── TrafficStatistic   # 流量统计

3. Observer 层架构

Observers/
├── ProductObserver           # 商品变更监听
├── OrderObserver             # 订单变更监听
├── PromotionObserver         # 促销变更监听
├── CategoryObserver          # 分类变更监听
├── MediaObserver             # 媒体变更监听
└── [其他模型观察者]