# Lcx
**Repository Path**: lc94/lcx
## Basic Information
- **Project Name**: Lcx
- **Description**: 费时半月搞得单体项目框架 方便以后搞点小项目。
技术栈 springboot beetlsql beetl satoken hutool mysql
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 3
- **Forks**: 0
- **Created**: 2020-09-12
- **Last Updated**: 2026-07-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# LCX 快速开发平台
[](http://www.apache.org/licenses/LICENSE-2.0.html)
[](https://openjdk.org/)
[](https://spring.io/projects/spring-boot)
## 项目简介
LCX 是一个基于 Spring Boot 的快速开发平台，采用微服务架构设计。平台提供了完善的用户权限管理、菜单管理、机构管理、角色管理、系统日志等功能，同时支持博客系统的快速搭建。
## 技术栈
### 后端技术
- **核心框架**: Spring Boot 2.5+
- **认证授权**: Sa-Token
- **数据库**: MySQL / BeetlSQL
- **缓存**: Redis / Ehcache
- **WebSocket**: t-io
- **API文档**: Knife4j + Swagger
- **模板引擎**: Beetl
### 前端技术
- **UI框架**: LayUI
- **表格组件**: layui-table + soulTable (高级表格)
- **树形组件**: zTree + treeTable
- **选择器**: xmSelect
- **其他**: ECharts, iziToast 等
## 模块介绍
```
lcx
├── lcx-admin # 后台管理系统
├── lcx-blog # 博客系统
├── lcx-core # 核心框架
├── lcx-gen # 代码生成器
└── lcx-service # 业务服务层
├── lcx-service-common # 公共模块
├── lcx-service-content # 内容服务(文件管理)
└── lcx-service-system # 系统服务(用户/角色/菜单等)
```
### lcx-admin (后台管理系统)
后台管理模块，提供完整的系统管理功能：
- 用户管理 - 用户的增删改查、密码修改、在线用户查看
- 角色管理 - 角色权限分配、数据范围设置
- 菜单管理 - 菜单树形结构管理
- 机构管理 - 组织架构管理
- 字典管理 - 系统字典配置
- 日志管理 - 登录日志、系统日志
- 文件管理 - 文件上传、目录管理
### lcx-blog (博客系统)
博客系统模块，提供基础博客功能：
- 用户登录/登出
- 权限认证
### lcx-core (核心框架)
提供项目的基础能力：
- 统一响应格式 (R, IBaseReq, IBaseRes)
- 异常处理机制
- 缓存抽象 (ICache)
- 分布式ID生成 (IdUtil)
- 文件上传 (UploadUtil)
- 工具类 (Tools, JackSon, TreeUtil)
- Web工具 (WebKits)
- 认证授权 (Sa-Token集成)
- 数据权限控制
### lcx-gen (代码生成器)
基于模板的代码生成工具，快速生成：
- Entity实体类
- Mapper接口
- Service服务类
- Controller控制器
### lcx-service (业务服务层)
#### lcx-service-common
- 基础实体类 (BaseEntity)
- 分页请求/响应 (IBasePageReq, IBasePageRes)
- 基础服务接口 (IService)
- 数据库配置 (BeetlSQL, Druid)
#### lcx-service-content
- 文件管理 (SysFiles)
- 目录管理 (SysFileDir)
#### lcx-service-system
- 用户服务 (SysUser)
- 角色服务 (SysRole)
- 菜单服务 (SysMenu)
- 机构服务 (SysDept)
- 字典服务 (SysDict)
- 日志服务 (SysLoginLog)
## 系统特性
1. **微服务架构** - 模块化设计，易于扩展
2. **前后端分离** - RESTful API 设计
3. **权限控制** - 细粒度的菜单、按钮权限
4. **数据权限** - 支持部门/角色数据范围控制
5. **代码生成** - 快速生成CRUD代码
6. **WebSocket** - 实时消息推送
7. **多主题** - 支持多种前端主题切换
8. **完整日志** - 操作日志、登录日志记录
## 快速开始
### 环境要求
- JDK 8+
- Maven 3.6+
- MySQL 5.7+
- Redis (可选)
### 构建项目
```bash
# 克隆项目
git clone https://gitee.com/lc94/lcx.git
# 进入项目目录
cd lcx
# 编译项目
mvn clean package -DskipTests
```
### 配置说明
1. **数据库配置** - 在 `application.yml` 中配置数据库连接信息
2. **Redis配置** - 如需使用Redis缓存，配置Redis连接
3. **文件上传** - 配置上传文件存储路径
### 启动服务
```bash
# 启动后台管理系统
java -jar lcx-admin/target/lcx-admin.jar
# 启动博客系统 (可选)
java -jar lcx-blog/target/lcx-blog.jar
```
访问地址: `http://localhost:8080`
## 默认账号
- 用户名: admin
- 密码: admin123
## 项目结构
```
src
├── main
│ ├── java
│ │ └── com
│ │ └── lcx
│ │ ├── app # 应用模块
│ │ │ ├── admin # 后台管理
│ │ │ └── blog # 博客系统
│ │ ├── core # 核心框架
│ │ ├── gen # 代码生成
│ │ └── service # 业务服务
│ └── resources
│ ├── static # 静态资源
│ ├── templates # 模板文件
│ └── application.yml # 应用配置
```
## 参与贡献
1. Fork 本仓库
2. 新建 feature_xxx 分支
3. 提交代码
4. 新建 Pull Request
## 许可证
本项目基于 Apache License 2.0 协议开源。
## 感谢
- [Sa-Token](https://sa-token.dev33.cn/) - 轻量级Java权限认证框架
- [BeetlSQL](https://www.ibeetl.com/) - 全能型SQL模板引擎
- [LayUI](https://layuion.com/) - 经典前端UI框架
- [Knife4j](https://doc.xiaominfo.com/) - Swagger文档增强
---
欢迎 Star 与 Fork 支持本项目！