# HuiTong-Cloud **Repository Path**: fromdrowning/huitong-cloud ## Basic Information - **Project Name**: HuiTong-Cloud - **Description**: 慧通教务系统是基于RuoYi-Cloud-Plus二次开发的一个项目，同时也是强智教务系统的升级版，对原有的架构进行重构，业务代码调整优化，编码遵循阿里巴巴开发规范 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 1 - **Created**: 2024-05-07 - **Last Updated**: 2024-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: Java, SpringBoot, SpringCloud ## README

慧通教务系统（HuiTong-Cloud)

- - - ## 项目简介 慧通教务系统是基于RuoYi-Cloud-Plus二次开发的一个项目，同时也是强智教务系统的升级版，对原有的架构进行重构，业务代码调整优化，编码遵循阿里巴巴开发规范 ## 相关链接 RuoYi-Cloud-Plus地址：[RuoYi-Cloud-Plus](https://gitee.com/dromara/RuoYi-Cloud-Plus) 前端地址：[慧通教务系统前端](https://gitee.com/fromdrowning/huitong-vue) 项目地址：[慧通教务系统后端](https://gitee.com/fromdrowning/huitong-cloud) 旧项目前端地址：[强智教务系统前端](https://gitee.com/fromdrowning/qiangzhi-vue) 旧项目后端地址：[强智教务系统后端](https://gitee.com/fromdrowning/qiangzhi-academic-affairs) ## 项目架构 ![](./assets/2024-05-24_11-45-40.png) ## 文件结构 ``` huitong-cloud ├─ assets // 项目说明文件图片 ├─ config // 项目配置文件 │ └─ nacos // Nacos配置文件 │ └─ sql // SQL配置文件 ├─ http // 项目接口测试文件 ├─ huitong-admin // 教务端模块 │ └─ huitong-admin-bom // 依赖配置 │ └─ huitong-admin-system // 教务端系统服务 [9201] ├─ huitong-api // 接口模块 │ └─ huitong-api-bom // 依赖配置 │ └─ huitong-api-system // 系统接口模块 ├─ huitong-auth // 认证授权服务 [9210] ├─ huitong-common // 通用模块 │ └─ huitong-common-bom // 依赖配置 │ └─ huitong-common-core // 核心模块 │ └─ huitong-common-dubbo // 远程调用模块 │ └─ huitong-common-json // 序列化模块 │ └─ huitong-common-mybatis // 数据库模块 │ └─ huitong-common-nacos // 注册中心和配置管理模块 │ └─ huitong-common-redis // 缓存模块 │ └─ huitong-common-satoken // 令牌模块 │ └─ huitong-common-security // 权限安全模块 │ └─ huitong-common-sentinel // 熔断降级限流模块 ├─ huitong-gateway // 网关服务 [8080] ├─ huitong-oss // 文件上传服务 [9204] ├─ huitong-visual // 图形化管理模块 │ └─ huitong-visual-nacos // 注册中心和配置管理服务 [8848] │ └─ huitong-visual-sentinel // 熔断降级限流服务 [8718] ├─ .editorconfig // 编辑器编码格式配置 ├─ LICENSE // 开源协议 ├─ pom.xml // 公共依赖 ├─ README.md // 项目说明文件 ├─ 开发手册.pdf // 开发手册 ``` ## 运行项目 ### 运行环境 - JDK >= 17 - Maven >= 3.8.x - MySQL >= 5.7.x/8.0.x - Redis >= 5.x/6.x/7.x - IDEA ≠ 2023（2023版本IDEA有BUG，经常容易出错跑不起本项目） ### 运行准备 将项目sql文件夹下的sql文件都导入到数据库中 ![](./assets/2024-05-08_15-59-36.png) ![](./assets/2024-05-07_20-27-31.png) 配置huitong-visual-nacos模块下application.properties文件，将db.user.0和db.password.0修改为自己数据库账号和密码 ![](./assets/2024-05-24_11-21-56.png) 启动huitong-visual-nacos服务，点击控制台输出的链接进入Nacos 账号nacos 密码nacos ![](./assets/2024-05-24_11-35-37.png) 将nacos文件夹下所有配置文件内容复制到Nacos对应的配置中 ![](./assets/2024-05-24_11-22-56.png) ![](./assets/2024-05-24_11-27-42.png) 注意还要将pom.xml下的nacos地址更改为自己的naocs地址 ![](./assets/2024-05-24_11-29-32.png) 注意复制的时候需要将huitong-common.yml和huitong-datasource.yml中Redis和MySQL配置修改为自己的配置 ![](./assets/2024-05-07_20-38-02.png) ![](./assets/2024-05-07_20-38-39.png) 如需使用文件上传服务，huitong-oss.yml文件内的配置也需要修改为自己的配置，申请阿里云OSS网上有很多教程 ![](./assets/2024-05-24_11-31-38.png) ### 启动项目 在启动项目前需确认MySQL和Redis均已配置并启动好（[Redis下载地址](https://github.com/zkteco-home/redis-windows)） 按顺序启动huitong-visual-nacos、huitong-gateway、huitong-auth、huitong-admin-system（其余服务可以按需启动） ![](./assets/2024-05-08_16-32-41.png) 启动前端项目，进入前端页面输入 账号202110003886 密码Cyh1975865247 ![](./assets/2024-05-08_16-34-40.png) 显示首页即登录成功 ![](./assets/2024-05-08_16-35-24.png) 补充：如需使用Sentinel控制台，控制台的账号密码为 账号sentinel 密码sentinel ## 项目开发 ### 开发规约 想进行二次开发或为原代码提供贡献请仔细阅读[开发手册](./开发手册.pdf)。 ### 开发插件 推荐安装以下插件，能大大提高开发效率，每个插件具体如何使用b站上都能搜到详细的视频教程。 1. **CodeGeeX** AI生成与补全代码 2. **Smart Input** 自动切换输入法 3. **MyBatisX** Mapper映射类和XML跳转 自动生成XML方法 4. **Rainbow Brackets** 提供彩虹颜色的括号 更清晰地分清括号个数 5. **Easy Javadoc** Javadoc注释生成