系统架构设计

内部文档 本文档包含系统架构的详细信息，仅供内部使用。 :::

整体架构

┌─────────────────────────────────────────────────────────┐
│                    Nginx 反向代理                        │
├─────────────────────────────────────────────────────────┤
│  Docusaurus 前端 (3000)  │  Express API 后端 (4000)     │
│  - 文档展示               │  - 用户认证                  │
│  - 主题样式               │  - 权限校验                  │
│  - 登录组件               │  - RAG API（后续）           │
└─────────────────────────────────────────────────────────┘

技术栈

前端

• Docusaurus 3.x：静态站点生成器

• React 18：UI 框架

• TypeScript：类型安全

后端

• Express.js：Web 框架

• JWT：身份认证

• Node.js：运行时环境

认证流程

用户登录 → 后端验证 → 生成 JWT → 返回 Token
                                     ↓
前端存储 Token → 每次请求携带 → 后端验证 → 返回数据

权限模型

文档权限标记

---
access: public    # 公开文档
---

---
access: internal  # 内部文档
---

权限判断逻辑

function checkAccess(doc: Doc, user: User | null): boolean {
  if (doc.access === 'public') return true;
  return user !== null && user.isAuthenticated;
}

部署架构

Docker Compose

services:
  frontend:
    build: .
    ports:
      - "3000:3000"

  backend:
    build: ./server
    ports:
      - "4000:4000"

扩展计划

• RAG 问答功能

• 向量数据库集成

• 多模型 LLM 支持