# RuoVea.Predict

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

## Basic Information

- **Project Name**: RuoVea.Predict
- **Description**: 销售预测系统是一个基于 .NET Core 8.0 构建的现代化应用，集成了广告成本预测、训练数据管理和预测历史记录等功能，为企业提供数据驱动的销售预测解决方案。系统采用现代化的前后端技术栈，具有良好的扩展性和可维护性。
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 销售预测系统

## 介绍
销售预测系统是一个基于 .NET Core 8.0 构建的现代化应用，集成了广告成本预测、训练数据管理和预测历史记录等功能，为企业提供数据驱动的销售预测解决方案。系统采用现代化的前后端技术栈，具有良好的扩展性和可维护性。


## 🛠️ 软件架构
**技术栈**：
- **后端**：.NET Core 8.0 + MVC
- **前端**：Vue.js 2.6.x + Element UI + Avue + axios
- **ORM**：SqlSugar
- **认证**：JWT + RuoVea.OmiLogin
- **数据库**：默认 SQLite，支持多数据库切换
- **日志**：RuoVea.OmiLog
- **国际化**：内置多语言支持

### 前端技术栈详解
- Vue.js 2.6.x - 核心前端框架
- Element UI - UI组件库
- Avue - 高级表格组件库，提供CRUD表格快速实现
- axios - HTTP客户端，用于前后端数据交互
- i18n国际化支持 - 多语言切换功能

## 📥 安装教程

  **部署方式**：IIS部署，简单几步即可完成安装。

### **详细步骤**
1. **下载软件**：从官方网站下载最新版本的RuoVea.Predict安装包。
2. **安装IIS**：确保您的服务器已安装IIS，并配置好相关设置。
3. **部署应用**：将安装包解压到指定目录，并在IIS中创建新的网站。
4. **配置数据库**：按照指南配置数据库连接，确保软件能够正常访问数据。
5. **启动服务**：启动IIS中的RuoVea.Predict服务，并通过浏览器访问以验证安装是否成功。

### 1、Docker部署


方式1、直接复制代码  控制台运行

```bash

docker run --name RuoVea.Predict-container ^
-p YOU_PORT:8080 ^
-e "ConnectionConfigs:0:DbType=Sqlite" ^
-e "ConnectionConfigs:0:ConnectionString=DataSource=./RuoVea.Predict.db" ^
-e "ConnectionConfigs:0:EnableUnderLine=false" ^
-e TZ=UTC ^
-e TZ=Asia/Shanghai ^
--restart=always ^
crpi-ued86xnwae548w9p.cn-shenzhen.personal.cr.aliyuncs.com/ruovea/RuoVea.Predict-img:latest
pause

```

方式2、docker-compose 部署

在文件下中  执行下面命令

```bash
version: '3.9'
services:
    RuoVea.Predict-img:
        image: 'crpi-ued86xnwae548w9p.cn-shenzhen.personal.cr.aliyuncs.com/ruovea/RuoVea.Predict-img:latest'
        restart: always
        environment:
            - TZ=Asia/Shanghai
            - TZ=UTC
            - 'ConnectionConfigs:0:EnableUnderLine=false'
            - 'ConnectionConfigs:0:ConnectionString=DataSource=./RuoVea.Predict.db'
            - 'ConnectionConfigs:0:DbType=Sqlite'
        ports:
            - 'YOU_PORT:8080'
        container_name: RuoVea.Predict-container


```

启动 运行

```bash
docker-compose up -d
```

其它配置参数

```basic
-e "ConnectionConfigs:0:DbType=Sqlite" ^
-e "ConnectionConfigs:0:ConnectionString=DataSource=/RuoVea.Predict.db" ^
-e "ConnectionConfigs:0:EnableUnderLine=true" ^

-e "DataAuditing:CreateTime=CreatedAt" ^
-e "DataAuditing:ModifyTime=UpdatedAt" ^
-e "DataAuditing:Creator=CreatedById" ^
-e "DataAuditing:Modifier=UpdatedById" ^
-e "DataAuditing:TenantId=TenantId" ^
-e "DataAuditing:IsDelete=IsDelete" ^

-e "ExceptionLog:Enabled=true" ^
-e "ExceptionLog:LogToFile=true" ^
-e "ExceptionLog:LogMore=true" ^

-e "RequestLog:Enabled=true" ^
-e "RequestLog:LogToFile=true" ^
-e "RequestLog:LogMore=true" ^
-e "RequestLog:IgnoreApis=" ^

-e TZ=Asia/Shanghai ^
```




## 📋 核心功能

- **销售预测**：基于广告成本进行销售预测，提供直观的预测结果展示
- **训练数据管理**：管理预测模型的训练数据，支持数据的添加、编辑和删除
- **预测历史记录**：记录历史预测结果，方便查看和分析预测趋势
- **用户管理**：支持用户的创建、编辑和权限管理
- **角色管理**：基于角色的权限控制系统，确保数据安全
- **系统日志**：详细的操作日志、访问日志和异常日志，便于系统维护

## 📋 项目特点

- 现代化的前后端技术栈，开发效率高
- 支持多数据库连接配置，灵活适应不同环境
- 响应式布局设计，适配不同设备
- 支持国际化，提供多语言支持
- 完善的错误处理和日志系统
- 良好的代码结构和文档，便于维护和扩展

## 📋 使用说明

### **默认管理员**

- **账号**：admin  
- **密码**：123456  

默认用户

- **账号**：ruovea
- **密码**：123456  

初始化密码可在项目配置文件中配置，初始化后，数据库中的用户密码将是默认密码加密后的数据。提高安全性。

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

### **登录界面**

![Img](/Doc/img/login.png)

**操作说明**：输入正确的账号和密码，点击“登录”按钮进入系统。如果忘记密码，可以点击“找回密码”进行重置。

### **销售预测功能**

![Img](/Doc/img/销售预测.png)

**功能描述**：销售预测功能允许用户输入广告成本，系统会基于训练模型预测销售结果。

**操作说明**：
1. 在左侧菜单中点击“销售预测”进入预测页面
2. 在广告成本输入框中输入广告成本金额
3. 点击“执行预测”按钮
4. 系统会显示预测的销售结果

### **训练数据管理**

![Img](/Doc/img/训练数据.png)

**功能描述**：训练数据管理功能允许用户管理用于模型训练的数据，包括添加、编辑和删除训练数据。

**操作说明**：
1. 在左侧菜单中点击“训练数据管理”进入数据管理页面
2. 可以查看现有训练数据列表
3. 点击“添加”按钮添加新的训练数据
4. 点击“编辑”按钮修改现有训练数据
5. 点击“删除”按钮删除不需要的训练数据

### **预测历史记录**

![Img](/Doc/img/预测历史.png)

**功能描述**：预测历史记录功能记录了所有历史预测结果，方便用户查看和分析预测趋势。

**操作说明**：
1. 在左侧菜单中点击“预测历史记录”进入历史记录页面
2. 可以查看所有历史预测记录
3. 可以根据时间、广告成本等条件筛选记录
4. 可以导出历史记录数据

### **用户管理**

![Img](/Doc/img/user.png)

**功能描述**：在用户管理界面，可以查看所有用户的基本信息，包括用户名、注册日期、最后登录时间等。支持用户搜索、筛选和批量操作。

### **用户添加**

![Img](/Doc/img/user-add.png)

**操作说明**：点击“添加用户”按钮，填写用户的基本信息，如用户名、密码、邮箱等，然后点击“创建”完成新用户添加。

### **系统设置**

![Img](/Doc/img/setting.png)

**功能描述**：系统设置界面允许管理员配置软件的各项参数，如数据备份路径、邮件服务器设置、通知模板等。

### **系统设置-编辑**

![Img](/Doc/img/setting-edit.png)

**操作说明**：选择需要修改的设置项，点击“编辑”按钮，修改参数后点击“保存”应用更改。

### **系统设置后-登录界面**

![Img](/Doc/img/login-after.png)

**说明**：完成系统设置后，登录界面会根据新的配置进行更新，确保用户体验的一致性。

### **系统日志**

- **差异日志**  
  ![Img](/Doc/img/log-diff.png)  
  **描述**：记录系统中数据的变更历史，帮助管理员追踪数据修改情况。

- **访问日志**  
  ![Img](/Doc/img/log-vis.png)  
  **描述**：记录用户的登录和访问行为，提供详细的访问时间、IP地址等信息。

- **操作日志**  
  ![Img](/Doc/img/log-op.png)  
  **描述**：记录管理员和用户的操作行为，如添加、编辑、删除数据等。

- **异常日志**  
  ![Img](/Doc/img/log-ex.png)  
  **描述**：记录系统运行中的错误和异常情况，帮助开发者快速定位和解决问题。



**安全建议：**
- 生产环境务必更换默认的密钥（IssuerSigningKey），使用强随机密钥
- 调整合适的过期时间（ExpiredTime），平衡安全性和用户体验
- 生产环境建议使用HTTPS传输，防止JWT令牌被窃取
- 定期更换JWT密钥，特别是在系统升级或安全事件发生时

2. **性能优化**
   - 使用缓存减少数据库访问
   - 优化查询语句
   - 启用异步操作

3. **部署建议**
   - 使用 Docker 容器化部署
   - 配置反向代理（Nginx/Apache）
   - 启用负载均衡


### 许可证

本项目使用 MIT 许可证，请查看 LICENSE 文件获取更多详情。