You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tanghe-report/README.md

10 KiB

在线体验暂时下线

简介

AJ-Report是全开源的一个BI平台酷炫大屏展示能随时随地掌控业务动态让每个决策都有数据支撑。
多数据源支持内置mysql、elasticsearch、kudu驱动支持自定义数据集省去数据接口开发目前已支持20种大屏组件/图表,不会开发,照着设计稿也可以制作大屏。
三步轻松完成大屏设计:配置数据源---->写SQL配置数据集---->拖拽配置大屏---->保存发布。欢迎体验。

在线体验

在线体验: https://ajreport.beliefteam.cn/index.html 体验账号guest 密码guest

在线文档: https://ajreport.beliefteam.cn/report-doc/

在线提问: https://gitee.com/anji-plus/report/issues

发行版本

下载链接: https://gitee.com/anji-plus/report/releases

功能概述

组件介绍

大屏设计AJ-Report是一个可视化拖拽编辑的直观酷炫具有科技感的图表工具全开源项目。 内置的基础功能包括数据源,数据集,报表管理,项目部分截图如下。

操作 视频
更多社区大屏案例

数据流程图

An image

打包目录build

├── bin                                           启动命令脚本
│   ├── restart.sh
│   ├── start.bat
│   ├── start.sh
│   └── stop.sh
├── conf                                       配置文件目录
│   └── bootstrap.yml
├── logs                                          启动日志目录
├── cache                                         本地缓存目录
├── lib                                           自定义扩展包&report-core核心包

系统目录

├── doc                                           文档源码
│   ├── docs
│   ├── package.json
│   └── README.md
├── pom.xml                                       父pomjar版本管理
├── report-core                                   java源码
│   ├── pom.xml                                   gaea父pomjar版本管理
│   └── README.md
├── report-ui                                     前端vue源码
├── LICENSE
├── README.md

核心技术

依赖

  • [Mysql] 5.7
  • [Jdk] 1.8

后端

  • Spring Boot2.3.5.RELEASE: Spring Boot是一款开箱即用框架让我们的Spring应用变的更轻量化、更快的入门。 在主程序执行main函数就可以运行。你也可以打包你的应用为jar并通过使用java -jar来运行你的Web应用
  • Mybatis-plus3.3.2: MyBatis-plus简称 MP是一个 MyBatis (opens new window) 的增强工具。
  • flyway5.2.1: 主要用于在你的应用版本不断升级的同时,升级你的数据库结构和里面的数据

前端

  • npmnode.js的包管理工具用于统一管理我们前端项目中需要用到的包、插件、工具、命令等便于开发和维护。
  • webpack:用于现代 JavaScript 应用程序的静态模块打包工具。
  • ES6JavaScript的新版本ECMAScript6的简称。利用ES6我们可以简化我们的JS代码同时利用其提供的强大功能来快速实现JS逻辑。
  • vue-cliVue的脚手架工具用于自动生成Vue项目的目录及文件。
  • vue-router Vue提供的前端路由工具利用其我们实现页面的路由控制局部刷新及按需加载构建单页应用实现前后端分离。
  • element-ui基于MVVM框架Vue开源出来的一套前端ui组件。
  • avue: 用该组件包裹后可以变成拖拽组件,采用相对于父类绝对定位,用键盘的上下左右也可以控制移动。
  • vue-echarts: vue-echarts是封装后的vue插件基于 ECharts v4.0.1+ 开发。
  • vue-superslide: Vue-SuperSlide(Github) 是 SuperSlide 的 Vue 封装版本。
  • vuedraggable: 是一款基于Sortable.js实现的vue拖拽插件。
  • luckysheet: Luckysheet 一款纯前端类似excel的在线表格功能强大、配置简单、完全开源。

部署方式

注意版本兼容性
源码 doc -> docs -> guide 目录下即所有文档

发行版部署

下载最新发行版,解压
cd aj-report-xxxx
vim conf/bootstrap.yml 修改数据库连接等信息
sh bin/start.sh Linux启动
bin/start.bat Windows修改第4行的JAVA_HOME后(去掉rem注释),双击启动

启动后访问
http://serverip:9095
用户名密码admin/123456

登陆后修改"数据源->mysql数据源"用户名密码

源码编译部署

在Linux上先准备好maven、node.js、jdk

  • [Apache Maven] 3.5
  • [Node.js] v14.16.0
  • [Jdk] 1.8
git clone https://gitee.com/anji-plus/report.git
cd report
sh build.sh
编译完成放在build文件夹 aj-report-xxxx.zip

unzip aj-report-xxxx.zip
cd aj-report-xxxx
vim conf/bootstrap.yml 修改数据库连接等信息
sh bin/start.sh Linux启动
bin/start.bat Windows修改第4行的JAVA_HOME后(去掉rem注释),双击启动

启动后访问
http://serverip:9095
用户名密码admin/123456

登陆后修改"数据源->mysql数据源"用户名密码

运行环境参考文档

源码编译部署参考文档

发行版部署参考文档

前后端分离部署参考文档

操作手册

新建数据源重置mysql数据源 --> 新建数据集编写sql --> 新建大屏(设计大屏)
在线文档

SQL初始化

sql文件的目录在report-core --> src --> main --> resources -- > db.migration

系统初始化时flyway会自动的将该目录下的sql文件执行不需要手动执行sql文件。
执行完将会创建 aj_report存放系统基础数据 和 aj_report_init存放示例数据 俩个库。

谁在使用

希望你们的logo出现在此请点此Issue进行登记 ,我们将优先进行技术支持


未来计划

  • 大屏宽高动态可视化
  • nodeV16适配
  • 增加省市区地图等图
  • 增加基础边框样式
  • Execl报表功能增加与bug修复

已知问题

  • IE白屏兼容性问题

版本问题

已知以下版本存在兼容性问题

  • Node.js V16
  • openJdk
  • Jdk 11
  • Mysql 8.08.0.23/26版本没有问题8.0.21版本存在问题) 常见问题

商业授权

AJ-Report使用Apache2.0开源协议
个人和企业,在直接使用、二次开发后商业使用,需要遵守:

  • 包含AJ-Report LICENSE文件授权使用者免费使用AJ-Report专利和知识产权
  • 如果修改了代码,需要在被修改的文件中说明
  • 在修改和有源代码衍生的代码中,需要带有原来代码中的协议,商标
  • 在二次开发后商业发布的产品中使用了多个开源软件则必须包含一个Notice文件在Notice文件中需要带有AJ-Report LICENSE。你可以在Notice中增加自己的许可但不可以表现为对AJ-Report LICENSE构成更改。

如果您需要商业化增值服务,请加下面的微信沟通。

技术支持

如有问题,请提交 Issue
个人企业微信加微信进群备注AJ-Report或者Report (不备注是看不到的)

开源不易劳烦各位star ☺