262 Star 2.3K Fork 805

orange-form / orange-admin

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 20.74 KB
一键复制 编辑 原始数据 按行查看 历史
orange-form 提交于 2024-01-31 02:37 . update README.md.

在线演示

欢迎加入我们的技术交流群,如遇任何使用中的问题我们都将第一时间为您答疑。QQ群 [664800781]。

新版功能

2.9.5 版本新上线功能如下。

  • 移动端,在线表单同时支持 vant(h5) 和 uniapp(小程序)。
  • 移动端,工作流审批同时支持 vant(h5) 和 uniapp(小程序)。
  • 移动端,统计表单同时支持 vant(h5) 和 uniapp(小程序)。
  • 工作流,支持流程复活,既已经完成的流程还能再次回到审批状态。
  • 工作流,支持任务超时提醒,已支持 ”消息提醒和自动审批“。
  • 工作流,支持流程任务空审批人的处理机制,目前已实现 “自动审批、自动拒绝和指定转派”。
  • 工作流,支持对已存在业务数据的多次审批。
  • 工作流,支持服务启动时指定流程表所在数据源。
  • 工作流,Spring Boot 3 版本升级至 Flowable 7。
  • 工作流,Spring Boot 2 版本升级至 Flowable 6.8。
  • 工作流,原有自动跳过的执行监听器改为任务监听器,以支持更多自动跳过条件。
  • 在线表单,支持批量导入,导入过程支持字典数据的反向翻译。
  • 在线表单,根据配置项可以切换,业务表和在线表单表之间是同库还是跨库。之前就支持跨库,因此会有多次事务的副作用。
  • 报表打印,x-spreadsheet 替换 luckysheet,作为打印编辑器的电子表格组件。
  • 报表模块,打印预览改为 x-spreadsheet 预览,可以直接下载 excel 数据文件。
  • 报表打印,新增支持 Doris 分析数据库。
  • 基础架构,支持华为云 OSS。
  • 基础架构,全模块支持华为 OpenGauss。
  • 基础架构,全局编码字典支持独立数据源配置。
  • 基础架构,升级到 Knife4j 4.5.0,全面支持 OpenAPI3 规范。
  • 基础架构,jwt 升级到 0.12.3。
  • 基础架构,升级支持 Spring Boot 3.1.6。从当前版本开始,橙单将同时支持 Spring Boot 3.x 和 Spring Boot 2.7.x。
  • 基础架构,升级支持 Mybatis Flex。从当前版本开始,橙单将同时支持 Mybatis Flex 和 Mybatis Plus。

选择橙单

橙单,具备极好代码生成能力的低代码工具。生成后工程全部源码交付,所有代码文件无任何橙单痕迹。就如同贵公司最优秀的技术团队亲手打造而得。欢迎加入我们的技术支持QQ群4 (664800781),您的技术问题我们会尽快给出回复。

  • 承诺,全网最低价和最宽松的商业版授权,全部源码交付,包名随便改,永久免费升级。
  • 理念,极强大的代码生成能力,80% 以上的业务代码无需手写,对二次开发非常友好。
  • 功能,工作流、在线表单、统计报表和打印、多租户、用户权限、数据权限过滤、全类型数据字典等,全部深度支持,绝非简单集成。
  • 架构,云原生架构设计理念,接口正交化组合,同时支持多种第三方应用和多租户的快速接入能力。
  • 代码,顶级的代码强度和质量,近 10 万行代码全部通过 SonarQube 最严格的代码扫描,0 警告。
  • 支持,30 万字的线上文档和技术专栏,助您快速吃透橙单。活跃的 VIP 微信群技术支持,必要时可提供远程协助服务。

新架构优势

在升级到 2.8 版本之后,橙单基础架构组件,目前包括报表打印、在线表单和工作流等,全部支持第三方快速接入功能,并以 “若依” 为示例,提供了完整且详细的接入文档,其他框架或老系统均可参考该示例文档,手动修改后接入橙单的全部功能组件。具体可见后面的 “若依” 接入效果图。

  • 被接入系统改动极少,前后端均与橙单架构 0 耦合,仅需参考线上文档的示例编写插件代码即可。
  • 被接入系统前端可使用任何技术栈,均不会与橙单页面产生冲突。
  • 被接入系统后台可使用任何技术栈或不同开发语言,其与橙单服务之间采用标准的 HTTP 接口进行通讯。
  • 被接入系统的业务库表与橙单内置库表可分开部署,甚至可与橙单使用不同的数据库类型,从而实现数据层面的最大化解耦。
  • 橙单独立部署的在线表单、工作流和报表打印等组件服务,可同时服务于多个不同的业务系统。如出现性能瓶颈,亦可动态扩充橙单组件服务的实例数量,以缓解系统的并发处理压力。

友情感谢

线上资源

技术专栏

授人以鱼不如授人以渔。我们的专栏,是基于橙单低代码的基础架构,并对其进行了深入浅出和鞭辟入里的分析。专栏中的每一行代码,每一段注释,每一个技术点和每一步的思考过程,都是产品级强度的。请坚信 吃透橙单、收入翻番、效率乘三

功能介绍

工作流

  • 优势能力,成熟的工作流产品价格昂贵,普通脚手架所集成的工作流模块功能有限,而橙单通过支持 静态路由表单工作流 的方式,有效的弥补了这一尴尬。
  • 代码生成,支持静态路由表单 + 工作流的代码生成。用户可在生成器配置表单和流程,并生成该流程的完整前后端业务代码。对于有些复杂的业务需求,可通过便利的二次开发搞定。
  • 在线表单,集成工作流和在线表单,无需写一行代码即可配置出相对复杂的工作流业务。
  • 工单管理,支持完整的工作流工单管理,可为不同流程配置独立的工单菜单和管理页面,并与现有的数据过滤权限完美整合。
  • 用户选择,支持基于角色、部门、岗位、本部门岗位、上级部门岗位、同级部门岗位、指定部门岗位、本部门领导岗位、上级部门领导岗位等候选组。
  • 基础功能,支持工单号的自定义编码、自定义流程节点状态、工单撤销和终止、流程干预、会签加签减签、待办已办转办、催办、抄送和传阅、保存草稿、撤回和驳回、待办任务自动通知、历史任务、审批详情列表、包含候选组的审批人列表、附件上传下载等。前端已集成美观的流程编辑器,同时支持流程图高亮及任务跟踪。
  • 业务数据,工作流支持主表及一对一、一对多、多对多从表数据的级联增删改查。同一表单可多次提交,新增数据和修改数据后均可提交审批流程。
  • 数据安全,严格且合理的数据安全校验,流程敏感数据 (如合同附件) 不会被越权访问和下载。同时还支持审批中数据与最终审批完成数据的分离,避免造成对其他业务关联表的数据污染,审批完成后可自动执行业务数据的同步。

静态表单

以下所有功能的前后端代码,均可通过橙单的低代码工具配置后生成。标准化接口和数据结构,可轻松实现正交化组合。

  • 前后端支持单表增删改查、字典列表、分组聚合查询、部分更新、批量删除、导入导出、上传下载。
  • 批量导入支持常量字典和数据表字典的反向翻译,比如文件存储的是“一年级”字符串,导入过程中会批量替换为对应的Id后插入数据表。
  • 前后端支持主表与一对一、一对多、多对多关联表的关联查询,分组聚合查询、虚拟字段的聚合计算,数据导出、级联添加、级联更新、级联删除。
  • 前后端支持主表与多对多中间表的批量插入、批量删除、单条删除、关联列表数据查询、未关联列表数据查询。
  • 前后端支持主表与字典表数据、一对一、一对多和多对多与字典表数据的关联查询。
  • 后台接口支持主表、一对一从表、一对多从表、多对多从表关联数据的单条和批量验证,会根据配置生成本地服务或跨服务远程调用的高性能数据验证。
  • 以上所有功能,均支持分布式跨库跨服务操作,接口保持不变,需要分布式事务的场景,会自动生成 Seata 相关的代码注解。需要远程数据关联查询的,会生成 FeignClient 调用接口,并自动完成数据组装。

在线表单

  • 前后端代码完全交付,甚至可配置为自己的项目包名。
  • 前后端代码无一丝混淆,且代码质量超高,极易学习和二次开发,同时支持单体和微服务架构。
  • 全新的可视化的拖拉拽编辑器,目前已经支持大部分常用组件、容器组件、高级业务组件,并提供标准化的自定义组件接入接口。
  • 支持独立部署,可接入多个第三方框架或业务系统,并根据 appCode 实现数据隔离。目前仅以 若依 为例,并提供详细的接入文档和示例代码。
  • 目前已支持 MySQL、PostgreSQL 和 Oracle。
  • 支持主从表联动。
  • 支持富文本、多图、多附件的上传和下载。
  • 支持主表数据、一对一从表及其字典数据的可配置性导出。
  • 支持主表数据和一对多从表数据的批量删除。
  • 可视化接口配置编辑器,支持多数据库、数据表、一对一表关联、一对多表关联和多种数据字典等。
  • 支持字典过滤、主表字段过滤、一对一从表字段过滤,同时支持范围、模糊和等于查询方式。
  • 支持主表连同一对一、一对多从表的级联插入和更新。
  • 支持一对多的聚合字段计算,在主表列表中可动态计算并显示从表的聚合计算结果。
  • 支持主表字段排序、一对一从表字段排序。
  • 完美支持数据权限过滤和操作权限控制。
  • 接口参数均为数据源 ID,不暴露任何后台数据表细节,从机制上彻底消除了 SQL 注入的风险。
  • 运行时效率极高,动态表单关键数据结构均缓存 Caffeine 和 Redis,整体性能无限接近路由表单。

报表打印

  • 支持动态添加多数据源,目前可同时支持 MySQL/PostgreSQL/Oracle/Clickhouse。
  • 支持 Table、SQL 和 API 等数据源,同时支持动态的数据权限过滤。
  • 支持块嵌套布局,支持拖拽图表组件、透视表组件和自定义业务组件,可快速动态配置 Dashboard 页面。
  • 支持基于 Luckysheet 的打印模板设计。
  • 支持导出到 PDF 和 Excel。
  • 支持循环打印、批量打印等。
  • 打印功能可与路由表单、在线表单和流程工单无缝接合。

多租户

  • 多租户工程可同时创建三个应用,分别为租户运营管理后台应用 TenantAdmin,租户运营后台应用,以及面向租户前端 App 的 WebApi 应用。
  • 对于多租户运营管理后台应用 TenantAdmin,不仅内置了自身的权限管理和租户运营管理等功能,同时也支持配置自定义的业务表单和租户统计表单。
  • 支持全局公用字典和租户字典,前者由租户运营管理后台统一管理,租户字典数据可由租户管理员自行维护。为了保证整体运行时效率,两者均支持缓存 Redis。
  • 租户数据支持逻辑隔离、物理隔离和混合隔离等多种方式,租户权限数据由租户运营管理服务统一管理,实时同步到多个租户运行系统数据库中。不仅非常有利于租户数据的迁移。同时也保证了运行时效率。业务逻辑代码与非多租户系统相比,差异也降至最低。
  • 可配置定时任务 Job 服务,并将不同租户数据库中的业务行为数据,分组统计后刷新到租户运营管理数据库中,再由配置的统计表单进行显示。
  • 可与现有的单点登录服务 (uaa) 无缝集成。

基础架构

开箱即用

项目信息如您所愿,工程名称、目录结构、基础包名、common模块、代码注释中的 @author 信息等,在创建工程时即已配置,不会留有橙单的任何信息。因此无需二次修改,前后端直接编译运行即可。如编译期和运行时出现问题,那一定是我们的 bug,在得到您反馈后,我们将及时修复。

项目部署

技术选型

  • 前端: Element (Vue) / Luckysheet / ECharts / AntV + Axios + Webpack。
  • 后端: Spring Boot / Spring Cloud / Spring Cloud Alibaba + Spring Security OAuth2 + Mybatis + Jwt。
  • 数据库:MySQL + PostgreSQL + Oracle + 达梦。
  • 工具库: Flowable + Hutool + Guava + Caffeine + Lombok + MapStruct + Mybatis Plus + Knife4j + x-easypdf。
  • 服务组件: Redis + Zookeeper + Nacos + Consul + XXL-Job + Quartz + Seata + Minio + Canal + RocketMQ + Kafka + Sentinel。
  • 系统监控: ELK + PinPoint / SkyWalking + Grafana + Prometheus。

基础功能

  • 前端框架:单页面、多标签、多栏目和子路由,多套高颜值样式主题可供选择。
  • 前端能力:列表编辑、统计图表、多表联动、明细数据下钻、上传下载、导入导出、自定义打印样式模板、富文本等。
  • 页面布局:支持基于 Fragment 和 Block 的灵活布局方式,通过配置即可生成多样化的表单页面,并可预览。
  • 接口规范:微服务和单体服务的接口命名和参数定义规范完全一致,便于日后的平滑升级。
  • 在线表单:支持可视化拖来拽编辑器,表单、后台接口和数据字典均可动态配置,完美集成数据权限过滤和操作权限控制,即配即得。
  • 流程管理:功能完整且前后端全部开源。
  • 后台架构:分布式锁、分布式 Id、分布式缓存、分布式事务、分布式限流和灰度发布等,按需集成。
  • 用户管理:支持基于 OAuth2 的单点登录。
  • 操作权限:前端控制可精确到按钮级的操作和标签级的显示,同时提供了多维度的权限分配路径查询能力。
  • 数据权限:基于 Mybatis 拦截器 + JSqlParser 的实现方式,代码侵入性更低。提供丰富的过滤策略,且可精确到 “菜单”。
  • 租户管理:租户权限管理数据、字典等通用数据,均由租户运营管理服务统一管理,并实时同步到多个租户运营库,具有极高的数据库级别容错性。
  • 多数据源:支持简单和复杂两种多数据源注解。复杂注解可灵活自定义,并应对复杂的业务场景。
  • 数据组装:Java 注解方式实现数据组装,支持统一接口的服务内和跨服务的一对一、一对多、多对多、字典、聚合计算等关系数据组合。
  • 定时任务:我们不仅提供了多套 Job 基础框架的集成,更能生成灵活可配、高度优化、便于二次开发的 Job 业务逻辑代码。
  • 系统监控:基于 Kafka + ELK 的日志收集,基于 PinPoint/SkyWalking 的服务链路跟踪,基于 GPE 的服务性能指标监控。
  • 接口文档:目前已集成 Knife4j,同时支持基于 qdox 逆推 Java 工程代码,实现 0 注解导出 Postman 接口文件和 Markdown 文档。
  • 操作日志:灵活可配置。统一拦截每次请求调用的输入输出,及各种调用数据细节,以便于后期的统计分析和问题定位。微服务工程由 Kafka 消费者服务统一批量处理,并与 ELK + SkyWalking/PinPoint 等日志监控系统完全打通。单体工程则异步的存入数据库表中。

代码质量

此为在线演示工程的代码审查报告,而非当前开源示例工程。前者代码量更大,结构更复杂。

  1. SonarQube 扫描
  • 基于 SonarQube8.2 缺省最严格的代码扫描规则,其中代码复杂度要求为 15。
  • 有气味代码共90处,其中85处为DTO、Model、常量字典、RPC接口等定义出现重复名称所致,均与模拟实际业务有关。
  • 其余气味代码,是在权衡性能、可读性和易修改性等因素后保留下来的,具体见图4。
  1. Alibaba Code Guide 扫描
  • 下载最新版本IDEA插件,同时打开所有审查条件。
  • 全部代码扫描通过。
  1. Statistic 代码统计
  • 生成代码总量约为86000多行,主要包括Java、XML、YAML和SQL初始化脚本等。
  • Java代码覆盖率为37%。

价值理念

都看到这里了,如果看的仔细,至少要花 20 分钟,非常感谢您的坚持和耐心,希望能再花 1 秒钟的时间在下面 star 一下。

Java
1
https://gitee.com/orangeform/orange-admin.git
git@gitee.com:orangeform/orange-admin.git
orangeform
orange-admin
orange-admin
master

搜索帮助