Kuttab API

A Laravel REST API for a Quranic school management system (Kuttab). This forked project manages school data, classes, users, and student records. It uses Laravel Excel for importing and exporting data.

🚀 Features

• School Management — Manage multiple Quranic schools (Kuttabs)
• • Classes & Students — CRUD operations for classes and student records
  • • User Management — Admin and teacher user management with role separation
    • • Excel Import/Export — Bulk import and export of school data using Laravel Excel
      • • Multi-select — Bootstrap-select integration for multi-value form fields

        • • Authentication — Secure login and access control per school

          • 🛠 Tech Stack

          • | Layer | Technology |

          • |---|---|

          • | Backend Framework | Laravel (PHP) |

          • | Database | MySQL |

          • | Excel Handling | Laravel Excel (Maatwebsite) |

          • | Templating | Laravel Blade |

          • | UI Components | Bootstrap, Bootstrap-Select |

          • 📦 Languages

          • • PHP (primary)

            • • Blade templates

              • ⚙️ Setup & Installation

              • git clone https://github.com/moathmushtaha/kuttab-api.git
                cd kuttab-api
                composer install
                cp .env.example .env
                php artisan key:generate
                php artisan migrate
                php artisan serve

                Required Environment Variables

                DB_CONNECTION=mysql
                DB_DATABASE=kuttab
                DB_USERNAME=your_username
                DB_PASSWORD=your_password

                💡 Skills Demonstrated

                • Laravel development — full MVC application architecture
                • • Multi-school architecture — data scoped by school/institution
                  • Laravel Excel — bulk data import and export
                  • Role-based access control — school admin vs. teacher roles
                  • Open-source contribution — forked and extended an existing project

                  • Database design — normalized schema for educational management

                  • 👤 Author

                  • Moath A. Mushtaha

                  • GitHub: @moathmushtaha

                  • Forked from: AhmedAbuHasanein/kuttab-api

                  • 📄 License

                  • MIT