# Witdata

**Repository Path**: yiranxiaohui/witdata

## Basic Information

- **Project Name**: Witdata
- **Description**: 智慧数据库教育平台
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-07
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智数

#### 介绍
智数——基于大数据与RAG大模型的 数据库课程智能实践教学平台，分为手机端、电脑端，拥有完善的后台管理系统。

#### 软件架构

后端采用Maven进行项目管理，pom作为父依赖文件，各个模块下有子pom，
使用SpringBoot作为快速开发框架。

前端采用 Tauri2.0 + Vue3 + Ts

中后台管理系统采用 Vue3 + Ts

### 目录结构

bin 打包后的文件和运行脚本

config 系统配置文件

proto Grpc服务定义文件

sql 系统初始化的SQL脚本（创建表时，务必更新）

witdata-admin 后台管理系统的前端页面

witdata-api 后端接口模块，包含接口定义，后端程序启动

witdata-common 后端公共模块，包含各种组件

witdata-framework 后端服务模块

witdata-mqtt 后端mqtt连接

witdata-mysql 后端mysql服务

witdata-quartz 后端定时任务服务

witdata-rabbit 后端rabbit消息队列服务

witdata-security 后端安全模块，负责用户的鉴权

#### 安装教程

1. 检查是否安装Rust（前端开发框架必须环境）

如未安装，则请到官网先安装Rustup，管理Rust

https://www.rust-lang.org/zh-CN/tools/install

安装完Rust之后，请安装工具链环境

https://v2.tauri.app/zh-cn/start/prerequisites/

2. 检查是否安装Java和Maven

3. 检查是否安装Nodejs

请先下载nodejs后，执行
```bash
npm -g install yarn
```

witdata-ui目录，执行
```bash
yarn # 下载依赖
yarn tauri dev # 运行代码
```
witdata-admin目录，执行
```bash
yarn # 下载依赖
yarn run dev # 运行代码
```

#### 开发说明

1. 前端开发
前端使用图标，默认使用SVG格式，存至components/icons里面

2. 代码提交规范
commit内容，请加前缀，比如fix、add、remove、edit，
代表修复，添加，移除，修改四个功能，如不懂，可以浏览git提交记录查看

### 部署教程
1. 后端服务部署（Docker方式）
```bash
docker pull web.yunnet.top:12500/witdata:latest
docker run -d \
  -e TZ=Asia/Shanghai \
  --restart always \
  -p 12888:12888 \
  --name witdata \
  web.yunnet.top:12500/witdata:latest
```
2. py服务部署（Docker方式）
```bash
docker pull web.yunnet.top:12500/witdata-py:latest
docker run -d \
  -e TZ=Asia/Shanghai \
  --restart always \
  -p 12800:12800 \
  web.yunnet.top:12500/witdata-py:latest
```

3. Docker探针服务（Docker方式）
```bash
docker pull web.yunnet.top:12500/docksense:latest

docker run \
  -v /proc:/proc \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart always \
  --network host -d \
  web.yunnet.top:12500/docksense:latest
```