# konmorReportServer

**Repository Path**: konmor/konmor-report-server

## Basic Information

- **Project Name**: konmorReportServer
- **Description**: 用于EasyReports项目的后台服务。提供数据库访问，数据缓存
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-12
- **Last Updated**: 2025-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue, ant-desgin-vue, 报表, 可视化, Echarts

## README

# KonmorReportServer

#### 介绍

用于KonmorReport项目的后台服务。提供数据库访问，数据缓存

### 版本依赖

SpringBoot 2.7.12

MySQL 8

JDK 8

JOOQ 3.14.16

StarRocks Latest-3.5

### 代码结构

- 模块

  [launcher](launcher) 启动器

  [model](model) 数据模型

  [repository](repository) 仓储接口

  [repositoryImpl](repositoryImpl) 仓储实现

  [uerInterface](uerInterface) 用户接口

- 代码结构

```bash
├─launcher
│  └──src
│     └─main
│         ├─java
│         │  ├─com
│         │  │  └─konmor
│         │  │      └─config 各类配置
│         │  └─com.konmor 启动器
│         └─resources 配置 application.yml
│
├─MockData 模拟数据
├─model    数据库模型、数据传输对象
│  └─src
│    └─main
│         └─java
│            └─com
│                └─konmor
│                    ├─code
│                    │  └─generator  由JOOQ代码生成的数据库对象
│                    │      ├─enums
│                    │      └─tables
│                    │          ├─daos
│                    │          ├─interfaces
│                    │          ├─pojos
│                    │          └─records
│                    ├─convert 对象转换 由DTO 转换为数据库对象 或 反转换
│                    ├─dto     数据传输对象
│                    │  └─base 
│                    └─pojo 
│
├─repository  仓储接口
│  └─src
│     └─main
│         └─java
│            └─com
│                └─konmor
│                    └─manager
│                        └─datasource  多数据源数据库接口抽象层
│
├─repositoryImpl  多数据源数据库接口实现层
│  └─src
│     └─main
│         └─java
│            └─com
│                └─konmor
│                    ├─manger
│                    │  └─datasource
│                    │      └─mysql 多数据源数据库接口实现层 MYSQL 8 实现
│                    └─repositoryImpl
│                        ├─jooq  多数据源数据库接口实现层 JOOQ 实现
│                        └─jpa   多数据源数据库接口实现层 JPA 实现
│
└─uerInterface   用户接口  对外接口
    └─src
       └─main
           └─java
              └─com
                  └─konmor
                      ├─base
                      ├─config
                      ├─controller  
                      ├─convert
                      ├─manager   业务下沉 用于处理具体业务 如mysql 创建链接的检查
                      │  └─datasource
                      │      └─mysql
                      └─service

```

### 多数据源适配

#### 适配进度

| 数据库        | 适配进度 | 特殊            | 备注  |
|------------|------|---------------|-----|
| MySQL 8    | 100% | SSL 与 SSH 未适配 ||
| MySQL 5    | 0    |||
| PostgreSQL | 0    |||
| Oracle     | 0    |||
| SQLite     | 0    |||
| MariaDB    | 0    |||

#### 适配方式

- 实现该包下的接口 com.konmor.manager.datasource
- 包内容
  ![img_1.png](img_1.png)
- 参考com.konmor.manger.datasource.mysql的实现

### 开发进度

#### 25年3月 - 25年7月

| 内容                    | 进度   | 难度  | 优先级     |
|-----------------------|------|-----|---------|
| MySQL 8 数据源           | 100% | 容易  | Level 3 |
| MySQL 8 sql查询，表格、视图查询 | 100% | 容易  | Level 3 |
| 数据聚合与过滤               | 0%   | 难   | Level 2 |
| 联动、钻取                 | 0%   | 难   | Level 2 |
| 数据仓储                  | 0%   | 中等  | Level 3 |
| 数据仓储适配：聚合过滤，联动钻取      | 0%   | 难   | Level 2 |

### 安装教程

#### 数据模型 
- 仅数据源元数据部分
![img.png](img.png)

#### 部署步骤

1. 按照数据模型，创建元数据表结构：[Meta.sql](Meta.sql)
2. [launcher](launcher) 调整 [application.yml](launcher%2Fsrc%2Fmain%2Fresources%2Fapplication.yml)
3. 启动[launcher](launcher) 即可 ps 部署 linux上使用`easy-reports-server` 进行打包，使用`launcher.jar` 包部署