124 lines
2.7 KiB
Markdown
124 lines
2.7 KiB
Markdown
# 系统架构
|
||
|
||
**文档版本**: 1.0.0
|
||
**最后更新**: 2026-04-19
|
||
**维护者**: 项目开发团队
|
||
|
||
---
|
||
|
||
## 1. 系统架构图
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
subgraph Client["客户端"]
|
||
direction TB
|
||
C_UI["UI 渲染层"]
|
||
C_Svc["Service 层"]
|
||
C_Data["Data 层 (SQLite + FS)"]
|
||
C_UI -->|"HTTPS (localhost)"| C_Svc
|
||
C_Svc --> C_Data
|
||
end
|
||
|
||
subgraph Server["服务端 (Docker)"]
|
||
direction TB
|
||
S_API["REST API 层"]
|
||
S_Biz["业务逻辑层"]
|
||
S_Data["Data 层 (SQLite)"]
|
||
S_API --> S_Biz
|
||
S_Biz --> S_Data
|
||
end
|
||
|
||
Client -->|"HTTPS"| Server
|
||
```
|
||
|
||
**架构说明**：
|
||
- 客户端采用三层分离架构（UI 渲染层、Service 层、Data 层）
|
||
- 客户端与服务端之间通过 HTTPS 进行通信
|
||
- 服务端运行在 Docker 容器中，提供 REST API
|
||
|
||
---
|
||
|
||
## 2. 技术架构摘要
|
||
|
||
### 2.1 客户端架构
|
||
|
||
| 层次 | 职责 | 技术栈 | 通信方式 |
|
||
|------|------|--------|----------|
|
||
| **UI 渲染层** | 用户界面、交互逻辑、状态管理 | <!-- 填写 --> | HTTPS 调用 Service 层 |
|
||
| **Service 层** | 业务逻辑、数据处理 | <!-- 填写 --> | 读写 Data 层 |
|
||
| **Data 层** | 本地存储 | SQLite、文件系统 | -- |
|
||
|
||
### 2.2 服务端架构
|
||
|
||
| 层次 | 职责 |
|
||
|------|------|
|
||
| **REST API 层** | 请求路由、认证授权 |
|
||
| **业务逻辑层** | <!-- 填写 --> |
|
||
| **Data 层** | SQLite 存储 |
|
||
|
||
---
|
||
|
||
## 3. 数据流
|
||
|
||
### 3.1 数据流图
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
subgraph 数据操作
|
||
A1["UI: 用户输入"] -->|"HTTPS"| A2["Service: 处理数据"]
|
||
A2 --> A3["SQLite: 存储数据"]
|
||
end
|
||
```
|
||
|
||
### 3.2 数据流规范
|
||
|
||
| 流程 | 数据流 | 说明 |
|
||
|------|--------|------|
|
||
| <!-- 操作1 --> | <!-- 数据流 --> | <!-- 说明 --> |
|
||
| <!-- 操作2 --> | <!-- 数据流 --> | <!-- 说明 --> |
|
||
|
||
---
|
||
|
||
## 4. 部署架构
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
subgraph Server["服务器"]
|
||
Docker["Docker Engine"]
|
||
Container["应用容器"]
|
||
Docker --> Container
|
||
end
|
||
|
||
subgraph Client["客户端"]
|
||
App["客户端应用"]
|
||
LocalDB["本地数据库"]
|
||
App --> LocalDB
|
||
end
|
||
|
||
Client -->|"HTTPS"| Server
|
||
```
|
||
|
||
### 4.1 部署约束
|
||
|
||
| 组件 | 平台 | 容器化 |
|
||
|------|------|--------|
|
||
| 服务端 | <!-- 填写 --> | Docker 容器 |
|
||
| 客户端 | <!-- 填写 --> | 原生应用 |
|
||
| 数据库 | SQLite 3.45+ | 嵌入式 |
|
||
|
||
---
|
||
|
||
## 5. 模块划分
|
||
|
||
| 模块 | 职责 | 技术栈 |
|
||
|------|------|--------|
|
||
| <!-- 模块1 --> | <!-- 职责 --> | <!-- 技术 --> |
|
||
| <!-- 模块2 --> | <!-- 职责 --> | <!-- 技术 --> |
|
||
|
||
**模块独立性**：各模块完全独立开发，不共享代码包，仅通过 REST API 通信。
|
||
|
||
---
|
||
|
||
**版本历史**:
|
||
- v1.0.0 (2026-04-19): 初始化模板
|