# kk-admin

**Repository Path**: khalil5735/kk-admin

## Basic Information

- **Project Name**: kk-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-13
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# kk-admin

一个基于 Spring Boot 和 Vue 的后台管理系统，提供菜单管理、定时任务、系统日志、CMS 和文件管理等功能。

## 项目结构

- `kk-admin-server`: 后端服务，基于 Spring Boot 实现。
- `kk-admin-web`: 前端界面，基于 Vue 实现。

## 功能特性

- **菜单管理**：支持菜单的增删改查及树形结构展示。
- **定时任务**：集成 Quartz 实现任务调度管理。
- **系统日志**：记录并展示系统运行日志。
- **CMS**：内容管理系统模块。
- **文件管理**：支持文件的上传、下载和管理。

## 使用组件

- **后端**：Spring Boot, JPA, Quartz, Logback。
- **前端**：Vue, Element Plus, Markdown 编辑器。

## 安装与部署

### 后端部署 (kk-admin-server)

1. 确保已安装 JDK 1.8+ 和 Maven。
2. 导入数据库脚本 `init.sql` 到你的数据库。
3. 修改 `application.yaml` 中的数据库连接信息。
4. 使用 Maven 构建项目：
   ```bash
   mvn clean install
   ```
5. 启动应用：
   ```bash
   java -jar kk-admin-server.jar
   ```

### 前端部署 (kk-admin-web)

1. 确保已安装 Node.js 和 npm。
2. 进入 `kk-admin-web` 目录并安装依赖：
   ```bash
   npm install
   ```
3. 启动开发服务器：
   ```bash
   npm run dev
   ```
4. 构建生产环境包：
   ```bash
   npm run build
   ```

## 使用说明

- **登录**：访问 `/login` 页面进行登录。
- **菜单管理**：在 `/sys/menu` 路径下进行菜单的管理操作。
- **定时任务**：访问 `/job` 路径进行任务调度管理。
- **系统日志**：通过 `/logging` 路径查看系统日志。

## 贡献指南

欢迎贡献代码和反馈问题。请遵循以下步骤：

1. Fork 项目仓库。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -am 'Add new feature'`)。
4. 推送分支 (`git push origin feature/new-feature`)。
5. 创建 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。