# 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**。

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