skillhub/document/docs/04-developer/architecture/overview.md
tww 3e2f25a42f feat(docs): initialize Docusaurus documentation website
- Initialize Docusaurus project structure
- Add Chinese documentation (all sections)
- Add English documentation (getting started section)
- Custom iFlytek blue theme styling
- Enterprise value focused homepage design
2026-03-15 18:27:32 +08:00

1.6 KiB

title sidebar_position description
系统架构 1 SkillHub 系统架构概览

系统架构

架构原则

  • 单体优先:一期采用模块化单体,不拆微服务
  • 依赖倒置:领域层不依赖基础设施
  • 可替换边界:搜索、存储都有 SPI 抽象

模块结构

server/
├── skillhub-app/          # 启动、配置装配、Controller
├── skillhub-domain/       # 领域模型 + 领域服务 + 应用服务
├── skillhub-auth/         # OAuth2 认证 + RBAC + 授权判定
├── skillhub-search/       # 搜索 SPI + PostgreSQL 全文实现
├── skillhub-storage/      # 对象存储抽象 + LocalFile/S3
└── skillhub-infra/        # JPA、通用工具、配置基础

模块依赖

app → domain, auth, search, storage, infra
infra → domain
auth → domain
search → domain
storage → (独立)

技术栈

层级 技术 版本
运行时 Java 21
框架 Spring Boot 3.2.3
数据库 PostgreSQL 16.x
缓存/会话 Redis 7.x

部署架构

┌──────────────┐
│ Browser / CLI│
└──────┬───────┘
       │
       ▼
┌──────────────┐
│  Web/Nginx   │
└──────┬───────┘
       │ /api/*
       ▼
┌──────────────┐
│ Spring Boot  │
└───┬────┬─────┘
    │    │
    ▼    ▼
PostgreSQL  Redis

下一步