fix: 重新生成 docs
This commit is contained in:
29
docs/architecture.md
Normal file
29
docs/architecture.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# 系统架构
|
||||
|
||||
## 1. 概览
|
||||
|
||||
MiniCI 采用典型的 **Monorepo** 架构,前端 React 配合后端 Koa,数据持久化使用 SQLite。
|
||||
|
||||
## 2. 核心模块
|
||||
|
||||
### 2.1 后端 (apps/server)
|
||||
|
||||
- **Route System**: 基于 TC39 装饰器的自动扫描路由。
|
||||
- **Execution Queue**: 单例模式的执行队列,控制并发并支持任务持久化恢复。
|
||||
- **Pipeline Runner**: 核心执行逻辑,利用 `zx` 在独立的工作目录下运行 Shell 脚本。
|
||||
- **Data Access**: Prisma ORM 提供类型安全的数据访问。
|
||||
|
||||
### 2.2 前端 (apps/web)
|
||||
|
||||
- **Build Tool**: Rsbuild (基于 Rspack),提供极速的开发体验。
|
||||
- **UI Framework**: React 19 + Arco Design。
|
||||
- **State Management**: Zustand 实现轻量级全局状态。
|
||||
|
||||
## 3. 部署流 (Pipeline Flow)
|
||||
|
||||
1. 用户触发部署 -> 创建 `Deployment` 记录 (Status: pending)。
|
||||
2. `ExecutionQueue` 捕获新任务 -> 实例化 `PipelineRunner`。
|
||||
3. `GitManager` 准备工作目录 (`git clone` 或 `git pull`)。
|
||||
4. `PipelineRunner` 逐个执行 `Step` 脚本。
|
||||
5. 执行过程中实时更新 `Deployment.buildLog`。
|
||||
6. 完成后更新状态为 `success` 或 `failed`。
|
||||
Reference in New Issue
Block a user