系统架构
本文档介绍 Aurisper 知识库的技术架构和工作原理。
一、整体架构图
┌─────────────────────────────────────────────────────────────────┐
│ 用户访问流程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 用户浏览器 │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Cloudflare Access │ │
│ │ (身份验证 - 邮箱验证码) │ │
│ └─────────────────────────────────────────┘ │
│ │ 验证通过 │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Cloudflare CDN │ │
│ │ (全球加速 - 静态资源分发) │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Cloudflare Pages │ │
│ │ (静态网站托管) │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 内容更新流程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 本地编辑 Markdown │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Git Push │ │
│ │ (推送到 GitHub 私有仓库) │ │
│ └─────────────────────────────────────────┘ │
│ │ 触发 Webhook │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Cloudflare Pages Build │ │
│ │ (自动拉取代码 + 构建) │ │
│ └─────────────────────────────────────────┘ │
│ │ 构建完成 │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ 自动部署到 CDN │ │
│ │ (全球节点同步 - 约2-3分钟) │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
二、技术栈
| 组件 | 技术 | 说明 |
|---|---|---|
| 静态生成器 | Docusaurus 3.x | Facebook 开源，React 驱动 |
| 托管平台 | Cloudflare Pages | 免费静态托管，全球 CDN |
| 访问控制 | Cloudflare Access | Zero Trust 安全网关 |
| 代码仓库 | GitHub (Private) | 私有仓库，版本控制 |
| 域名 | doc.aurisper.com | Cloudflare DNS 管理 |
三、目录结构
aurisper-doc/
├── docs/ # 📄 Markdown 文档（核心内容）
│ ├── intro.md # 首页
│ ├── guide/ # 使用指南
│ ├── product/ # 产品文档
│ ├── tech/ # 技术文档
│ └── meeting/ # 会议纪要
│
├── static/ # 📁 静态资源（原样复制到网站）
│ ├── img/ # 图片
│ ├── pdf/ # PDF 文档
│ └── html/ # HTML 页面
│
├── src/ # 🎨 自定义组件和样式
│ ├── css/
│ │ └── custom.css # 自定义 CSS
│ └── pages/ # 自定义页面
│
├── docusaurus.config.js # ⚙️ 站点配置
├── sidebars.js # 📑 侧边栏配置
└── package.json # 📦 依赖管理
四、数据存储
存储位置
| 数据类型 | 存储位置 | 备份策略 |
|---|---|---|
| Markdown 文档 | GitHub 仓库 | Git 版本历史 |
| 图片/PDF/HTML | GitHub 仓库 /static/ | Git 版本历史 |
| 构建产物 | Cloudflare Pages | 自动管理 |
为什么不需要数据库？
Docusaurus 是静态站点生成器：
- 构建时读取所有 Markdown 文件
- 生成纯 HTML/CSS/JS 静态文件
- 访问时无需查询数据库
- 速度极快，安全性高
五、安全机制
Cloudflare Access 保护
访问 doc.aurisper.com
│
▼
┌───────────────────┐
│ Cloudflare Access │
│ 检查登录状态 │
└───────────────────┘
│
┌────┴────┐
│ │
未登录 已登录
│ │
▼ ▼
显示登录页 放行访问
(邮箱验证) 网站内容
安全特性
- ✅ 仅允许指定邮箱域名访问
- ✅ 验证码有效期 5 分钟
- ✅ 登录状态保持 24 小时
- ✅ 源代码在私有仓库，外部不可见
- ✅ HTTPS 加密传输
六、与 DevOS 的关系
┌─────────────────────────────────────────────────────────────┐
│ aurisper.com 域名 │
├────────────────────────┬────────────────────────────────────┤
│ doc.aurisper.com │ aurisper-devos.pages.dev │
│ ┌────────────────┐ │ ┌────────────────────────────┐ │
│ │ Docusaurus │ │ │ Aurisper DevOS │ │
│ │ 静态知识库 │ │ │ 动态管理系统 │ │
│ │ │ │ │ │ │
│ │ • 只读文档展示 │ │ │ • 用户登录/权限 │ │
│ │ • Git 更新 │ │ │ • 在线编辑文档 │ │
│ │ • 无数据库 │ │ │ • 任务/模块管理 │ │
│ │ │ │ │ • AI 分析 │ │
│ └────────────────┘ │ │ • Supabase 数据库 │ │
│ ↑ │ └────────────────────────────┘ │
│ GitHub 仓库 │ ↑ │
│ (Markdown/PDF) │ Supabase │
│ │ (动态数据) │
└────────────────────────┴────────────────────────────────────┘
两个系统完全独立：
- 知识库：适合发布稳定的、只读的文档
- DevOS：适合需要在线编辑、协作的动态内容
七、成本说明
| 服务 | 费用 | 限制 |
|---|---|---|
| Cloudflare Pages | 免费 | 500 次构建/月，无限带宽 |
| Cloudflare Access | 免费 | 50 用户以内 |
| GitHub 私有仓库 | 免费 | 无限制 |
| 总计 | $0/月 | - |