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

69 lines
1.6 KiB
Markdown

---
title: 系统架构
sidebar_position: 1
description: 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
```
## 下一步
- [领域模型](./domain-model) - 核心实体