# QtAdmin

**Repository Path**: lo-ferris/qt-admin

## Basic Information

- **Project Name**: QtAdmin
- **Description**: 这是一个基于 **Qt5 + QML** 开发的桌面版信息管理框架，具有以下核心特性：
1. **现代化UI**：集成开源 **FluentUI** 框架提供微软风格界面
2. **国密安全**：通过 **GmSSL** 库支持国密算法(SM2/SM3/SM4)
3. **模块化设计**：采用分层架构，便于功能扩展和维护
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-26
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 信息管理框架简要说明

## 项目概述

1. 这是一个基于 **Qt5 + QML** 开发的桌面版信息管理框架，具有以下核心特性：

   1. **现代化UI**：集成开源 **FluentUI** 框架提供微软风格界面
   2. **国密安全**：通过 **GmSSL** 库支持国密算法(SM2/SM3/SM4)
   3. **模块化设计**：采用分层架构，便于功能扩展和维护

## 环境要求

- **操作系统**：Windows 10/11, Linux (Ubuntu 20.04+), macOS (Big Sur+)
- **Qt版本**：Qt 5.15.x 或更高
- **编译器**：
  - Windows: MSVC 2019 或 MinGW 8.1+
  - Linux: GCC 9+
  - macOS: Clang 12+

## 依赖库安装

### 1. FluentUI 编译安装

```
# 克隆仓库
git clone https://github.com/zhuzichu520/FluentUI.git
```

### 2. GmSSL 集成（位于 thirdparty 目录）

```
# 在项目根目录执行
git submodule add https://github.com/guanzhi/GmSSL.git thirdparty/GmSSL

# 编译 GmSSL
cd thirdparty/GmSSL
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=../install
make -j$(nproc)
make install
```

## 项目结构

```
.
├── CMakeLists.txt             # 主构建文件
├── src/                       # 主程序源码
│   ├── main.cpp               # 程序入口
│   ├── global				   # 全局常量
│   ├── helper				   # 辅助工具层
│   ├── entity				   # 实体对象
│   ├── dao				       # 数据访问层
│   ├── service  		       # 业务层
│   └── singleton.h            # 单例模板
├── qml/                       # QML界面文件
│   ├── App.qml                # 系统入口窗体
│   ├── MainWindow.qml         # 主窗体

├── res/                       # 资源文件
│   ├── icon/                  # 图标资源
│   └── image/                 # 图片资源
└── thirdparty/                # 第三方库
    ├── GmSSL/                 # 国密库源码

```

##  代码贡献

欢迎热心开源的小伙伴为本项目做贡献！

如何贡献

1、fork一份代码至自己的账号下，本地修改您要提的代码，提交至您fork的仓库

2、登录gitee后到本项目仓库下创建Pull Requests,选择您的仓库到dev分支，提交即可

因为dev分支是团队开发分支，并不是统一发版本的测试过的，所以我们建议提代码至dev即可