# ZG-ADMIN

**Repository Path**: Getawy/zg-admin

## Basic Information

- **Project Name**: ZG-ADMIN
- **Description**: 止戈建站前后端分离版本，此包含基本后端和前台。用户端后端采用Spring Boot、Spring Security、Redis、Thymeleaf。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 24
- **Forks**: 22
- **Created**: 2023-01-02
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 止戈内容管理Vue3, SpringSecurity, MyBatis, SpringBoot, 止戈内容管理系统后端

## README

<h4 align="center">基于SpringBoot+Vue3的内容管理系统</h4>

## 系统说明

本系统基于若依前后端分离二次开发的内容管理系统，为了更好管理后台，引入配置组，同时通过配置组方式可视化管理后台。
在原有基础添加如下功能：

* 动态资源权限加载可选配置，字典
* 扩展储存，储存方面统一接口，文件可视化管理，方便后续的维护以及扩展。
* 邮件扩展，邮件支持在线配置，发送，支持多种类型邮件发送，支持定时发送。
* 用户端后端采用Spring Boot、Spring Security、Redis、Thymeleaf。
* 多站点，支持后台统一站点管理多站点，一个站点可运行多个网站（主题）
* 用户展示方面，支持按需打包。
* 栏目，前端菜单管理，支持多级树，可以应付复杂的导航，已支持额外SEO字段。
* 分类，支持多级树，完全可以应付复杂分类，同时支持多种不同分类标识，已支持额外SEO字段。
* 文章，支持不同类型，特色推荐，多关键字的文章发布，支持额外SEO字段。
* 链接，支持多级树，方便做导航类网站。
* 文章，包含评论，浏览记录，评分，收藏等。
* 反馈， 支持不同类型反馈。

## 结构说明

```
ZG-ADMIN
├─bin             # 脚本工具目录
├─docs            # 文档目录
├─grace-admin     # 后台启动入口
├─grace-common    # 通用部分
├─grace-flyway    # 管理数据库
├─grace-framework # 框架核心
├─grace-generator # 代码生成
├─grace-mybatis   # 操作数据库
├─grace-oly       # 内容模块聚合
│  └─oly-cms      # 内容系统
│      ├─cms-admin     # 内容管理后台
│      ├─cms-common    # 内容通用工具
│      ├─cms-general   # 内容通用组件
│      ├─cms-forum     # 多用户模块
│         ├─forum-comment  # 评论系统  
│         ├─forum-record   # 操作记录
│         ├─forum-user     # 用户相关
│         └─forum-web      # 多用户网站启动
│      ├─cms-query    # 通用操作查询mapper
│      └─cms-single   # 无用户站点模块
├─grace-quartz  # 定时任务
├─grace-redis   # redis缓存
├─grace-server  # 系统服务
│  ├─server-mail       # 邮件服务
│  └─server-storage    # 存储服务
├─grace-system  # 系统访问
│  ├─system-core      # 系统核心代码
│  ├─system-current   # 通用部分
│  └─system-user      # 用户相关
├─pom.xml       # Maven主配置
├─ry.bat        # 运行脚本（Windows）
├─ry.sh         # 运行脚本（Linux）
└─sql           # 数据库脚本
```

## 应用场景

* 个人网站
* 企业官网
* 论坛社区
* 小程序后端
* 内容管理平台

## 主题开发

系统支持自定义主题开发，需要具备基础的Thymeleaf语法知识。主题支持动态配置，提供丰富的定制选项，可玩性较强。主题文件可通过后台进行管理和切换。

## 系统启动

- 启动前准备：请确保已安装并配置Redis和MySQL数据库
- 前端部分：管理前端代码位于独立仓库 [zg-vue3](https://gitee.com/Getawy/zg-vue3)
- 后端服务启动：
  - 管理后台：运行 grace-admin 模块下的 GraceApplication.java
  - 用户端站点：
    - 单站点模式：运行 cms-single 模块下的 SingleWebApplication.java
    - 多用户论坛模式：运行 forum-web 模块下的 ForumWebApplication.java
- 主题资源：示例主题可从 [示例主题仓库](https://gitee.com/Getawy/themes) 下载

## 配置说明

系统支持开箱即用，配置文件加载优先级如下：

1. 执行命令目录下的 config 文件夹
2. JAR包同级目录
3. classpath 下的 config 文件夹
4. classpath 根目录

核心配置示例：

```yaml
grace:
  # 系统名称
  name: Grace
  # 系统版本
  version: 3.8.4
  # 版权年份
  copyrightYear: 2022
  # 服务工作目录
  workServerDir: ${user.home}/.tzg/server/${grace.onlyCode}
  # 本地存储工作目录
  workStorageDir: ${user.home}/.tzg/storage
  # IP地址获取开关
  addressEnabled: false
  # 验证码类型 math(数字计算) 或 char(字符验证)
  captchaType: math
  # 站点唯一编码
  onlyCode: admin
```

## 存储说明

系统支持多种存储方式，使用统一的存储接口。当使用本地存储时，请注意：如果管理后台和用户网站部署在不同服务器上，需要确保两个服务使用相同的工作目录路径，否则用户网站可能无法正确读取文件资源。

建议在生产环境中考虑使用分布式存储方案，如OSS或MinIO，以避免此类问题。