Common Report（通用报表）产品系统

在企业级系统建设过程中，报表需求普遍存在且呈现出“复杂多变、工期紧张”的显著特征。传统报表开发模式不仅耗时费力，还难以保障不同报表在样式规范与功能体验上的一致性，严重影响开发效率与交付质量。
目前市面上主流的低代码、零代码开源报表产品，经调研对比后发现普遍存在短板：部署流程繁琐、服务器资源占用较高、用户学习成本偏高、部分产品存在代码闭源限制，且对复杂中国式报表的适配性不足，无法满足企业“快速落地、低成本上线”的核心需求。基于此，我们决定自主研发一套轻量级通用报表产品，通过配置化方式快速实现各类报表功能，破解传统开发痛点。
通过拆解报表开发全流程，我们发现其核心工作可分为三大模块，各模块业务逻辑差异显著：
1. 前端模块：核心负责报表页面渲染、后端接口调用及数据展示，业务逻辑占比极低；
2. 后端模块：主要通过SQL查询数据库数据，封装接口并返回至前端，仅包含少量数据计算逻辑；
3. 数据库模块：业务逻辑高度集中于SQL编写，需开发人员全面掌握数据结构，并对查询效率进行严格把控。
结合上述特点，本产品重点对业务逻辑简单的前端、后端模块进行封装，形成标准化产品能力；而业务逻辑复杂的数据库模块，仍保留人工灵活处理的空间，兼顾标准化效率与个性化需求。

Common Report（通用报表）是一款轻量级低代码报表产品，在已具备SQL语句的前提下，可通过可视化配置快速实现各类报表的开发与上线，核心功能涵盖报表配置与报表页面两大模块，具体如下：
（一）报表配置功能
1. 基本属性配置：支持配置报表编码（唯一标识）、报表名称、查询SQL、可选汇总SQL、统计时间范围限制及导出权限控制；
2. 查询条件配置：支持多维度查询条件设置，包括统计时间范围（日、周、月、年、自定义起止时间）、扩展条件（文本、数值、枚举类型），同时可配置查询条件的默认值与可选范围；
3. 表头配置：完美适配多行复杂表头场景，支持自定义表头字体大小、对齐方式、自动换行及单元格合并；支持从汇总SQL中取值填充表头内容；
4. 查询字段配置：可灵活设置字段对齐方式、自动换行，支持连续多行相同内容的单元格合并；支持对SQL查询结果进行行内小计、占比计算、格式转换、序号添加等个性化处理，满足多样化展示需求；
5. 汇总项配置：支持对SQL查询结果进行合计、占比等汇总运算，支持从汇总SQL中取值填充汇总项；可配置汇总行的单元格合并、对齐方式、自动换行等样式，保证报表展示的规范性。
（二）报表页面功能
1. 权限与菜单配置：每个报表分配唯一报表编码（reportCode），通过该编码实现菜单关联与精细化权限控制；
2. 动态生成交互元素：前端根据后台配置，自动生成报表查询条件表单及查询、导出等操作按钮，无需前端二次开发；
3. 动态渲染报表结果：前端接收后端接口返回报文后，自动渲染报表数据及样式，实现配置与展示的实时同步；
4. 精准导出功能：采用前端ExcelJS组件实现报表导出，严格保留页面中报表表格的所有样式与数据，彻底解决后端导出因数据实时变化导致的“导出结果与查询结果不一致”问题，实现“所见即所得”。

本项目全程由本人独立完成，涵盖需求分析、系统设计、技术选型、开发实现等全部环节，确保产品设计与开发的连贯性、一致性。
项目核心技术栈如下：
- 前端：Vue、Element UI、ExcelJS
- 后端：Python、Django
- 数据库：MySQL
实现亮点与难点：
1. 后端SQL执行优化：基于Django框架底层游标connection.cursor()执行自定义SQL，实现参数安全绑定，有效规避SQL注入风险，同时提升查询效率；
2. 复杂表头实现：通过父子关系定义表头层级，完美适配中国式复杂多行表头场景，兼顾灵活性与规范性；
3. 单元格合并功能：精准实现报表表头与表体的单元格合并逻辑，解决复杂报表样式渲染难题，保障报表展示的美观性与可读性；
4. 前端导出优化：借助ExcelJS组件实现前端导出，完全还原页面报表的所有样式（含单元格合并、字体、对齐方式等），确保导出结果与页面展示一致；
5. 配置功能快速落地：通过完善Django Model类代码，复用Django Admin后台能力，快速实现报表全量配置功能，降低开发成本，提升配置效率。