README

在寻找好的Laravel编写的学校管理系统时，我尝试了这么多，尽管大多数都非常好，但它们缺少一些我希望在系统中拥有的基本功能。这使得我热衷于构建自己的学校管理系统。虽然这很困难，但它实际上正在成为一个相当实用的项目。

恭喜，SKUUL V2已发布

Skuul很棒，但它在UI速度和应用卡顿等一些方面存在一些不足，随着应用的增长。V2修复了这些问题，并提高了可访问性。

V2速度更快，随着应用的扩展，不会显著减慢。升级也应该相对容易。要求保持不变，只有一个例外，我们现在需要Node进行资源打包。如果你没有Node，不用担心，有解决方案

Skuul是一个多学校管理系统，旨在利用互联网和增强的连通性，使学校管理和活动变得轻松。

要求

• PHP 8.1及以上
• Composer
• 由于本项目运行Laravel 9，我们建议查看官方要求这里
• Npm

安装

要跳过步骤4以下（在composer install之后），您可以运行以下命令，它会自动引导您完成整个过程

php artisan skuul:init

• 在命令行中运行以下命令以克隆存储库（或者您可以从GitHub下载zip文件）

git clone https://github.com/yungifez/skuul ./skuul

• 转到项目的目录

cd skuul

• 安装Composer依赖

composer install

• 将.env.example文件复制到.env文件中，并根据您的环境进行配置

cp .env.example .env

• 安装Node依赖

npm install

• 构建NPM资产

  npm run build

注意，如果您没有Node，您可以在本地环境中这样做，并使用FTP程序将publi/build文件夹和manifest.json文件夹上传到您的服务器

• 生成加密密钥

php artisan key:generate

• 迁移数据库

php artisan migrate

• 数据库填充

  您可以通过两种方式填充数据库

  • 对于生产环境，即您的实时服务器

    php artisan db:seed --class RunInProductionSeeder

  • 对于测试或开发目的

    php artisan db:seed

• 填充数据库以填充国家（大约需要10分钟）

php artisan db:seed --class=WorldSeeder

• 通过在public img文件夹中添加它并相应地编辑.env logo路径来设置应用程序徽标
• 将favicon存储在路径public/favicons/中，文件应命名为favicon.ico
• 对于开发或测试目的，您可以使用Laravel内置服务器，通过运行

php artisan serve

如果您在生产环境中运行，请访问您的域名以验证它是否正常工作

运行上述命令后，您应该能够通过http::/localhost或您指定的域名访问应用程序，具体取决于配置。

更新

通常，您可以通过以下步骤更新大多数内容

• 克隆新版本
• composer update
• php artisan optimize:clear
• php artisan migrate（请确保备份数据库）
• php artisan db:seed --class RunInProductionSeeder

设置

• 使用以下凭据登录应用程序

  • 电子邮件：super@admin.com
  • 密码：password

• 您将需要更改密码，在个人资料页面更改密码以继续

• 如果您在生产环境中

  • 登录后，您将被重定向到一个带有错误消息的页面，该消息位于右上角，内容为“请先设置您的操作学校”。在菜单中，点击创建学校。
  • 在创建学校的页面，提供您学校的名称、地址和初始信息，然后点击创建学校。
  • 点击查看学校，选择当前学校，然后点击设置学校按钮。
  • 现在您可以前往仪表盘。
  • 您现在可以开始添加班级、学生、教师等。一些操作可能无法正常工作，特别是学术部分下的所有链接。
  • 前往学年页面，创建一个新的学年和一个新的学期，然后设置学年学期。

• 如果您正在开发或测试，数据已预设为测试并使用应用程序。

用法

• 将班级组添加到学校。
• 将课程添加到班级组。
• 将班次添加到课程。
• 将学生添加到班次（您必须先创建一个班级和班次，才能添加学生）。
• 将教师添加到学校。
• 将科目添加到学校。

功能

超级管理员

默认情况下，超级管理员可以管理每个学校的所有活动，一些超级管理员专有的功能包括：

• 创建、编辑和删除学校的权限

设置操作学校的权限

• 管理员
• 管理自己的学校设置的能力
• 在分配的学校中创建、编辑、查看和删除班级组的能力
• 创建、编辑、查看和删除课程的能力
• 在分配的学校中创建、编辑、查看和删除班级组的能力
• 创建、编辑、查看和删除班次的能力
• 创建、编辑、查看和删除科目的能力
• 设置学年的能力
• 录取学生、查看学生档案、编辑学生档案、打印学生档案和删除学生的能力
• 创建教师、编辑教师档案和删除教师的能力
• 创建、编辑、管理、查看和删除课表的能力
• 创建、编辑、查看和删除教学大纲的能力
• 创建、编辑、查看和删除学期的能力
• 设置自己的学校学年学期的能力

教师

• 创建、编辑、查看和删除教学大纲的能力
• 创建、编辑、管理、查看和删除课表的能力

该项目深受4jean/lavSMS的启发。

您喜欢这个项目的当前状态吗？您可以支持我或雇佣我工作。

待办事项

• 创建演示网站（目前，您可以访问yungifez.xyz，可能会有些混乱，但值得一试。使用密码helloworld登录超级管理员账户）。
• 创建标志。
• 需要帮助创建演示视频。
• 使用类似larecipe的工具编写文档。
• 编写问题和贡献模板文件等。