wms-saas/docs/02-architecture.md

02 总体架构

架构分层

Vue 3
  ↓
Laravel REST API
  ↓
MySQL / Redis
  ↓
Laravel Queue / Scheduler

Python FastAPI 作为独立 AI / Data Service。

总体结构

                Vue 3
                  │
                  ▼
          Laravel API
                  │
   ┌──────────────┼──────────────┐
   │              │              │
   ▼              ▼              ▼
 MySQL          Redis          Queue
                                  │
                                  ▼
                               Workers
                                  │
                     ┌────────────┴────────────┐
                     │                         │
                     ▼                         ▼
              Third-party APIs           Python Service
                                                │
                                       ┌────────┼────────┐
                                       ▼        ▼        ▼
                                      AI      Analysis  Forecast

三者职责边界

组件	职责
Vue 3	Admin 界面、交互、前端权限展示
Laravel	唯一的核心业务系统：租户、用户、SKU、仓库、库存、入库、出库、订单、物流、权限、审计
Python	独立 AI / 数据分析服务：分析、预测、补货建议、异常检测、AI 助手

• 核心业务逻辑不得迁移到 Python。
• Python 不得直接修改 Laravel 核心业务数据库。

Redis

Redis 用于：

• Cache
• Queue
• Rate Limit
• Lock
• 临时数据

不要把 Redis 当作核心业务数据库。MySQL 永远是业务事实数据源。

不要过度设计

第一阶段不要引入：

• Kubernetes
• Kafka
• Elasticsearch
• MongoDB
• ClickHouse
• 微服务
• 独立认证中心
• Service Mesh

先使用：Laravel + MySQL + Redis + Queue。

架构保持模块化，未来确实需要时再拆服务。