# lightning

**Repository Path**: shcan/lightning

## Basic Information

- **Project Name**: lightning
- **Description**: 以低代码为核心的企业级办公系统
企业级后台软件开发脚手架,一站式全栈开发方案,让开发快如闪电
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: V1.0-develop
- **Homepage**: http://1.14.75.16   admin 123456
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 0
- **Created**: 2020-06-14
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lightning - 闪电 ⚡
让开发快如闪电。

#### 介绍
`lightning` 是一个以低代码和工作流为核心的企业级协同办公系统与全栈开发脚手架，提供了一站式全栈开发方案，让业务系统的落地和演进快如闪电。

#### 软件架构与关键技术栈
* **核心基础**：Spring Boot 快速应用构建
* **持久层**：Beetl3 SQL 持久层框架，提供高性能灵活的查询处理 [[Beetl3 文档链接直达](https://www.kancloud.cn/xiandafu/beetl3_guide/1992542)]
* **数据缓存**：Spring Data Redis & Redis 高速数据访问
* **权限安全**：Spring Security 安全与细粒度权限控制
* **对象转换**：Mapstruct 高性能 DTO 转换，告别手写 Bean 拷贝
* **定时任务**：Quartz 提供动态可配的作业定时调度
* **流程引擎**：Flowable 构建的高可靠工作流控制机制

---

#### 工程模块结构说明

项目采用 Maven 多模块架构，通过极低耦合的层级依赖关系划分了业务和底层基础。目前实体物理结构与各自职责定位如下：

* **`lt-bootstrap`**：主启动引导与环境配置文件，是整个后端应用的启动入口。
* **`lt-core`**：平台核心框架基础，封装了全局 Redis 缓存、过滤器、异常拦截及平台核心底座功能。
* **`lt-organization`**：组织架构管理服务，支持用户、角色、岗位、部门关系等基础组织数据的管理及流程选人规则定义。
* **`lt-system`**：系统管理公共业务，涵盖数据字典、系统配置、审计日志及动态定时调度（Quartz）等服务。
* **`lt-form-api`**：低代码表单定义抽象接口包，提供组件及运行时的标准协议约束。
* **`lt-form`**：表单设计器后台核心实现，提供低代码表单数据结构设计态的保存与读取。
* **`lt-form-run`**：低代码动态表单运行时数据解析与流转驱动引擎，负责实例生成和数据录入。
* **`lt-bpm`**：工作流引擎核心封装，基于 Flowable 提供节点定制、画板解析、流程部署及流转进度跟踪等底层服务。
* **`lt-collaboration`**：协同办公业务逻辑模块，结合表单和工作流实现呈批件、公文流转及协同办理等运行时核心业务流程。
* **`lt-report`**：报表中心数据服务，支持动态图表、业务报表的设计与展现态数据渲染。
* **`lt-control`**：业务控制器及 API 层，负责对外输出标准的 RESTful 接口。
* **`lt-util`**：通用系统工具集，包含数据加密、时间处理、文本编解码等常用工具。

---

#### 核心业务功能

1. **统一权限体系**：完美集成用户、角色、岗位、菜单与按钮的多维安全权限控制。
2. **低代码表单引擎**：
   - 动态表单设计器：支持拖拽式组件编排，提供极高的开发效率。
   - 动态运行时解析：表单与工作流天然集成，可直接作为审批流内容载体。
3. **BPM 工作流中心**：
   - 支持高保真、高密度图形化工作流设计器。
   - 提供进行中、已超期、待签收、待办办结等全方位任务流转机制。
   - 流程图实时流转轨迹追踪及可定制的审批人节点高亮展示。
4. **动态定时任务**：支持在线可视化配置并启动、暂停、重置 Quartz 调度任务。
5. **多端业务联动**：包含已发送事项、已办结事项、待办流转及协同办理等闭环流程。

---

#### 启动与使用说明

1. **前端依赖拉取**：配套的前端 Vue 3 开发项目见 [[对应前端 VUE 项目链接直达](https://gitee.com/shcan/lightning-web-vue)]。
2. **数据库初始化**：拉取项目后，先执行根目录下 `/initSql/MySQLinit.sql` 将数据库和基础字典数据导入 MySQL 中。
3. **基础配置调整**：修改启动模块 `lt-bootstrap` 内的配置文件，调整正确的数据库连接及 Redis 连接信息。
4. **项目运行**：运行启动类，默认控制台加载成功后即可正常提供 RESTful 接口。
5. **系统默认凭证**：默认系统管理员用户账号：`admin`，密码：`123456`。

---

#### 参与贡献流程

1. **Fork** 本仓库到您的个人账号。
2. **新建分支**：`git checkout -b feat_xxx` 或 `feat/your-feature-name`。
3. **提交修改**：提交有规范注释的代码变更。
4. **新建 PR**：推送至远端后申请 Pull Request 进行 Code Review 与合并。