开源项目常见问题解决方案

开源项目常见问题解决方案

teaching-open Scratch少儿编程教学平台，集成Scratch、ScratchJr、Python教学工具。包含课程、班级、作业、权限、社区等。 项目地址: https://gitcode.com/gh_mirrors/te/teaching-open

1. 项目基础介绍和主要编程语言

该项目名为Teaching Open，是一个针对机构、学校提供的STEAM在线教育解决方案。它集成了Scratch、ScratchJr、Python等教学工具，并提供了一系列功能，包括课程、班级、作业、权限、社区等。项目旨在提供一个低成本试错的机会，帮助教育机构实现线上教育。

主要编程语言和框架包括：

• 后端技术：Spring Boot、MyBatis-Plus、Shiro、JWT、Swagger、Redis
• 前端技术：Ant Design Vue、Vue、Webpack
• 其他技术：Druid、Logback、POI、Quartz、lombok、七牛云存储、Scratch二次开发

2. 新手使用项目时需特别注意的3个问题及解决步骤

问题一：如何配置和部署项目？

解决步骤：

1. 环境准备：确保服务器已安装MySQL 5.6和Redis 6.0。
2. 数据库配置：导入api/db文件夹的sql文件，确保lower_case_table_names=1已设置，以忽略表名的大小写。
3. 编译项目：在api目录下执行mvn clean package进行编译，成功后得到jar文件。
4. 配置文件：修改application-prod.yml配置文件，根据实际需求设置数据库、Redis、七牛云等相关配置。
5. 部署：将编译好的jar文件部署到服务器，运行jar文件，确保所有配置正确。

问题二：如何在项目中集成Scratch或Python？

解决步骤：

1. 了解文档：详细阅读项目文档，了解如何使用Scratch和Python教学工具。
2. 二次开发：根据项目提供的Scratch和Python接口进行二次开发。
3. 功能测试：在集成后进行功能测试，确保Scratch和Python功能按预期工作。

问题三：如何处理项目运行中出现的权限问题？

解决步骤：

1. 检查配置：检查application-prod.yml中的权限设置是否正确。
2. 角色管理：确保系统中的角色和权限设置正确无误。
3. 权限验证：在代码中检查权限验证逻辑，确保每个操作都正确处理了权限验证。
4. 日志排查：如果出现权限问题，查看系统日志，分析错误原因，并根据错误信息进行修复。

teaching-open Scratch少儿编程教学平台，集成Scratch、ScratchJr、Python教学工具。包含课程、班级、作业、权限、社区等。 项目地址: https://gitcode.com/gh_mirrors/te/teaching-open