# 系统架构

**文档版本**: 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): 初始化模板