# WaterQuality

**Repository Path**: mark-brown/WaterQuality

## Basic Information

- **Project Name**: WaterQuality
- **Description**: 水质预测平台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 110
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 水质预测平台
一个简易的水质预测平台

![License](https://img.shields.io/badge/License-MIT-yellow.svg)
![Codacy Badge](https://app.codacy.com/project/badge/Grade/751bdd64552340a09021094ab6366f87)
![前端模块版本](https://img.shields.io/badge/前端模块-3.0.1-blue.svg)
![用户管理模块](https://img.shields.io/badge/用户管理模块-0.2.2-blue.svg)
![模型管理模块](https://img.shields.io/badge/模型管理模块-0.2.0-blue.svg)

## 目前的功能
- 自动处理并从excel表格导入国控水质检测平台的水质数据
- 基本的前端，用户注册并登入后可以管理水质数据，查看历史趋势
- 后端可利用以往的水质数据训练模型，并预测下个月的水质（目前支持SVM/AdaBoost/LSTM/GRU/Bi-RNN）


## 技术栈
- 前端：TypeScript+Vue3+Vite
- 后端-用户管理模块：Kotlin+SpringBoot3+JPA+Sa-Token+OkHttps
- 后端-模型管理模块：Python+FastAPI+Pandas+Scikit-learn+Pytorch

```plaintext
WaterQuality/                  # 项目根目录
├── Database/                  # 数据库相关文件
├── Import/                    # 自动导入工具
├── Module-BackEnd-FastAPI/    # 后端-模型管理模块（FastAPI）
├── Module-BackEnd-KtSpring/   # 后端-用户管理模块（SpringBoot3）
└── Module-FrontEnd-Vue/       # 前端模块（Vue3）
```

## 简单体验
1. （可选）更改后端/导入工具的数据库用户名/密码/数据库名配置
2. 使用默认数据库凭据（用户名密码均为root）创建名为water的数据库，并导入`Database`下的表结构
3. pip安装相关依赖后，使用`Import`下的工具导入水质数据到数据库
4. 在`Module-FrontEnd-Vue`中启动前端
5. 在`Module-BackEnd-KtSpring`中启动用户管理模块
6. 在`Module-BackEnd-FastAPI`中启动模型管理模块
7. 登入`127.0.0.1:8081`，使用默认管理员账号（用户名admin，密码123）登入网站
8. ...

**注意**: **项目本身仅供学习**，若不进行多余的配置，**不建议直接用于生产环境**

## 系统架构流程图
![系统架构流程图](Flow.jpg)

## TODOs
- [x] 使用TS重构前端模块
- [ ] 尝试继续优化用户管理模块（正在进行）
    - [x] ~~使用Sa-Token进行鉴权~~(0.2.1已实现)
    - [x] ~~使用OkHttps进行Http服务(0.2.2)~~(0.2.2已实现)

## 特别感谢
@Jetbrains IDE开发支持

@sctpan 本项目部分引用其[水质管理与预测系统1.0](https://github.com/sctpan/WQMFS)的代码并对其进行重构