904 lines
88 KiB
Markdown
904 lines
88 KiB
Markdown
# Code 项目架构分层图
|
||
|
||
> 一个现代化的代码协作与团队沟通平台
|
||
>
|
||
> 技术栈：Rust (后端) + TypeScript/React (前端) + Kubernetes (部署)
|
||
|
||
---
|
||
|
||
## 系统全景架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 用 户 层 │
|
||
│ │
|
||
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
|
||
│ │ Web 浏览器 │ │ Git 客户端 │ │ 外部 CI/CD │ │
|
||
│ │ (React SPA) │ │ (git/SSH) │ │ (GitHub/GitLab) │ │
|
||
│ └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘ │
|
||
└──────────────────┼────────────────────────────────┼────────────────────────────────┼────────────────┘
|
||
│ │ │
|
||
│ HTTP/WS │ Git Protocol │ Webhook
|
||
│ │ │
|
||
┌──────────────────▼────────────────────────────────▼────────────────────────────────▼────────────────┐
|
||
│ 接入层 (Ingress/LB) │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ Load Balancer / K8s Ingress (:80/:443) │ │
|
||
│ └──────────────────────┬──────────────────────┬──────────────────────┬─────────────┘ │
|
||
└────────────────────────────────┼──────────────────────┼──────────────────────┼──────────────────────┘
|
||
│ │ │
|
||
│ REST API │ Git Ops │ Webhook
|
||
│ │ │
|
||
┌────────────────────────────────▼──────────────────────▼──────────────────────▼──────────────────────┐
|
||
│ 应 用 服 务 层 (apps/) │
|
||
│ │
|
||
│ ┌────────────────────┐ ┌────────────────────┐ ┌────────────────────┐ ┌────────────────────┐ │
|
||
│ │ apps/app │ │ apps/gitserver │ │ apps/git-hook │ │ apps/email │ │
|
||
│ │ 主 Web API 服务 │ │ Git HTTP/SSH 服务 │ │ Git Hook 处理器 │ │ 邮件发送 Worker │ │
|
||
│ │ :8080 │ │ :8021/:2222 │ │ Worker │ │ Worker │ │
|
||
│ │ HTTP + WebSocket │ │ HTTP + SSH │ │ 异步任务 │ │ 队列消费 │ │
|
||
│ │ 多实例部署 │ │ 单实例 │ │ 单实例 │ │ 单实例 │ │
|
||
│ └─────────┬──────────┘ └─────────┬──────────┘ └─────────┬──────────┘ └─────────┬──────────┘ │
|
||
└─────────────┼───────────────────────┼───────────────────────┼───────────────────────┼───────────────┘
|
||
│ │ │ │
|
||
│ │ │ │
|
||
┌─────────────▼───────────────────────▼───────────────────────▼───────────────────────▼───────────────┐
|
||
│ 应 用 编 排 层 (apps/operator) │
|
||
│ │
|
||
│ ┌───────────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ apps/operator (Kubernetes Operator) │ │
|
||
│ │ │ │
|
||
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
|
||
│ │ │ App CRD │ │GitSrv CRD│ │Email CRD │ │Hook CRD │ │Mig CRD │ │ │
|
||
│ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │
|
||
│ │ │ │ │ │ │ │ │
|
||
│ │ ▼ ▼ ▼ ▼ ▼ │ │
|
||
│ │ ┌──────────────────────────────────────────────────────────────────────────┐ │ │
|
||
│ │ │ K8s 资源 (Deployments, Services, PVCs, Jobs) │ │ │
|
||
│ │ └──────────────────────────────────────────────────────────────────────────┘ │ │
|
||
│ └───────────────────────────────────────────────────────────────────────────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
│ │ │ │
|
||
│ │ │ │
|
||
┌─────────────▼───────────────────────▼───────────────────────▼───────────────────────▼───────────────┐
|
||
│ 业 务 逻 辑 层 (libs/service) │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ AppService { 全局服务聚合 } │ │
|
||
│ │ │ │
|
||
│ │ ┌─────────┐ ┌────────┐ ┌─────┐ ┌──────────┐ ┌───────────┐ ┌────────┐ ┌───────────┐ │ │
|
||
│ │ │ agent/ │ │ auth/ │ │git/ │ │ issue/ │ │ project/ │ │ user/ │ │ pull_req/ │ │ │
|
||
│ │ │ (8文件) │ │ (10) │ │(16) │ │ (8) │ │ (20) │ │ (12) │ │ (5) │ │ │
|
||
│ │ │ AI模型 │ │ 认证 │ │Git │ │ Issue │ │ 项目管理 │ │ 用户 │ │ PR审查 │ │ │
|
||
│ │ │ 管理 │ │ 会话 │ │操作 │ │ 追踪 │ │ 权限控制 │ │ 偏好 │ │ 合并 │ │ │
|
||
│ │ └─────────┘ └────────┘ └─────┘ └──────────┘ └───────────┘ └────────┘ └───────────┘ │ │
|
||
│ │ │ │
|
||
│ │ + utils/(project,repo,user) + ws_token + error + Pager │ │
|
||
│ └──────────────────────────────────────┬──────────────────────────────────────────────────┘ │
|
||
└──────────────────────────────────────────┼──────────────────────────────────────────────────────────┘
|
||
│
|
||
┌──────────────────────┼──────────────────────┐
|
||
│ │ │
|
||
┌───────────────────▼──────────┐ ┌────────▼─────────────┐ ┌──────▼────────────────────────────┐
|
||
│ HTTP 路由层 (libs/api) │ │ WebSocket 层 │ │ 后台 Worker 层 │
|
||
│ 100 个路由文件 │ │ (libs/room) │ │ │
|
||
│ │ │ │ │ libs/queue: │
|
||
│ /api/auth/* (9端点) │ │ /ws │ │ MessageProducer │
|
||
│ /api/git/* (100+端点) │ │ /ws/rooms/{id} │ │ RedisPubSub │
|
||
│ /api/projects/* (50+端点) │ │ /ws/projects/{id} │ │ room_worker_task │
|
||
│ /api/issue/* (30+端点) │ │ │ │ start_email_worker │
|
||
│ /api/room/* (40+端点) │ │ 实时消息广播 │ │ │
|
||
│ /api/pull_request/* (20端点)│ │ 多实例同步 │ │ libs/git/hook: │
|
||
│ /api/agent/* (15端点) │ │ AI 流式输出 │ │ GitServiceHooks │
|
||
│ /api/user/* (20端点) │ │ │ │ GitHookPool │
|
||
│ /api/openapi/* (文档) │ │ │ │ │
|
||
└───────────┬────────────────┘ └──────────┬───────────┘ └─────────────┬───────────────────────┘
|
||
│ │ │
|
||
└─────────────────────────────┼───────────────────────────┘
|
||
│
|
||
┌─────────────────────────────────────────▼────────────────────────────────────────────────────────┐
|
||
│ 基 础 设 施 层 (Infrastructure Libs) │
|
||
│ │
|
||
│ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ │
|
||
│ │ libs/models │ │ libs/db │ │ libs/config │ │ libs/session │ │
|
||
│ │ 92 个实体文件 │ │ 数据库连接池 │ │ 全局配置管理 │ │ 会话管理中间件 │ │
|
||
│ │ Sea-ORM 实体定义 │ │ 缓存抽象 │ │ .env 加载 │ │ Redis Store │ │
|
||
│ │ 类型别名 │ │ 重试机制 │ │ 12 子模块 │ │ JWT + Cookie │ │
|
||
│ └─────────┬─────────┘ └─────────┬─────────┘ └─────────┬─────────┘ └─────────┬─────────┘ │
|
||
│ │ │ │ │ │
|
||
│ ┌─────────▼─────────┐ ┌────────▼─────────┐ ┌─────────▼─────────┐ ┌─────────▼─────────┐ │
|
||
│ │ libs/git │ │ libs/agent │ │ libs/email │ │ libs/avatar │ │
|
||
│ │ 19 子模块 │ │ 6 子模块 │ │ SMTP 邮件发送 │ │ 图片处理 │ │
|
||
│ │ libgit2 封装 │ │ OpenAI 集成 │ │ lettre 客户端 │ │ image crate │ │
|
||
│ │ HTTP + SSH 协议 │ │ Qdrant 向量库 │ │ 模板引擎 │ │ 缩放/裁剪 │ │
|
||
│ └─────────┬─────────┘ └─────────┬─────────┘ └─────────┬─────────┘ └─────────┬─────────┘ │
|
||
│ │ │ │ │ │
|
||
│ ┌─────────▼─────────┐ ┌────────▼─────────┐ ┌─────────▼───────────────────────▼─────────┐ │
|
||
│ │ libs/queue │ │ libs/room │ │ libs/migrate │ │
|
||
│ │ 消息队列 │ │ 实时聊天室 │ │ 82+ 数据库迁移脚本 │ │
|
||
│ │ Redis Streams │ │ 19 子模块 │ │ sea-orm-migration │ │
|
||
│ │ Pub/Sub │ │ WebSocket 管理 │ │ up/down/fresh/refresh/reset │ │
|
||
│ └─────────┬─────────┘ └─────────┬─────────┘ └─────────────────────────────────────────┘ │
|
||
│ │ │ │
|
||
│ ┌─────────▼─────────┐ ┌────────▼─────────┐ │
|
||
│ │ libs/webhook │ │ libs/rpc │ libs/transport │
|
||
│ │ (占位) │ │ (占位) │ (占位) │
|
||
│ └───────────────────┘ └─────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
│ │
|
||
│ │
|
||
┌─────────────▼──────────────────────▼────────────────────────────────────────────────────────────┐
|
||
│ 存 储 层 │
|
||
│ │
|
||
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
|
||
│ │ PostgreSQL │ │ Redis │ │ Qdrant │ │ 文件系统 │ │
|
||
│ │ :5432 │ │ :6379 │ │ :6333 │ │ │ │
|
||
│ │ │ │ │ │ │ │ /data/avatars │ │
|
||
│ │ • 用户数据 │ │ • 会话存储 │ │ • 向量嵌入 │ │ /data/repos │ │
|
||
│ │ • 项目/仓库 │ │ • 缓存数据 │ │ • AI 索引 │ │ • 头像图片 │ │
|
||
│ │ • Issue/PR │ │ • Pub/Sub │ │ • 相似度检索 │ │ • Git 仓库 │ │
|
||
│ │ • Room 消息 │ │ • Stream 队列 │ │ │ │ • 上传文件 │ │
|
||
│ │ • 评论/标签 │ │ • Hook 队列 │ │ │ │ │ │
|
||
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
│
|
||
│ 外部 API
|
||
│
|
||
┌─────────────▼────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 外 部 服 务 │
|
||
│ │
|
||
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
|
||
│ │ SMTP 服务器 │ │ OpenAI API │ │ Embedding API │ │
|
||
│ │ :587 │ │ HTTPS │ │ HTTPS │ │
|
||
│ │ │ │ │ │ │ │
|
||
│ │ • 邮件发送 │ │ • 聊天补全 │ │ • 文本向量化 │ │
|
||
│ │ • 通知邮件 │ │ • AI 助手 │ │ • 相似度计算 │ │
|
||
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 前端架构分层
|
||
|
||
```
|
||
┌────────────────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 前 端 应 用 层 (src/) │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ Vite + React + TypeScript │ │
|
||
│ │ │ │
|
||
│ │ src/main.tsx ──▶ App.tsx ──▶ BrowserRouter ──▶ Routes │ │
|
||
│ │ │ │
|
||
│ │ ┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐ │ │
|
||
│ │ │ 页面层 (app/) │ │ 组件层 (components/) │ │ 状态管理层 │ │ │
|
||
│ │ │ 59 页面组件 │ │ 108 UI 组件 │ │ │ │ │
|
||
│ │ │ │ │ │ │ TanStack Query │ │ │
|
||
│ │ │ auth/ (4) │ │ ui/ (66) │ │ (服务端状态) │ │ │
|
||
│ │ │ init/ (2) │ │ room/ (20) │ │ │ │ │
|
||
│ │ │ user/ (1) │ │ repository/ (8) │ │ React Context │ │ │
|
||
│ │ │ project/ (22) │ │ project/ (4) │ │ (全局状态) │ │ │
|
||
│ │ │ repository/ (12) │ │ auth/ (2) │ │ │ │ │
|
||
│ │ │ settings/ (8) │ │ layout/ (2) │ │ Local State │ │ │
|
||
│ │ │ │ │ │ │ (组件状态) │ │ │
|
||
│ │ └───────────┬───────────┘ └───────────┬───────────┘ └───────────┬────────────┘ │ │
|
||
│ │ │ │ │ │ │
|
||
│ │ └────────────────────────────┼────────────────────────────┘ │ │
|
||
│ │ │ │ │
|
||
│ │ ┌────────────────────────────────────────┼────────────────────────────────────────┐ │ │
|
||
│ │ │ API 客户端层 │ │ │
|
||
│ │ │ │ │ │
|
||
│ │ │ src/client/ ──▶ openapi-ts 自动生成 (从 openapi.json) │ │ │
|
||
│ │ │ 400+ API 函数 + 完整 TypeScript 类型 │ │ │
|
||
│ │ │ Axios HTTP 客户端 │ │ │
|
||
│ │ └──────────────────────────────────────────────────────────────────────────────────┘ │ │
|
||
│ │ │ │
|
||
│ │ ┌──────────────────────────────────────────────────────────────────────────────────┐ │ │
|
||
│ │ │ 工具层 │ │ │
|
||
│ │ │ │ │ │
|
||
│ │ │ src/hooks/ ──▶ 自定义 React Hooks │ │ │
|
||
│ │ │ src/lib/ ──▶ 工具函数 (api-error, rsa, date 等) │ │ │
|
||
│ │ │ src/contexts/ ──▶ React Context (User, Theme 等) │ │ │
|
||
│ │ │ src/assets/ ──▶ 静态资源 (图片、图标) │ │ │
|
||
│ │ └──────────────────────────────────────────────────────────────────────────────────┘ │ │
|
||
│ └──────────────────────────────────────────────────────────────────────────────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 前端路由结构
|
||
|
||
```
|
||
/ 首页/仪表板
|
||
│
|
||
├── /auth/ 认证路由
|
||
│ ├── /login 登录页
|
||
│ ├── /register 注册页
|
||
│ ├── /password/reset 密码重置
|
||
│ └── /verify-email 邮箱验证
|
||
│
|
||
├── /init/ 初始化路由
|
||
│ ├── /project 初始化项目
|
||
│ └── /repository 初始化仓库
|
||
│
|
||
├── /user/:user 用户资料页
|
||
│
|
||
├── /settings/ 个人设置
|
||
│ ├── /profile 个人资料
|
||
│ ├── /account 账户设置
|
||
│ ├── /security 安全设置
|
||
│ ├── /tokens 访问令牌
|
||
│ ├── /ssh-keys SSH 密钥
|
||
│ ├── /preferences 偏好设置
|
||
│ └── /activity 活动日志
|
||
│
|
||
├── /project/:project_name/ 项目路由
|
||
│ ├── / 项目概览
|
||
│ ├── /activity 项目活动
|
||
│ ├── /repositories 仓库列表
|
||
│ ├── /issues Issue 列表
|
||
│ │ ├── /new 新建 Issue
|
||
│ │ └── /:issueNumber Issue 详情
|
||
│ ├── /boards 看板列表
|
||
│ │ └── /:boardId 看板详情
|
||
│ ├── /members 成员管理
|
||
│ ├── /room 聊天室列表
|
||
│ │ └── /:roomId 聊天室
|
||
│ ├── /articles 文章
|
||
│ ├── /resources 资源
|
||
│ └── /settings/ 项目设置
|
||
│ ├── /general 通用设置
|
||
│ ├── /labels 标签管理
|
||
│ ├── /billing 账单
|
||
│ ├── /members 成员管理
|
||
│ ├── /oauth OAuth 配置
|
||
│ └── /webhook Webhook 管理
|
||
│
|
||
├── /repository/:namespace/:repoName/ 仓库路由
|
||
│ ├── / 仓库概览
|
||
│ ├── /branches 分支管理
|
||
│ ├── /commits 提交历史
|
||
│ │ └── /:oid 提交详情
|
||
│ ├── /contributors 贡献者
|
||
│ ├── /files 文件浏览
|
||
│ ├── /tags 标签
|
||
│ ├── /pull-requests PR 列表
|
||
│ │ ├── /new 新建 PR
|
||
│ │ └── /:prNumber PR 详情
|
||
│ └── /settings 仓库设置
|
||
│
|
||
├── /search 全局搜索
|
||
└── /notifications 通知中心
|
||
```
|
||
|
||
---
|
||
|
||
## 后端服务依赖关系
|
||
|
||
```
|
||
┌──────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ apps/ 应用依赖关系 │
|
||
│ │
|
||
│ apps/app ────────────────┐ │
|
||
│ apps/email ──────────────┤ │
|
||
│ apps/git-hook ───────────┤──▶ libs/config (全局配置) │
|
||
│ apps/gitserver ──────────┤──▶ libs/db (数据库连接池 + 缓存) │
|
||
│ apps/migrate ────────────┤──▶ libs/session (会话管理) │
|
||
│ apps/operator ───────────┘──▶ libs/migrate (数据库迁移) │
|
||
│ ├──▶ libs/service (业务逻辑层) │
|
||
│ │ │ │
|
||
│ │ ├──▶ libs/api (HTTP 路由) │
|
||
│ │ │ │
|
||
│ │ ├──▶ libs/agent (AI 服务) │
|
||
│ │ ├──▶ libs/avatar (头像处理) │
|
||
│ │ ├──▶ libs/email (邮件发送) │
|
||
│ │ ├──▶ libs/room (聊天室) │
|
||
│ │ │ │ │
|
||
│ │ │ └──▶ libs/queue (消息队列) │
|
||
│ │ │ │
|
||
│ │ └──▶ libs/git (Git 操作) │
|
||
│ │ │ │
|
||
│ │ ├──▶ git2 (libgit2 绑定) │
|
||
│ │ ├──▶ git2-hooks (Git 钩子) │
|
||
│ │ └──▶ russh (SSH 协议) │
|
||
│ │ │
|
||
│ └──▶ libs/models (数据模型 - 所有层共享) │
|
||
│ │ │
|
||
│ ├──▶ users/ (12 实体) │
|
||
│ ├──▶ projects/ (19 实体) │
|
||
│ ├──▶ repos/ (16 实体) │
|
||
│ ├──▶ issues/ (10 实体) │
|
||
│ ├──▶ pull_request/ (5 实体) │
|
||
│ ├──▶ rooms/ (11 实体) │
|
||
│ ├──▶ agents/ (6 实体) │
|
||
│ ├──▶ ai/ (3 实体) │
|
||
│ └──▶ system/ (3 实体) │
|
||
└──────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## libs/models 实体分组
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ libs/models 实体分组 (92 个) │
|
||
├─────────────────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ Users (12 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ user 用户基本信息 │ │
|
||
│ │ user_2fa 双因素认证 │ │
|
||
│ │ user_activity_log 用户活动日志 │ │
|
||
│ │ user_email 用户邮箱 │ │
|
||
│ │ user_email_change 邮箱变更历史 │ │
|
||
│ │ user_notification 用户通知 │ │
|
||
│ │ user_password 用户密码 │ │
|
||
│ │ user_password_reset 密码重置令牌 │ │
|
||
│ │ user_preferences 用户偏好设置 │ │
|
||
│ │ user_relation 用户关系 │ │
|
||
│ │ user_ssh_key SSH 密钥 │ │
|
||
│ │ user_token 访问令牌 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Projects (19 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ project 项目基本信息 │ │
|
||
│ │ project_access_log 访问日志 │ │
|
||
│ │ project_activity 活动记录 │ │
|
||
│ │ project_audit_log 审计日志 │ │
|
||
│ │ project_billing 账单信息 │ │
|
||
│ │ project_billing_history 账单历史 │ │
|
||
│ │ project_board 看板 │ │
|
||
│ │ project_board_card 看板卡片 │ │
|
||
│ │ project_board_column 看板列 │ │
|
||
│ │ project_follow 项目关注 │ │
|
||
│ │ project_history_name 历史名称 │ │
|
||
│ │ project_label 项目标签 │ │
|
||
│ │ project_like 项目点赞 │ │
|
||
│ │ project_member_ 成员邀请 │ │
|
||
│ │ invitations │ │
|
||
│ │ project_member_join_ 加入问答 │ │
|
||
│ │ answers │ │
|
||
│ │ project_member_join_ 加入请求 │ │
|
||
│ │ request │ │
|
||
│ │ project_member_join_ 加入设置 │ │
|
||
│ │ settings │ │
|
||
│ │ project_members 项目成员 │ │
|
||
│ │ project_watch 项目观看 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Repos (16 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ repo 仓库基本信息 │ │
|
||
│ │ repo_branch 分支信息 │ │
|
||
│ │ repo_branch_protect 分支保护 │ │
|
||
│ │ repo_collaborator 协作者 │ │
|
||
│ │ repo_commit 提交记录 │ │
|
||
│ │ repo_fork 仓库 Fork │ │
|
||
│ │ repo_history_name 历史名称 │ │
|
||
│ │ repo_hook Git 钩子 │ │
|
||
│ │ repo_lfs_lock LFS 锁定 │ │
|
||
│ │ repo_lfs_object LFS 对象 │ │
|
||
│ │ repo_lock 仓库锁定 │ │
|
||
│ │ repo_star 仓库星标 │ │
|
||
│ │ repo_tag 仓库标签 │ │
|
||
│ │ repo_upstream 上游仓库 │ │
|
||
│ │ repo_watch 仓库观看 │ │
|
||
│ │ repo_webhook 仓库 Webhook │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Issues (10 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ issue Issue 基本信息 │ │
|
||
│ │ issue_assignee Issue 负责人 │ │
|
||
│ │ issue_comment Issue 评论 │ │
|
||
│ │ issue_comment_reaction 评论表情 │ │
|
||
│ │ issue_label Issue 标签 │ │
|
||
│ │ issue_pull_request Issue 关联 PR │ │
|
||
│ │ issue_reaction Issue 表情 │ │
|
||
│ │ issue_repo Issue 仓库 │ │
|
||
│ │ issue_subscriber Issue 订阅者 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Pull Requests (5 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ pull_request PR 基本信息 │ │
|
||
│ │ pull_request_commit PR 提交记录 │ │
|
||
│ │ pull_request_review PR 审查 │ │
|
||
│ │ pull_request_review_ PR 审查评论 │ │
|
||
│ │ comment │ │
|
||
│ │ pull_request_review_ PR 审查请求 │ │
|
||
│ │ request │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Rooms (11 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ room 聊天室基本信息 │ │
|
||
│ │ room_ai 聊天室 AI 配置 │ │
|
||
│ │ room_category 聊天室分类 │ │
|
||
│ │ room_member 聊天室成员 │ │
|
||
│ │ room_message 聊天消息 │ │
|
||
│ │ room_message_edit_ 消息编辑历史 │ │
|
||
│ │ history │ │
|
||
│ │ room_message_reaction 消息表情 │ │
|
||
│ │ room_notifications 聊天室通知 │ │
|
||
│ │ room_pin 聊天室置顶 │ │
|
||
│ │ room_thread 聊天室 Thread │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ Agents (6 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ model AI 模型 │ │
|
||
│ │ model_capability 模型能力 │ │
|
||
│ │ model_parameter_profile 模型参数配置 │ │
|
||
│ │ model_pricing 模型定价 │ │
|
||
│ │ model_provider 模型提供商 │ │
|
||
│ │ model_version 模型版本 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ AI (3 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ ai_session AI 会话 │ │
|
||
│ │ ai_tool_auth AI 工具认证 │ │
|
||
│ │ ai_tool_call AI 工具调用 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ System (3 实体) │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ label 系统标签 │ │
|
||
│ │ notify 系统通知 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## libs/service 业务模块
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ libs/service 业务模块 (93 个文件) │
|
||
├─────────────────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ agent/ AI 模型管理 (8 文件) │
|
||
│ ├── code_review AI 代码审查 │
|
||
│ ├── model AI 模型管理 │
|
||
│ ├── model_capability 模型能力管理 │
|
||
│ ├── model_parameter_ 模型参数配置 │
|
||
│ │ profile │
|
||
│ ├── model_pricing 模型定价管理 │
|
||
│ ├── model_version 模型版本管理 │
|
||
│ ├── pr_summary PR 摘要生成 │
|
||
│ └── provider 模型提供商管理 │
|
||
│ │
|
||
│ auth/ 认证管理 (10 文件) │
|
||
│ ├── captcha 验证码管理 │
|
||
│ ├── email 邮箱认证 │
|
||
│ ├── login 登录逻辑 │
|
||
│ ├── logout 登出逻辑 │
|
||
│ ├── me 当前用户信息 │
|
||
│ ├── password 密码管理 │
|
||
│ ├── register 注册逻辑 │
|
||
│ ├── rsa RSA 加密 │
|
||
│ └── totp TOTP 双因素认证 │
|
||
│ │
|
||
│ git/ Git 操作 (16 文件) │
|
||
│ ├── archive 仓库归档 │
|
||
│ ├── blocking 阻塞操作 │
|
||
│ ├── blame Git Blame │
|
||
│ ├── blob Blob 操作 │
|
||
│ ├── branch 分支操作 │
|
||
│ ├── branch_ 分支保护 │
|
||
│ │ protection │
|
||
│ ├── commit 提交操作 │
|
||
│ ├── contributors 贡献者统计 │
|
||
│ ├── diff Diff 操作 │
|
||
│ ├── init 仓库初始化 │
|
||
│ ├── refs 引用操作 │
|
||
│ ├── repo 仓库操作 │
|
||
│ ├── star 星标操作 │
|
||
│ ├── tag 标签操作 │
|
||
│ ├── tree 树操作 │
|
||
│ └── watch 观看操作 │
|
||
│ │
|
||
│ issue/ Issue 管理 (8 文件) │
|
||
│ ├── assignee 负责人管理 │
|
||
│ ├── comment 评论管理 │
|
||
│ ├── issue Issue CRUD │
|
||
│ ├── label 标签管理 │
|
||
│ ├── pull_request Issue 关联 PR │
|
||
│ ├── reaction 表情回应 │
|
||
│ ├── repo 仓库 Issue │
|
||
│ └── subscriber 订阅者管理 │
|
||
│ │
|
||
│ project/ 项目管理 (20 文件) │
|
||
│ ├── activity 项目活动 │
|
||
│ ├── audit 审计日志 │
|
||
│ ├── avatar 项目头像 │
|
||
│ ├── billing 账单管理 │
|
||
│ ├── board 看板管理 │
|
||
│ ├── can_use 权限检查 │
|
||
│ ├── info 项目信息 │
|
||
│ ├── init 项目初始化 │
|
||
│ ├── invitation 邀请管理 │
|
||
│ ├── join_answers 加入问答 │
|
||
│ ├── join_request 加入请求 │
|
||
│ ├── join_settings 加入设置 │
|
||
│ ├── labels 标签管理 │
|
||
│ ├── like 点赞管理 │
|
||
│ ├── members 成员管理 │
|
||
│ ├── repo 仓库管理 │
|
||
│ ├── repo_ 仓库权限 │
|
||
│ │ permission │
|
||
│ ├── settings 项目设置 │
|
||
│ ├── standard 项目标准 │
|
||
│ ├── transfer_repo 仓库转移 │
|
||
│ └── watch 观看管理 │
|
||
│ │
|
||
│ pull_request/ PR 管理 (5 文件) │
|
||
│ ├── merge PR 合并 │
|
||
│ ├── pull_request PR CRUD │
|
||
│ ├── review PR 审查 │
|
||
│ ├── review_comment 审查评论 │
|
||
│ └── review_request 审查请求 │
|
||
│ │
|
||
│ user/ 用户管理 (12 文件) │
|
||
│ ├── access_key 访问密钥 │
|
||
│ ├── avatar 用户头像 │
|
||
│ ├── chpc 用户 CHPC │
|
||
│ ├── notification 通知管理 │
|
||
│ ├── notify 通知发送 │
|
||
│ ├── preferences 偏好设置 │
|
||
│ ├── profile 用户资料 │
|
||
│ ├── projects 用户项目 │
|
||
│ ├── repository 用户仓库 │
|
||
│ ├── ssh_key SSH 密钥 │
|
||
│ ├── subscribe 订阅管理 │
|
||
│ └── user_info 用户信息 │
|
||
│ │
|
||
│ utils/ 工具函数 (3 文件) │
|
||
│ ├── project 项目工具 │
|
||
│ ├── repo 仓库工具 │
|
||
│ └── user 用户工具 │
|
||
│ │
|
||
│ ws_token WebSocket Token 服务 │
|
||
│ error 服务层错误 │
|
||
│ Pager 分页结构体 │
|
||
└─────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## libs/api 路由模块
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ libs/api 路由模块 (100 个文件) │
|
||
├─────────────────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ auth/ 认证路由 (9 文件) │
|
||
│ ├── captcha 验证码接口 │
|
||
│ ├── email 邮箱认证接口 │
|
||
│ ├── login 登录接口 │
|
||
│ ├── logout 登出接口 │
|
||
│ ├── me 当前用户接口 │
|
||
│ ├── password 密码接口 │
|
||
│ ├── register 注册接口 │
|
||
│ ├── totp TOTP 接口 │
|
||
│ └── ws_token WebSocket Token 接口 │
|
||
│ │
|
||
│ git/ Git 路由 (18 文件) │
|
||
│ ├── archive 归档接口 │
|
||
│ ├── blame Blame 接口 │
|
||
│ ├── blob Blob 接口 │
|
||
│ ├── branch 分支接口 │
|
||
│ ├── branch_ 分支保护接口 │
|
||
│ │ protection │
|
||
│ ├── commit 提交接口 │
|
||
│ ├── contributors 贡献者接口 │
|
||
│ ├── diff Diff 接口 │
|
||
│ ├── init 初始化接口 │
|
||
│ ├── refs 引用接口 │
|
||
│ ├── repo 仓库接口 │
|
||
│ ├── star 星标接口 │
|
||
│ ├── tag 标签接口 │
|
||
│ ├── tree 树接口 │
|
||
│ └── watch 观看接口 │
|
||
│ │
|
||
│ project/ 项目路由 (17 文件) │
|
||
│ ├── activity 活动接口 │
|
||
│ ├── audit 审计接口 │
|
||
│ ├── billing 账单接口 │
|
||
│ ├── board 看板接口 │
|
||
│ ├── info 信息接口 │
|
||
│ ├── init 初始化接口 │
|
||
│ ├── invitation 邀请接口 │
|
||
│ ├── join_answers 加入问答接口 │
|
||
│ ├── join_request 加入请求接口 │
|
||
│ ├── join_settings 加入设置接口 │
|
||
│ ├── labels 标签接口 │
|
||
│ ├── like 点赞接口 │
|
||
│ ├── members 成员接口 │
|
||
│ ├── repo 仓库接口 │
|
||
│ ├── settings 设置接口 │
|
||
│ ├── transfer_repo 仓库转移接口 │
|
||
│ └── watch 观看接口 │
|
||
│ │
|
||
│ issue/ Issue 路由 (10 文件) │
|
||
│ ├── assignee 负责人接口 │
|
||
│ ├── comment 评论接口 │
|
||
│ ├── comment_ 评论表情接口 │
|
||
│ │ reaction │
|
||
│ ├── issue_label Issue 标签接口 │
|
||
│ ├── label 标签接口 │
|
||
│ ├── pull_request Issue 关联 PR 接口 │
|
||
│ ├── reaction 表情接口 │
|
||
│ ├── repo 仓库 Issue 接口 │
|
||
│ └── subscriber 订阅者接口 │
|
||
│ │
|
||
│ room/ 聊天室路由 (14 文件) │
|
||
│ ├── ai AI 接口 │
|
||
│ ├── category 分类接口 │
|
||
│ ├── draft_and_ 草稿和历史接口 │
|
||
│ │ history │
|
||
│ ├── member 成员接口 │
|
||
│ ├── message 消息接口 │
|
||
│ ├── notification 通知接口 │
|
||
│ ├── pin 置顶接口 │
|
||
│ ├── reaction 表情接口 │
|
||
│ ├── room 聊天室接口 │
|
||
│ ├── thread Thread 接口 │
|
||
│ ├── ws WebSocket 接口 │
|
||
│ ├── ws_handler WebSocket 处理器 │
|
||
│ ├── ws_types WebSocket 类型 │
|
||
│ └── ws_universal 通用 WebSocket 接口 │
|
||
│ │
|
||
│ pull_request/ PR 路由 (5 文件) │
|
||
│ ├── merge 合并接口 │
|
||
│ ├── pull_request PR CRUD 接口 │
|
||
│ ├── review 审查接口 │
|
||
│ ├── review_comment 审查评论接口 │
|
||
│ └── review_request 审查请求接口 │
|
||
│ │
|
||
│ agent/ AI Agent 路由 (8 文件) │
|
||
│ ├── code_review 代码审查接口 │
|
||
│ ├── model 模型接口 │
|
||
│ ├── model_ 模型能力接口 │
|
||
│ │ capability │
|
||
│ ├── model_ 模型参数配置接口 │
|
||
│ │ parameter_profile │
|
||
│ ├── model_pricing 模型定价接口 │
|
||
│ ├── model_version 模型版本接口 │
|
||
│ ├── pr_summary PR 摘要接口 │
|
||
│ └── provider 模型提供商接口 │
|
||
│ │
|
||
│ user/ 用户路由 (10 文件) │
|
||
│ ├── access_key 访问密钥接口 │
|
||
│ ├── chpc CHPC 接口 │
|
||
│ ├── notification 通知接口 │
|
||
│ ├── preferences 偏好接口 │
|
||
│ ├── profile 资料接口 │
|
||
│ ├── projects 项目接口 │
|
||
│ ├── repository 仓库接口 │
|
||
│ ├── ssh_key SSH 密钥接口 │
|
||
│ ├── subscribe 订阅接口 │
|
||
│ └── user_info 用户信息接口 │
|
||
│ │
|
||
│ openapi/ OpenAPI 文档生成 │
|
||
│ route/ 路由聚合 │
|
||
│ error/ API 错误处理 │
|
||
└─────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 服务间通信机制
|
||
|
||
```
|
||
┌────────────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 服务间通信机制 │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ Redis (核心通信总线) │ │
|
||
│ │ │ │
|
||
│ │ Redis Streams ──▶ 异步消息队列 │ │
|
||
│ │ ├── room:stream:{room_id} 房间消息持久化 │ │
|
||
│ │ └── email:stream 邮件发送队列 │ │
|
||
│ │ │ │
|
||
│ │ Redis Pub/Sub ──▶ 实时事件广播 │ │
|
||
│ │ ├── room:pub:{room_id} 房间级广播 │ │
|
||
│ │ └── project:pub:{proj_id} 项目级广播 │ │
|
||
│ │ │ │
|
||
│ │ Redis Lists ──▶ 任务队列 │ │
|
||
│ │ ├── {hook}:sync Git Hook 同步任务 │ │
|
||
│ │ ├── {hook}:fsck Git Hook 完整性检查 │ │
|
||
│ │ └── {hook}:gc Git Hook 垃圾回收 │ │
|
||
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ HTTP/REST API ──▶ 同步服务调用 │ │
|
||
│ │ ├── app ↔ gitserver Git 元数据查询 │ │
|
||
│ │ └── app → 外部 AI 服务 OpenAI 兼容 API 调用 │ │
|
||
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ WebSocket ──▶ 客户端实时通信 │ │
|
||
│ │ ├── /ws 通用 WebSocket (多房间订阅) │ │
|
||
│ │ ├── /ws/rooms/{room_id} 房间级 WebSocket │ │
|
||
│ │ └── /ws/projects/{proj_id} 项目级 WebSocket │ │
|
||
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
|
||
│ │ Kubernetes CRD + Operator ──▶ 基础设施编排 │ │
|
||
│ │ ├── apps.code.dev App CRD → Deployment + Service │ │
|
||
│ │ ├── gitservers.code.dev GitServer CRD → Deployment + Service + PVC │ │
|
||
│ │ ├── emailworkers.code.dev EmailWorker CRD → Deployment │ │
|
||
│ │ ├── githooks.code.dev GitHook CRD → Deployment + ConfigMap │ │
|
||
│ │ └── migrates.code.dev Migrate CRD → Job │ │
|
||
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
|
||
└────────────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 数据流详解
|
||
|
||
### 1. 聊天消息流程
|
||
|
||
```
|
||
客户端 A app 实例 1 Redis app 实例 2 客户端 B
|
||
│ │ │ │ │
|
||
│── WS 发送消息 ───────▶│ │ │ │
|
||
│ │── XADD ──────────────▶│ │ │
|
||
│ │ room:stream:{id} │ │ │
|
||
│ │── PUBLISH ────────────▶│ │ │
|
||
│ │ room:pub:{id} │ │ │
|
||
│ │ │── 事件通知 ────────────▶│ │
|
||
│ │ │ │── WS 推送 ────────────▶│
|
||
│◀─ ACK ───────────────│ │ │ │
|
||
│ │ │ │ │
|
||
│ │◀──── XREADGROUP ─────│ │ │
|
||
│ │ (room_worker) │ │ │
|
||
│ │── 写入 PostgreSQL ────│ │ │
|
||
```
|
||
|
||
### 2. Git Push 流程
|
||
|
||
```
|
||
客户端 gitserver Redis git-hook PostgreSQL
|
||
│ │ │ │ │
|
||
│── git push ────────▶│ │ │ │
|
||
│ (HTTP/SSH) │ │ │ │
|
||
│ │── git-receive-pack──▶│ │ │
|
||
│ │── LPUSH ────────────▶│ │ │
|
||
│ │ {hook}:sync │ │ │
|
||
│◀─ ACK ─────────────│ │ │ │
|
||
│ │ │── BRPOPLPUSH ─────▶│ │
|
||
│ │ │ │── 同步元数据 ────────▶│
|
||
│ │ │ │── 可选: fsck/gc ─────▶│
|
||
│ │ │◀── XACK ──────────│ │
|
||
```
|
||
|
||
### 3. 邮件发送流程
|
||
|
||
```
|
||
业务逻辑 app Redis email-worker SMTP
|
||
│ │ │ │ │
|
||
│── 触发邮件 ────────▶│ │ │ │
|
||
│ │── XADD ───────────▶│ │ │
|
||
│ │ email:stream │ │ │
|
||
│◀─ 返回 ───────────│ │ │ │
|
||
│ │ │── XREADGROUP ─────▶│ │
|
||
│ │ │ │── 渲染模板 ──────────▶│
|
||
│ │ │ │── SMTP 发送 ─────────▶│
|
||
│ │ │◀── XACK ──────────│ │
|
||
```
|
||
|
||
### 4. AI 聊天流程
|
||
|
||
```
|
||
客户端 app OpenAI API Qdrant PostgreSQL
|
||
│ │ │ │ │
|
||
│── AI 消息 ──────────▶│ │ │ │
|
||
│ │── 生成 Embedding ──▶│ │ │
|
||
│ │◀──── 向量 ──────────│ │ │
|
||
│ │── 存储向量 ─────────────────────────────▶│ │
|
||
│ │── 流式 Chat ─────────▶│ │ │
|
||
│◀─ Stream Chunk ──────│◀──── Stream ─────────│ │ │
|
||
│ │ │ │ │
|
||
│ │── 保存消息 ────────────────────────────────────────────────▶│
|
||
│ │── 检索相似消息 ────────────────────────▶│ │
|
||
│ │◀── 相似结果 ───────────────────────────│ │
|
||
```
|
||
|
||
---
|
||
|
||
## 技术栈汇总
|
||
|
||
### 后端技术栈
|
||
|
||
| 类别 | 技术 | 版本 |
|
||
|------|------|------|
|
||
| **语言** | Rust | Edition 2024 |
|
||
| **Web 框架** | Actix-web | 4.13.0 |
|
||
| **WebSocket** | Actix-ws | 0.4.0 |
|
||
| **ORM** | SeaORM | 2.0.0-rc.37 |
|
||
| **数据库** | PostgreSQL | - |
|
||
| **缓存/消息** | Redis | 1.1.0 |
|
||
| **向量库** | Qdrant | 1.17.0 |
|
||
| **Git** | git2 / russh | 0.20.0 / 0.55.0 |
|
||
| **邮件** | Lettre | 0.11.19 |
|
||
| **AI** | async-openai | 0.34.0 |
|
||
| **K8s** | kube-rs | 0.98 |
|
||
| **gRPC** | Tonic | 0.14.5 |
|
||
| **日志** | slog / tracing | 2.8 / 0.1.44 |
|
||
|
||
### 前端技术栈
|
||
|
||
| 类别 | 技术 | 版本 |
|
||
|------|------|------|
|
||
| **语言** | TypeScript | 5.9 |
|
||
| **框架** | React | 19.2 |
|
||
| **路由** | React Router | 7.13 |
|
||
| **构建** | Vite + SWC | 8.0 |
|
||
| **UI** | shadcn/ui + Tailwind | 4.11 / 4.2 |
|
||
| **状态** | TanStack Query | 5.96 |
|
||
| **HTTP** | Axios + OpenAPI 生成 | 1.7 |
|
||
| **Markdown** | react-markdown + Shiki | 10 / 1 |
|
||
| **拖拽** | dnd-kit | 6.3 |
|
||
|
||
---
|
||
|
||
## Docker 与 K8s 部署
|
||
|
||
```
|
||
┌──────────────────────────────────────────────────────────────────────────────┐
|
||
│ Docker 镜像 (6 个) │
|
||
│ │
|
||
│ docker/app.Dockerfile ──▶ apps/app 主应用镜像 │
|
||
│ docker/email-worker.Dockerfile ──▶ apps/email 邮件 Worker 镜像 │
|
||
│ docker/git-hook.Dockerfile ──▶ apps/git-hook Git Hook 镜像 │
|
||
│ docker/gitserver.Dockerfile ──▶ apps/gitserver Git Server 镜像 │
|
||
│ docker/migrate.Dockerfile ──▶ apps/migrate 数据库迁移镜像 │
|
||
│ docker/operator.Dockerfile ──▶ apps/operator K8s Operator 镜像 │
|
||
└──────────────────────────────────────────────────────────────────────────────┘
|
||
|
||
┌──────────────────────────────────────────────────────────────────────────────┐
|
||
│ Kubernetes CRD (5 个) │
|
||
│ │
|
||
│ docker/crd/app-crd.yaml ──▶ apps.code.dev │
|
||
│ docker/crd/gitserver-crd.yaml ──▶ gitservers.code.dev │
|
||
│ docker/crd/email-worker-crd.yaml ──▶ emailworkers.code.dev │
|
||
│ docker/crd/git-hook-crd.yaml ──▶ githooks.code.dev │
|
||
│ docker/crd/migrate-crd.yaml ──▶ migrates.code.dev │
|
||
└──────────────────────────────────────────────────────────────────────────────┘
|
||
|
||
┌──────────────────────────────────────────────────────────────────────────────┐
|
||
│ K8s 部署配置 │
|
||
│ │
|
||
│ docker/operator/deployment.yaml ──▶ Operator Deployment │
|
||
│ docker/operator/example/ ──▶ CRD 使用示例 │
|
||
│ code-system.yaml │
|
||
└──────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 关键设计特点
|
||
|
||
| 特点 | 描述 |
|
||
|------|------|
|
||
| **Monorepo 架构** | Rust workspace + 前端 monorepo，统一管理 |
|
||
| **清晰分层** | 路由层 → 业务层 → 基础设施层 → 存储层，职责明确 |
|
||
| **异步优先** | 基于 Redis Streams 的异步消息处理 |
|
||
| **实时通信** | WebSocket + Redis Pub/Sub 实现多实例同步 |
|
||
| **K8s 原生** | Operator + 5 个 CRD 管理全生命周期 |
|
||
| **类型安全** | OpenAPI 自动生成 TypeScript 客户端 |
|
||
| **可扩展** | 服务独立部署，水平扩展 |
|
||
| **Git 兼容** | 完整支持 HTTP/SSH Git 协议 + LFS |
|
||
| **AI 集成** | 原生集成 OpenAI 兼容 API + 向量检索 |
|
||
| **92 个数据库实体** | 覆盖用户、项目、仓库、Issue、PR、聊天室、AI 等完整业务域 |
|