team/docs/07-系统架构.md

系统架构

文档版本: 1.0.0 最后更新: 2026-04-19 维护者: 项目开发团队

---

1. 系统架构图

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 数据流图

flowchart TB
    subgraph 数据操作
        A1["UI: 用户输入"] -->|"HTTPS"| A2["Service: 处理数据"]
        A2 --> A3["SQLite: 存储数据"]
    end

3.2 数据流规范

流程	数据流	说明

---

4. 部署架构

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. 模块划分

模块	职责	技术栈

模块独立性：各模块完全独立开发，不共享代码包，仅通过 REST API 通信。

---

版本历史:

• v1.0.0 (2026-04-19): 初始化模板