docs/00-overview.md

2026-09-29 13:08:21 +08:00
parent c30f7e2e7b
commit cb9b7a4bd4
20 changed files with 1383 additions and 0 deletions
@@ -0,0 +1,81 @@
+# 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**。
+
+架构保持模块化，未来确实需要时再拆服务。