# matrix-datagox

**Repository Path**: sk_apt/matrix-datagox

## Basic Information

- **Project Name**: matrix-datagox
- **Description**: Matrix-DataGoX 是一个基于 Go + Vue3 的企业级通用管理平台，提供完整的权限管理、数据字典、系统配置等核心功能，支持国际化、数据权限控制。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align=center><img src="appendix/logo.svg" width="400" height="100"  alt="Matrix-DataGoX"/></div>

## 简介

`Matrix-DataGoX` 是一个基于 Go + Vue3 的企业级通用管理平台，提供完整的权限管理、数据字典、系统配置等核心功能，支持国际化、数据权限控制。

## 关于Matrix-DataGoX

- ✅**寓意**：Matrix（矩阵），象征数据的有序管理与高效流转
- ✅**理念**：开放、高效、可靠、可扩展
- ✅**原则**：最小依赖可运行；模块化设计；

***

## 整体架构

```mermaid
flowchart TD
    subgraph 前端
        Vue[Vue 3 + TypeScript]
        Element[Element Plus]
        Pinia[Pinia状态管理]
        VueRouter[Vue Router]
    end

    subgraph 后端
        Gin[Gin Web Framework]
        JWT[JWT认证]
        Zap[Zap日志]
        Redis[Redis缓存]
    end

    subgraph 数据库
        MySQL[(MySQL)]
    end

    Vue --> Gin
    Element --> Vue
    Pinia --> Vue
    VueRouter --> Vue
    Gin --> MySQL
    Gin --> Redis
    JWT --> Gin
    Zap --> Gin
```

**架构说明：**

| 层级      | 职责说明                                           |
|---------|------------------------------------------------|
| **前端**  | Vue3 + TypeScript 构建的现代化前端界面，集成Element Plus组件库 |
| **后端**  | Go + Gin 构建的高性能API服务，包含认证、日志、缓存等核心模块           |
| **数据库** | MySQL 负责数据持久化，Redis 用于缓存和会话管理                  |

***

## 核心技术栈

| 分类         | 技术           | 版本    | 用途               |
|------------|--------------|-------|------------------|
| **后端语言**   | Go           | 1.21+ | 核心开发语言，高性能并发支持   |
| **HTTP框架** | Gin          | 1.9+  | RESTful API 服务框架 |
| **前端框架**   | Vue          | 3.4+  | 前端UI框架           |
| **前端语言**   | TypeScript   | 5.4+  | 类型安全的JavaScript  |
| **组件库**    | Element Plus | 2.6+  | 企业级UI组件库         |
| **关系型数据库** | MySQL        | 8.0+  | 数据持久化存储          |
| **分布式缓存**  | Redis        | 7.0+  | 缓存和会话管理          |
| **日志系统**   | Zap          | -     | 高性能结构化日志         |
| **API文档**  | Swagger      | -     | 自动API文档生成        |

### 技术特性

- **前后端分离**：前端Vue3 + 后端Go，通过RESTful API通信
- **JWT认证**：无状态的JSON Web Token认证机制
- **RBAC权限**：基于角色的访问控制，支持细粒度权限管理
- **数据权限**：支持按组织或角色的数据范围控制
- **国际化**：支持中英文切换，内置i18n支持
- **响应式布局**：适配桌面端和移动端
- **代码生成**：支持Swagger自动生成API文档

***

## 核心功能

### 一、用户管理

| 功能       | 说明            |
|----------|---------------|
| **用户列表** | 分页查询、条件筛选用户列表 |
| **用户详情** | 查看单个用户详细信息    |
| **创建用户** | 创建新用户并分配角色和组织 |
| **编辑用户** | 修改用户基本信息      |
| **删除用户** | 逻辑删除用户        |
| **密码修改** | 用户自主修改密码      |

### 二、角色管理

| 功能       | 说明         |
|----------|------------|
| **角色列表** | 分页查询角色列表   |
| **角色详情** | 查看角色详细信息   |
| **创建角色** | 创建新角色      |
| **编辑角色** | 修改角色信息     |
| **删除角色** | 删除角色       |
| **菜单分配** | 为角色分配菜单权限  |
| **数据权限** | 配置角色数据访问范围 |

### 三、菜单管理

| 功能       | 说明          |
|----------|-------------|
| **菜单列表** | 分页查询菜单列表    |
| **菜单树**  | 树形展示菜单结构    |
| **创建菜单** | 创建新菜单节点     |
| **编辑菜单** | 修改菜单信息      |
| **删除菜单** | 删除菜单        |
| **权限标识** | 配置菜单对应的权限编码 |

### 四、组织管理

| 功能       | 说明         |
|----------|------------|
| **组织列表** | 分页查询组织列表   |
| **组织树**  | 树形展示组织层级结构 |
| **创建组织** | 创建新组织节点    |
| **编辑组织** | 修改组织信息     |
| **删除组织** | 删除组织       |

### 五、日志管理

| 功能       | 说明                |
|----------|-------------------|
| **登录日志** | 记录用户登录行为，支持时间范围筛选 |
| **操作日志** | 记录用户操作行为，支持关键字搜索  |

### 六、系统配置

| 功能       | 说明        |
|----------|-----------|
| **配置列表** | 分页查询系统配置  |
| **配置详情** | 查看配置详细信息  |
| **创建配置** | 添加新的系统配置项 |
| **编辑配置** | 修改配置值     |
| **删除配置** | 删除配置项     |

### 七、数据字典

| 功能       | 说明            |
|----------|---------------|
| **字典类型** | 管理字典分类        |
| **字典数据** | 管理字典具体值       |
| **缓存机制** | 字典数据缓存，提升访问性能 |

### 八、附件管理

| 功能       | 说明        |
|----------|-----------|
| **附件列表** | 分页查询附件列表  |
| **附件上传** | 支持分片上传大文件 |
| **附件下载** | 下载附件文件    |
| **附件删除** | 删除附件      |

### 九、定时任务

| 功能       | 说明               |
|----------|------------------|
| **任务列表** | 分页查询定时任务列表       |
| **任务详情** | 查看任务详细配置         |
| **创建任务** | 创建定时任务，支持Cron表达式 |
| **编辑任务** | 修改任务配置和执行策略      |
| **删除任务** | 删除定时任务           |
| **暂停任务** | 暂停运行的任务          |
| **恢复任务** | 恢复暂停的任务          |
| **立即执行** | 手动触发任务立即执行       |
| **执行日志** | 查看任务执行历史记录       |

### 十、系统监控

| 功能          | 说明            |
|-------------|---------------|
| **健康检查**    | 检查服务运行状态      |
| **系统指标**    | CPU、内存、磁盘使用情况 |
| **数据库指标**   | 数据库连接池状态      |
| **Redis指标** | Redis连接状态     |

***