hrshadhin/school-management-system

CloudSchool

                       _____  _                    _   _____        _                    _ 
                      / ____|| |                  | | / ____|      | |                  | |
                     | |     | |  ___   _   _   __| || (___    ___ | |__    ___    ___  | |
                     | |     | | / _ \ | | | | / _` | \___ \  / __|| '_ \  / _ \  / _ \ | |
                     | |____ | || (_) || |_| || (_| | ____) || (__ | | | || (_) || (_) || |
                      \_____||_| \___/  \__,_| \__,_||_____/  \___||_| |_| \___/  \___/ |_|       

Another School Management System build with Laravel and PHP 7

📢 For Enterprise Edition(EE) checkout here

Index

• Have a Query?
• Demo
  • Enterprise Edition (EE)
• Features
• Installation
  • Installing dependencies
  • Download and setup
  • Use the app
• Documentation
• Changelog/Timeline
• Screenshot
• Contributing
  • To-do
  • Contributers
• Issues
• License

Have a query

⬆️ Back to top

📣 Join our discord channel: CloudSchool📣

📣 Send us an email: [email protected]📣

Demo

⬆️ Back to top

Enterprise Edition

• Website: http://demo.cloudschoolbd.com

• App login: http://demo.cloudschoolbd.com/login

  Username	Password
  superadmin	super99
  admin	demo123

Features

⬆️ Back to top

Installation

⬆️ Back to top

Installing dependencies

• PHP >= 7.2
• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension
• Ctype PHP Extension
• JSON PHP Extension
• MySQL >= 5.6 OR MariaDB >= 10.1
• hrshadhin/laravel-userstamps [Already Installed]
• NodeJS, npm, webpack

Download and setup

• Clone the repo

  For Windows run below commands before cloning the Repo.

  git config --global core.eol lf
  git config --global core.autocrlf false
  

  $ git clone https://github.com/hrshadhin/school-management-system.git cloudschool
  

• change directory

  $ cd cloudschool
  

• Copy sample env file and change configuration according to your need in ".env" file and create Database

  $ cp .env.example .env
  

• Install php libraries

  $ composer install
  

• Setup application

• Setup application

• Setup application

• Setup application

• Setup application

  • Method 1: By one command

    # setup cloudschool with out demo data
    $ php artisan fresh-install
    
    # setup cloudschool with demo data
    $ php artisan fresh-install --with-data
     # OR
    $ php artisan fresh-install -d
    

  • Method 2: Step by step

    $ php artisan storage:link
    $ php artisan key:generate --ansi
    
    # Create database tables and load essential data
    $ php artisan migrate
    $ php artisan db:seed
    
    # Load demo data
    $ php artisan db:seed --class DemoSiteDataSeeder
    $ php artisan db:seed --class DemoAppDataSeeder
    
    # Clear all caches
    $ php artisan view:clear
    $ php artisan route:clear
    $ php artisan config:clear
    $ php artisan cache:clear
    

• Install frontend(css,js) dependency libraries and bundle them

  $ npm install
  $ npm run backend-prod
  $ npm run frontend-prod
  

• Start development server

  $ php artisan serve
  

Use the app

⬆️ Back to top

• Website: http://localhost:8000

• App login: http://localhost:8000/login

  Username	Password
  superadmin	super99
  admin	demo123

Documentation

⬆️ Back to top

• http://ug.cloudschoolbd.com

Timeline

• Check Here

Screenshot

⬆️ Back to top

• 
• More...

Contributing

⬆️ Back to top

Don't be shy to make some PR's here 😄

To-do

• Add unit & integration. Like real quick!
• Add shortcut link for create things. i.e: student, attendance, marks etc
• Add new UI theme version AdminLTE
• Update Jquery with datetime picker library

Contributers

A big shout out to all the contributers, more specifically to these guys

• H.R. Shadhin
• Ashutosh Das
• order4adwriter
• Zahid Irfan
• Oshane Bailey

Issues

⬆️ Back to top

• If you faced any problems, first check previous issue list. If doesn't exists then create a new one.
• You can report the bugs at the issue tracker
• If you discover a security vulnerability within CloudSchool app, please send an e-mail to [email protected]. All security vulnerabilities will be promptly addressed.

License

⬆️ Back to top

Copyright (c) the respective developers and maintainers, as shown by the AUTHORS file.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

All Frameworks and libraries are distributed with it's own license.

As it is a free(free as in freedom) software. To keep the credit for this works, you should not remove application footer information text

Why AGPL? Read Here