foka-ci/docs/architecture.md

系统架构

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。