首页
/ Wang-Template:简洁易用的报告生成系统

Wang-Template:简洁易用的报告生成系统

2024-09-24 02:45:32作者:裴锟轩Denise

项目介绍

Wang-Template 是一款从实际生产平台中抽离出来的报告渲染模块,现已独立成为一个简洁易用的报告生成系统。该系统采用前后端分离的架构,专注于报告生成,支持对接任意数据源,并通过自定义模板生成各种类型的报告。无论是企业内部的报告生成需求,还是对外提供的数据分析报告,Wang-Template 都能轻松应对。

项目技术分析

核心技术栈

  • Java 8+:作为后端开发语言,保证了系统的稳定性和性能。
  • Spring 5.3.31:提供了强大的依赖注入和AOP功能,简化了开发流程。
  • Spring Boot 2.7.18:快速构建独立的、生产级别的Spring应用,减少了大量的配置工作。

支持的数据源类型

  • 关系型数据库 SQL:通过JDBC接口实现数据查询,已验证支持MySQL、Postgresql和H2数据库。

支持的报告类型

  • Word报告:使用 poi-tl 支持Word模板的编辑,生成Word报告。
  • 文本报告:使用 FreeMarker 支持任意文本报告的编辑,生成TXT、Markdown、HTML等格式的报告。

项目及技术应用场景

Wang-Template 适用于多种场景,包括但不限于:

  • 企业内部报告生成:如财务报表、销售报告、运营分析等。
  • 数据分析平台:作为数据分析结果的输出模块,生成可视化的报告。
  • 智能客服系统:生成客服对话记录报告,辅助客服质量监控。
  • 教育培训:生成学生成绩报告、课程进度报告等。

项目特点

1. 轻量化

Wang-Template 专注于报告生成,不涉及其他复杂功能,使得系统轻量化,易于部署和维护。

2. 可扩展

采用模块化架构和面向接口的设计,使得系统易于扩展,可以快速对接新的数据源和渲染方式。

3. 易整合

系统设计简洁,易于整合到其他系统中,作为报告生成功能的模块。

4. 更智能

整合了大文本人工智能服务,提供更智能化的报告生成能力,如自动数据分析、智能推荐等。

部署与使用

快速部署

参考 Docker Compose 的快速部署项目:

后端部署

使用 Docker 部署

docker build -t wang-template-backend:1.0 .
docker run -d --name wang-template-backend -p 8000:8000 -v <path-to-config>/application-prod.yml:/opt/config/application-prod.yml wang-template-backend:1.0

手动部署

使用 Maven 构建打包:

mvn clean package -DskipTests

前端部署

使用 Docker 部署

docker build -t wang-template-admin:1.0 .
docker run -d --name wang-template-admin -p 8001:80 wang-template-admin:1.0

手动部署

使用 Vite 构建打包:

yarn build

系统截图

配置数据源

配置数据源

配置数据源参数

配置数据源参数

数据源详情

数据源详情

测试获取数据

测试获取数据

配置模版

配置模版

创建生成任务

创建生成任务

查看结果

查看结果

配置说明

配置文件

添加配置文件 application-prod.ymlapplication-prod.properties,可参考 app/src/main/resources/example-application-dev.yml 文件。

配置数据库

spring.datasource.druid 项下配置或在 mybatis-flex.datasource.master 下配置。

配置附件存储

附件存储基于 x-file-storage,支持本地存储、MinIO、公有云对象存储等。

配置报告分析(人工智能)

启用报告指标分析,并配置 Kimi API 密钥。

模版说明

模版上下文对象

所有的模版都注入了渲染的上下文对象,对象格式如下:

{
  "templateName": "",
  "datasourceName": "",
  "params": {},
  "envs": {
    "year": 2024,
    "month": 6,
    "day": 12,
    "dayOfWeek": 3,
    "hour": 0,
    "minute": 0,
    "second": 0
  },
  "data": {}
}

Word模版

Word 模板基于 poi-tl,模版语法可参考官方文档。

文本模版

文本模版基于 FreeMarker,模板语法可参考官方文档。

后续计划

  • 支持更多数据源
  • 增加定时任务和生成计划
  • 集成更多人工智能能力

Wang-Template 以其简洁易用、高度可扩展的特点,必将成为您报告生成需求的首选工具。立即体验,开启智能报告生成的新篇章!

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
179
263
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
869
514
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
130
183
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
307
337
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
333
1.09 K
harmony-utilsharmony-utils
harmony-utils 一款功能丰富且极易上手的HarmonyOS工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON等一系列的功能和操作,能够满足各种不同的开发需求。
ArkTS
18
0
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.08 K
0
kernelkernel
deepin linux kernel
C
22
5
WxJavaWxJava
微信开发 Java SDK,支持微信支付、开放平台、公众号、视频号、企业微信、小程序等的后端开发,记得关注公众号及时接受版本更新信息,以及加入微信群进行深入讨论
Java
829
22
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
601
58