# LiteAdmin

**Repository Path**: leekeep/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**: 1
- **Forks**: 1
- **Created**: 2026-06-20
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# ✦ LiteAdmin

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

基于 SmartAdmin V3 构建，集成工作流 · 在线表单 · 文件预览 · AI 智能助手

<br/>

[![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.15-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.8-0ea5e9?style=flat-square)](https://warm-flow.com/)
[![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 智能助手等能力，适合学习参考与技术交流。

---

## 特色功能

<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>📊 钉钉组织同步</h3>
      <ul>
        <li>配置 AppKey / AppSecret 即可接入钉钉组织架构</li>
        <li>支持定时自动同步 + 手动触发，灵活可控</li>
        <li>同步内容：组织部门树结构 + 员工信息</li>
        <li>支持一用户属多个部门（SmartAdmin 原版仅支持单部门，本项目改造支持）</li>
        <li>部门 / 用户失联自动处理，增量同步安全可靠</li>
      </ul>
    </td>
    <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>
  </tr>
</table>

---

## 基于 SmartAdmin V3

LiteAdmin 基于 [SmartAdmin V3](https://smartadmin.vip)（由 1024创新实验室 出品）构建，继承其全部系统级能力：

<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/>
      数据脱敏
    </td>
    <td>
      员工/部门/角色/权限<br/>
      数据字典 & 系统参数<br/>
      操作日志 & 登录日志<br/>
      文件管理 & 水印<br/>
      表格自定义列
    </td>
    <td>
      通知公告<br/>
      公司信息维护<br/>
      在线帮助文档<br/>
      意见反馈<br/>
      版本记录
    </td>
    <td>
      代码生成器<br/>
      数据变更可视化<br/>
      五套环境配置<br/>
      Redis 可选部署<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 |
| 工作流 | Warm-Flow 1.8.8 |
| 在线表单 | FcDesigner |
| 文件预览 | Flyfish Viewer |
| AI 服务 | 阿里百炼 · DeepSeek · ChatGPT（标准 OpenAI 协议） |
| 数据库 | MySQL · PostgreSQL · Oracle · SQL Server · 国产数据库 |

---

## 快速开始

### 环境要求

| 依赖 | 版本要求 |
|------|---------|
| JDK | 17+ |
| Node.js | 18+ |
| MySQL | 8.0+（或其他受支持的数据库） |

### 后端启动

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

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

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

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

### 前端启动

```bash
cd lite-admin-front

npm install      # 安装依赖
npm run localhost      # 本地开发
npm run build    # 生产构建
```

### AI 助手配置

在「**AI平台管理**」中添加平台，配置 API 基础地址（如 `https://dashscope.aliyuncs.com/compatible-mode/v1`）；
在「**AI应用管理**」中创建应用，填写模型标识（如 `qwen3-plus`）与 API Key 即可使用。

---

### 部分功能图示

#### 📋 表单设计
> **表单设计器**
![表单设计](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-plat-list.png)

> **AI 应用配置**
![AI应用配置](doc/ai-app-cfg.png)

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

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

#### 📁 文件预览
> **文件预览 - Word**
![文件预览-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)
---