# 企业级报表管理系统

**Repository Path**: starry123/RuoVea.Report

## Basic Information

- **Project Name**: 企业级报表管理系统
- **Description**: 一款基于 .NET Core 6.0 构建的现代化企业级报表管理系统，致力于为企业提供高效、安全、易用的数据报表解决方案。系统采用模块化架构设计，支持多数据源配置，具备完善的权限管理和日志审计功能。
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-10-21
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RuoVea.Report - 企业级报表管理系统

## 🌟 产品概述

RuoVea.Report 是一款基于 .NET Core 6.0 构建的现代化企业级报表管理系统，致力于为企业提供高效、安全、易用的数据报表解决方案。系统采用模块化架构设计，支持多数据源配置，具备完善的权限管理和日志审计功能。

![仪表盘](Doc/img/仪表盘.png)

![仪表盘设计](Doc/img/仪表盘设计.png)

## 🏗️ 技术架构

### **核心技术栈**
- **后端框架**：.NET Core 6.0
- **前端框架**：Avue（基于Vue的响应式UI框架）
- **数据库支持**：Sqlite / MySQL / SQL Server（多数据库支持）
- **部署方式**：Docker容器化 / IIS传统部署
- **安全机制**：数据加密、访问控制、操作审计

### **架构优势**
- ✅ **跨平台兼容** - 支持Windows、Linux、macOS系统部署
- ✅ **高性能处理** - 优化的数据查询和报表生成引擎
- ✅ **企业级安全** - 多层次安全防护和数据隐私保护
- ✅ **高可扩展性** - 模块化设计，支持功能灵活扩展
- ✅ **容器化部署** - Docker支持，简化部署运维流程

## 🚀 快速部署

### **Docker 一键部署**

**方式一：直接运行**
```bash
docker run --name RuoVea.Report-container \
-p 8080:80 \
-e "ConnectionConfigs:0:DbType=Sqlite" \
-e "ConnectionConfigs:0:ConnectionString=DataSource=./RuoVea.Report.db" \
-e "ConnectionConfigs:0:EnableUnderLine=false" \
-e TZ=Asia/Shanghai \
--restart=always \
crpi-ued86xnwae548w9p.cn-shenzhen.personal.cr.aliyuncs.com/ruovea/RuoVea.Report-img:latest
```

**方式二：Docker Compose部署**
```yaml
version: '3.9'
services:
  ruovea-report:
    image: 'crpi-ued86xnwae548w9p.cn-shenzhen.personal.cr.aliyuncs.com/ruovea/RuoVea.Report-img:latest'
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - 'ConnectionConfigs:0:EnableUnderLine=false'
      - 'ConnectionConfigs:0:ConnectionString=DataSource=./RuoVea.Report.db'
      - 'ConnectionConfigs:0:DbType=Sqlite'
    ports:
      - '8080:80'
    container_name: RuoVea.Report-container
```

执行命令：
```bash
docker-compose up -d
```

### **IIS 传统部署**
1. 从官网下载最新安装包
2. 配置IIS服务器环境
3. 解压文件到网站目录
4. 配置数据库连接字符串
5. 启动网站服务并验证访问

## 🔐 系统访问

### **默认登录账户**
| 角色 | 用户名 | 密码 | 权限说明 |
|------|--------|------|----------|
| 系统管理员 | admin | 123456 | 完全系统权限 |
| 普通用户 | ruovea | 123456 | 基础报表权限 |

> **安全提示**：首次登录后请立即修改默认密码，确保账户安全。

## 📊 核心功能

### **1. 用户管理模块**
![用户管理](/Doc/img/user.png)
- **用户信息管理**：完整的用户CRUD操作
- **权限分配**：基于角色的权限控制系统
- **状态监控**：用户登录状态和活动追踪

### **2. 系统配置中心**
![系统设置](/Doc/img/setting.png)
- **参数配置**：灵活的系统参数调整
- **个性化设置**：支持界面主题和布局自定义
- **数据源管理**：多数据源连接配置

### **3. 全方位日志系统**

- **🔍 差异日志** - 数据变更追踪审计
  ![差异日志](/Doc/img/log-diff.png)

- **🌐 访问日志** - 用户行为轨迹记录
  ![访问日志](/Doc/img/log-vis.png)

- **⚙️ 操作日志** - 系统操作完整记录
  ![操作日志](/Doc/img/log-op.png)

- **🚨 异常日志** - 系统异常实时监控
  ![异常日志](/Doc/img/log-ex.png)

### **4. 报表管理**

#### **4.1 报表列表**
![报表列表](/Doc/img/报表-列表.png)

报表列表页面集中展示系统中所有已创建的报表，提供便捷的管理和操作入口。

**功能特点**：
- 📋 **报表浏览**：以列表形式展示所有报表，支持按名称、创建时间等排序
- 🔍 **快速搜索**：支持按报表名称、类型等条件进行筛选查询
- ✏️ **编辑修改**：点击报表条目可直接进入编辑模式，修改报表配置
- 🗑️ **删除管理**：支持批量删除或单个删除不需要的报表
- 📤 **导出分享**：支持将报表导出为多种格式（Excel、PDF等）

**使用说明**：
1. 登录系统后，在左侧菜单点击「报表管理」→「报表列表」
2. 在列表中可以查看所有报表的基本信息（名称、类型、创建时间、状态等）
3. 点击报表名称可预览报表内容
4. 使用操作列的按钮进行编辑、复制、删除等操作

---

#### **4.2 报表设计器**
![报表设计](/Doc/img/报表设计.png)

报表设计器是系统的核心功能，提供可视化拖拽式报表设计能力，无需编写代码即可创建专业报表。

**功能特点**：
- 🎨 **可视化设计**：拖拽式操作，所见即所得的报表设计体验
- 📊 **丰富图表类型**：支持柱状图、折线图、饼图、数据表格等多种展示形式
- 🔗 **多数据源支持**：可连接 MySQL、SQL Server、SQLite 等多种数据库
- 💾 **SQL编辑器**：内置SQL编辑器，支持语法高亮和智能提示
- 📐 **灵活布局**：支持自定义报表布局、样式和配色方案
- 🔄 **实时预览**：设计过程中可实时预览报表效果

**使用步骤**：
1. 进入「报表管理」→「报表设计」
2. 点击「新建报表」创建空白报表
3. 配置数据源连接（选择已配置的数据源或新建连接）
4. 编写SQL查询语句，获取所需数据
5. 选择图表类型，配置数据绑定
6. 调整样式和布局，设置标题、图例等
7. 保存并发布报表

---

#### **4.3 示例报表展示**

系统内置多种示例报表模板，展示报表系统的强大数据可视化能力：

**📊 文章分类占比（饼图）**
![文章分类占比](/Doc/img/文章分类占比.png)

![文章分类占比](/Doc/img/文章分类占比设计.png)

饼图适用于展示数据的占比分布情况，直观呈现各分类的相对比例。

**适用场景**：
- 数据分类占比分析
- 市场份额分布
- 资源分配统计
- 预算使用情况

---

**📈 文章分类统计（柱状图）**
![文章分类统计](/Doc/img/文章分类统计.png)

![文章分类统计设计](/Doc/img/文章分类统计设计.png)

柱状图适合比较不同类别之间的数据差异，清晰展示各类别的数值大小。

**适用场景**：
- 销售业绩对比
- 部门绩效分析
- 产品销量排名
- 时间序列数据对比

---

**🔢 文章总数（数据卡片）**
![文章总数](/Doc/img/文章总数.png)

数据卡片用于突出展示关键指标（KPI），一目了然地呈现核心数据。

**适用场景**：
- 核心业务指标展示
- 实时数据监控
- 目标完成进度
- 重要数据提醒

---

**📉 每日发布（折线图）**
![每日发布](/Doc/img/每日发布.png)

折线图适合展示数据随时间的变化趋势，便于分析数据走势和规律。

**适用场景**：
- 趋势分析
- 时间序列数据
- 同比/环比分析
- 预测与规划

## ⚙️ 高级配置

### **数据库配置选项**
```bash
# 支持多种数据库类型
-e "ConnectionConfigs:0:DbType=Sqlite|MySQL|SQLServer"

# 数据库连接字符串
-e "ConnectionConfigs:0:ConnectionString=Your_Connection_String"

# 字段命名风格（驼峰/下划线）
-e "ConnectionConfigs:0:EnableUnderLine=true|false"
```

### **审计功能配置**
```bash
# 数据审计字段映射
-e "DataAuditing:CreateTime=CreatedAt"
-e "DataAuditing:ModifyTime=UpdatedAt"
-e "DataAuditing:Creator=CreatedById"
-e "DataAuditing:Modifier=UpdatedById"
```

### **日志系统配置**
```bash
# 异常日志配置
-e "ExceptionLog:Enabled=true"
-e "ExceptionLog:LogToFile=true"
-e "ExceptionLog:LogMore=true"

# 请求日志配置
-e "RequestLog:Enabled=true"
-e "RequestLog:LogToFile=true"
-e "RequestLog:IgnoreApis="
```

## 💡 产品特色

### **企业级特性**
- 📚 **完善文档** - 详细的培训和使用文档
- 🌍 **国际化支持** - 多语言界面，内置I18n配置
- 🔄 **数据初始化** - 智能SeedData数据预置
- 🛡️ **安全可靠** - 多层次安全防护机制

### **开发友好**
- 🎯 **标准化接口** - RESTful API设计规范
- 🔧 **灵活配置** - 丰富的环境变量配置选项
- 📈 **性能监控** - 系统运行状态实时监控
- 🐛 **调试支持** - 详细的日志输出和错误追踪

## 📄 许可证

本项目采用 **MIT 开源许可证**，允许商业使用、修改和分发。详情请参阅项目根目录下的 LICENSE 文件。

---

**开始使用 RuoVea.Report，让数据报表管理变得更简单、更高效！** 🎉

如需更多技术支持，请访问项目文档或联系开发团队。