# LiteAdmin

**Repository Path**: doctormacky/lite-admin

## Basic Information

- **Project Name**: LiteAdmin
- **Description**: LiteAdmin 是一款轻量、简洁、现代的管理系统，基于 SmartAdmin V3 二次开发，深度集成了工作流引擎、在线表单设计、文件预览、AI助手、系统监控等能力，适合学习参考与技术交流。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2026-09-24
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# ✦ LiteAdmin

**轻量 · 简洁 · 现代的管理系统**

[![SpringBoot](https://img.shields.io/badge/SpringBoot-3.5.4-6DB33F?style=flat-square&logo=springboot&logoColor=white)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3.5.13-42b883?style=flat-square&logo=vuedotjs&logoColor=white)](https://vuejs.org/)
[![Java](https://img.shields.io/badge/Java-17+-F89820?style=flat-square&logo=openjdk&logoColor=white)](https://openjdk.org/)
[![Vite](https://img.shields.io/badge/Vite-5.2.12-646CFF?style=flat-square&logo=vite&logoColor=white)](https://vitejs.dev/)
[![AntDesignVue](https://img.shields.io/badge/Ant%20Design%20Vue-4.2.5-1677FF?style=flat-square&logo=antdesign&logoColor=white)](https://antdv.com/)

[![MyBatisPlus](https://img.shields.io/badge/MyBatis--Plus-3.5.17-blue?style=flat-square)](https://baomidou.com/)
[![SaToken](https://img.shields.io/badge/Sa--Token-1.45.0-red?style=flat-square)](https://sa-token.cc/)
[![WarmFlow](https://img.shields.io/badge/Warm--Flow-1.8.9-0ea5e9?style=flat-square)](https://warm-flow.com/)
[![LiteFlow](https://img.shields.io/badge/LiteFlow-2.16.1-7c4dff?style=flat-square)](https://liteflow.cc/)
[![ZeroLog](https://img.shields.io/badge/Zero--Log-2.5.0-00b4d8?style=flat-square)](https://gitee.com/kuafucv/zero-log)
[![MySQL](https://img.shields.io/badge/MySQL-8.0+-4479A1?style=flat-square&logo=mysql&logoColor=white)](https://www.mysql.com/)

</div>

---

## 介绍

**LiteAdmin** 是一款轻量、简洁、现代的管理系统，基于 SmartAdmin V3 二次开发，深度集成了工作流引擎、在线表单设计、文件预览、AI助手、系统监控等能力，适合学习参考与技术交流。

---

## 在线演示

**演示地址**：<http://1.117.60.19:8081/>

**登录账号**：admin

**登录密码**：123456

---

## 核心优势

- **Redis 可选部署**：通过 `project.redis-enable` 一键切换，不装 Redis 也能运行。缓存自动降级为 本地缓存 内存缓存，防重复提交自动切换内存实现，零配置开箱即用
- **单模块精简架构**：告别多模块父子 POM，统一配置文件 + 环境差异配置，减少重复，降低理解与维护成本
- **灵活文件存储**：支持本地 / 阿里云 OSS / MinIO / RustFS 四种模式，统一基于 AWS S3 SDK 对接，私有化部署更友好
- **核心组件升级**：MyBatis-Plus 3.5.12 → 3.5.17、Sa-Token 1.44 → 1.45、Hutool 5.8.39 → 5.8.47，享受最新特性与修复
- **系统监控**：CPU / 内存 / 磁盘实时监控，基于 OSHI 轻量采集，无侵入
- **嵌入式日志监控（Zero-Log）**：Lite 模式零配置接入，浏览器实时查看应用日志、接口性能监控，内置 H2 存储，无需额外部署
- **通用 Excel 导入导出框架**：Handler 模式快速接入新业务，SSE 进度推送、异步导出、自动水印、防重复锁、记录可追溯
- **AI 智能助手**：多平台支持（DeepSeek / 阿里百炼 / ChatGPT），SSE 流式响应，多轮对话记忆，多应用自由配置
- **AI 对话 LiteFlow 编排**：AI 对话主流程组件化拆解，EL 规则文件驱动，扩展处理步骤零侵入主流程
- **工作流引擎**：Warm-Flow 深度集成在线表单设计器，仅 7 张核心表，轻量低维护

---

## 特色功能

<table>
  <tr>
    <td width="50%">
      <h3>🤖 AI 智能助手</h3>
      <ul>
        <li>多平台支持：阿里百炼、DeepSeek、ChatGPT，遵循 OpenAI 协议</li>
        <li>SSE 流式响应，对话内容逐字实时渲染</li>
        <li>多轮对话记忆，完整上下文存储</li>
        <li>多 AI 应用管理，模型/参数/提示词自由配置</li>
        <li>Markdown 渲染：代码高亮、表格、列表</li>
        <li>多选对话记录生成分享图片并下载</li>
      </ul>
    </td>
    <td width="50%">
      <h3>🔄 Warm-Flow 工作流</h3>
      <ul>
        <li>在线流程设计器，经典 / 仿钉钉双模式</li>
        <li>通过、退回、撤销、转办、委派、加减签</li>
        <li>与在线表单深度集成，无需编码配置表单</li>
        <li>实时流程监控，节点状态、审批历史一览</li>
        <li>仅 7 张核心表，轻量低维护</li>
        <li>支持 SpEL 条件表达式、互斥/并行网关</li>
      </ul>
    </td>
  </tr>
  <tr>
    <td width="50%">
      <h3>📊 通用 Excel 导入导出</h3>
      <ul>
        <li>通用导入弹窗组件，SSE 实时推送逐行进度</li>
        <li>异步导出 + 导出记录管理，文件生成后随时下载</li>
        <li>支持静态模板与动态模板两种下载方式</li>
        <li>导入记录可追溯：成功/失败/明细行级查看</li>
        <li>导出文件自动添加水印，防重复导出锁保护</li>
        <li>业务模块仅需实现 Handler 接口即可接入</li>
      </ul>
    </td>
    <td width="50%">
      <h3>👥 在线用户管理</h3>
      <ul>
        <li>基于 Sa-Token 实时查看当前所有在线用户</li>
        <li>展示用户账号、姓名、Token、登录时间、剩余存活时间</li>
        <li>支持按 Token 关键字搜索，快速定位目标用户</li>
        <li>一键强制踢人下线，精准控制到 Token 粒度</li>
        <li>分页查询，轻松应对大量在线会话</li>
      </ul>
    </td>
  </tr>
  <tr>
    <td width="50%">
      <h3>📋 FcDesigner 在线表单</h3>
      <ul>
        <li>可视化拖拽式表单设计器</li>
        <li>每个审批节点可独立配置表单视图</li>
        <li>丰富控件类型，满足多样业务场景</li>
      </ul>
      <h3>📄 Flyfish Viewer 文件预览</h3>
      <ul>
        <li>支持 Word / Excel / PPT / PDF / 图片 / CAD / 视频</li>
        <li>全屏沉浸式预览，嵌入系统无缝集成</li>
        <li>iframe 方式集成，前端零依赖</li>
      </ul>
    </td>
    <td width="50%">
      <h3>🖥️ 系统监控</h3>
      <ul>
        <li>CPU / 内存 / 磁盘实时监控，基于 OSHI 轻量采集</li>
        <li>CPU 使用率饼图，内存信息对比展示</li>
        <li>服务器信息总览，磁盘状态管理</li>
      </ul>
      <h3>📜 Zero-Log 嵌入式日志</h3>
      <ul>
        <li>Lite 模式零配置接入，无需部署额外服务</li>
        <li>浏览器实时查看日志，支持搜索与级别过滤</li>
        <li>接口性能监控 & 慢请求分析，内置 H2 存储</li>
      </ul>
    </td>
  </tr>
  <tr>
    <td width="50%">
      <h3>⚡ LiteFlow 规则编排</h3>
      <ul>
        <li>AI 对话全链路组件化：校验 / 路由 / 流式调用 / 持久化各自独立</li>
        <li>EL 规则文件驱动，流程调整无需改动 Java 代码</li>
        <li>组件可复用可热插拔，支持 SWITCH / WHEN 等复杂编排语法</li>
        <li>与 Warm-Flow 职责互补：逻辑编排 vs 审批任务流转</li>
      </ul>
    </td>
    <td width="50%">
      <h3>🛡️ 安全体系</h3>
      <ul>
        <li>等保三级合规：登录失败锁定、图形验证码、双因子登录</li>
        <li>密码复杂度策略 & 定期更换</li>
        <li>SM4 国密 / AES 接口加解密</li>
        <li>注解式数据脱敏（9 种类型）、防重复提交、智能水印</li>
      </ul>
    </td>
  </tr>
</table>

---

LiteAdmin 部分系统级功能速览：

<table>
  <tr>
    <td width="25%" align="center"><b>🔐 安全体系</b></td>
    <td width="25%" align="center"><b>🏗️ 系统功能</b></td>
    <td width="25%" align="center"><b>📊 办公运营</b></td>
    <td width="25%" align="center"><b>⚙️ 开发效率</b></td>
  </tr>
  <tr>
    <td>
      等保三级合规<br/>
      登录失败锁定 & 图形验证码<br/>
      双因子登录（邮箱验证码）<br/>
      密码复杂度 & 定期更换<br/>
      SM4 国密 / AES 接口加解密<br/>
      注解式数据脱敏（9 种类型）<br/>
      防重复提交 & 前端智能水印
    </td>
    <td>
      员工/部门/角色/菜单/岗位<br/>
      企业管理（多租户）<br/>
      数据权限 & 行级范围控制<br/>
      数据字典 & 系统参数<br/>
      操作日志 & 登录日志<br/>
      在线用户管理 & 强制踢出<br/>
      服务器监控（CPU/内存/磁盘）<br/>
      缓存管理 & 定时任务<br/>
      文件管理 & 多存储模式<br/>
      暗黑模式 · 10 主题色 · 4 布局 · i18n
    </td>
    <td>
      通知公告（定时发布 & 撤回）<br/>
      工作流引擎（Warm-Flow）<br/>
      流程定义 → 发起 → 审批全链路<br/>
      可视化表单设计器（FcDesigner）<br/>
      AI 对话（DeepSeek/百炼/OpenAI）<br/>
      文件预览（30+ 格式）<br/>
      在线帮助文档 & 消息中心<br/>
      意见反馈 & 版本记录<br/>
      钉钉组织架构同步
    </td>
    <td>
      代码生成器（前后端全栈 · JS/TS 双模板）<br/>
      通用 Excel 导入导出 & 记录追踪<br/>
      嵌入式日志监控（Zero-Log Lite）<br/>
      数据变更可视化追踪<br/>
      Swagger / Knife4j 文档<br/>
      Redis / 本地缓存双模式<br/>
      多套环境配置<br/>
      丰富的业务组件库<br/>
      动态路由 & 权限指令
    </td>
  </tr>
</table>

---

## 技术栈

| 层次 | 技术 |
|:----:|------|
| 前端 | Vue 3.5 · Vite 5.2 · Pinia 2.1 · Ant Design Vue 4.2 |
| 后端 | Java 17 · Spring Boot 3.5 · Sa-Token 1.45 · MyBatis-Plus 3.5.17 |
| 工作流 | Warm-Flow 1.8.9 |
| 规则编排 | LiteFlow 2.16 |
| 在线表单 | FcDesigner |
| 文件预览 | Flyfish Viewer |
| AI 服务 | 阿里百炼 · DeepSeek · ChatGPT（标准 OpenAI 协议） |
| 文件存储 | 本地 · 阿里云 OSS · MinIO · RustFS（均基于 AWS S3 SDK） |
| 系统监控 | OSHI · Hutool |
| 日志监控 | Zero-Log 2.5.0（Lite 模式嵌入式） |
| 数据库 | MySQL · PostgreSQL · Oracle · SQL Server · 国产数据库 |

---

## 快速开始

### 环境要求

| 依赖 | 版本要求 |
|------|---------|
| JDK | 17+ |
| Node.js | 18+ |
| MySQL | 8.0+（或其他受支持的数据库） |
| Redis | **可选**（默认关闭，无需安装即可启动） |

### 后端启动

```bash
# 1. 克隆项目
git clone <仓库地址>

# 2. 导入数据库脚本
# 执行 lite-admin-server/lite-admin.sql

# 3. 修改配置文件
# 编辑 application-dev.yml，配置数据库连接信息

# 4. 启动项目（Redis 为可选依赖，默认不需要）
cd lite-admin-server
mvn spring-boot:run
```

### 前端启动

```bash
cd lite-admin-front

npm install      # 安装依赖
npm run localhost      # 本地启动
npm run build:prod    # 生产环境构建
```

### AI 助手配置

在「**AI应用管理**」中创建应用，填写模型标识（如 `qwen3-plus`）与 API Key 即可使用。

---

#### 📊 通用 Excel 导入导出

LiteAdmin 提供了一套开箱即用的通用 Excel 导入导出框架，业务模块只需实现 Handler 接口即可快速接入。

**架构概览**

| 层次 | 前端 | 后端 |
|:----:|------|------|
| 组件 | `ExcelImportDialog` 通用导入弹窗 | `ExcelService` 通用导入导出服务 |
| API | `excelApi` / `importRecordApi` / `exportRecordApi` | `ExcelController` 统一入口 |
| 扩展 | 页面引入组件并传入 `type` | 实现 `ExcelImportHandler` / `ExcelExportHandler` 接口 |
| 记录 | 导入记录列表 / 导出记录列表 | `ImportRecordService` / `ExportRecordService` |

**导入流程**

1. 前端调用 `ExcelImportDialog` 弹窗，指定 `type`（如 `user_import`）
2. 用户点击「下载导入模板」，支持 **静态模板**（classpath 文件）和 **动态模板**（由 Handler 的 `getImportClass()` 生成）
3. 用户上传 `.xlsx/.xls` 文件 → 先调用 `fileApi.uploadFile()` 上传到文件服务获取 `fileKey`
4. 再调用 `POST /excel/import` 触发后端导入，后端通过 **SSE 流式推送** 逐行进度（`progress` / `error` / `complete` / `fail`）
5. 导入过程自动创建导入记录，支持按行查看成功/失败明细

**导出流程**

1. 前端调用 `POST /excel/export`，传入 `type` 和查询参数
2. 后端 **异步执行** 导出任务，立即返回提示「导出任务已提交」
3. 导出完成后文件自动上传到文件服务，并添加水印（操作人 + 时间）
4. 用户到「导出记录管理」页面查看并下载文件
5. 内置 **防重复导出锁**（按 type + userId，5 分钟过期）

**接入新业务模块**

后端只需 3 步：

```java
// 1. 在枚举中新增类型
// ExcelImportTypeEnum
USER("user_import", "员工导入", null)
// ExcelExportTypeEnum
USER("user_export", "员工导出")

// 2. 实现 ExcelImportHandler 接口
@Component("user_import")  // Bean 名称 = type 值
public class UserExcelImportHandler implements ExcelImportHandler {
    Class<?> getImportClass();               // 返回 UserExcelImportDTO.class
    String validateAndSaveRow(Object row, Map<String,Object> params);  // 内部强转为 UserExcelImportDTO
}

// 3. 实现 ExcelExportHandler 接口
@Component("user_export")  // Bean 名称 = type 值
public class UserExcelExportHandler implements ExcelExportHandler {
    List<?> getExportData(JSONObject params);
    Class<?> getExcelClass();                  // 返回 UserExcelVO.class
}
```

前端只需引入组件：

```vue
<ExcelImportDialog ref="importDialog" title="导入员工" type="user_import" @refresh="queryData" />
```

> **命名规范**：导入类型值必须以 `_import` 结尾，导出类型值必须以 `_export` 结尾。

**管理页面**

- **导入记录管理**：按类型/状态/创建人/时间筛选查询，支持查看导入明细（行号、状态、行数据、错误信息），下载原始文件
- **导出记录管理**：按类型/状态/创建人/时间筛选查询，导出成功后可下载文件

---

### 部分功能图示

#### 📋 表单设计
> **表单设计**
![表单设计](doc/form-design.png)

> **表单预览**
![表单预览](doc/form-view.png)

#### 🔄 工作流引擎
> **流程定义列表**
![流程定义列表](doc/flow-def-list.png)

> **流程设计 - 基本信息**
![流程设计-基本信息](doc/flow-def-design-base.png)

> **流程设计 - 审批规则**
![流程设计-审批规则](doc/flow-def-design-rule.png)

> **流程发起**
![流程发起](doc/flow-inst-start.png)

> **我的流程 - 详情查看**
![我的流程-详情查看](doc/flow-inst-form.png)

> **我的流程 - 流程图**
![我的流程-流程图](doc/flow-inst-img.png)

> **我的任务 - 待办列表**
![我的任务-待办列表](doc/flow-task-todo.png)

> **我的任务 - 审批操作**
![我的任务-审批操作](doc/flow-task-audit.png)

> **我的任务 - 已办列表**
![我的任务-已办列表](doc/flow-task-finish.png)

#### 🤖 AI 智能助手
> **AI 应用配置**
![AI应用配置](doc/ai-app-cfg.png)

> **AI 对话**
![AI对话](doc/ai-chat.png)

> **AI 对话管理**
![AI对话管理](doc/ai-chat-manage.png)

> **AI 对话详情**
![AI对话详情](doc/ai-chat-record.png)

#### 📁 文件预览
> **文件预览 - doc/docx**
![文件预览-Word](doc/fileview-doc.png)

> **文件预览 - Excel**
![文件预览-Excel](doc/fileview-xlsx.png)

> **文件预览 - PDF**
![文件预览-PDF](doc/fileview-pdf.png)

> **文件预览 - 图片**
![文件预览-图片](doc/fileview-img.png)

> **文件预览 - 视频**
![文件预览-视频](doc/fileview-video.png)

#### 📊 Excel 导入导出
> **导入列表**
![导入列表](doc/excel-import.png)
> **导入详情**
![导入详情](doc/excel-import-detail.png)

> **导出列表**
![导出列表](doc/excel-export.png)

#### 🔍 全局搜索
> **全局搜索**
![全局搜索](doc/global-search.png)

#### 📡 系统监控
> **系统监控**
![系统监控](doc/sys-monitor.png)

#### 📋 日志监控
> **日志监控**
![日志监控](doc/log-monitor.png)


---