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

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

2024-09-24 17:49:40作者:裴锟轩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 以其简洁易用、高度可扩展的特点,必将成为您报告生成需求的首选工具。立即体验,开启智能报告生成的新篇章!

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

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
153
1.98 K
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
505
42
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
194
279
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
992
395
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
938
554
communitycommunity
本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息
332
11
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
146
191
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
75
70