Gheras Task Manager - Backend API

The core API service for managing tasks, projects, and users at Ghras Al-Ilm Academy.

---

📖 Overview

This repository contains the Backend Microservice/API for the Gheras Task Manager. It provides RESTful endpoints, handles authentication (Sanctum), and manages the database logic using a Service-Oriented Architecture.

Frontend Repository: Gheras Manager UI

🚀 Getting Started

Prerequisites

• PHP 8.1 or higher
• Composer
• MySQL

Installation

1. Clone the repository

   git clone [https://github.com/YOUR_USERNAME/Gheras-Manager-Back-End
   .git](https://github.com/YOUR_USERNAME/gheras-backend.git)
   cd gheras-backend
   

2. Install Dependencies

   composer install   

3. Environment Setup

      cp .env.example .env
      php artisan key:generate   
   

Configure your database credentials in the .env file.

4. Database Migration & Seeding

      php artisan migrate --seed      
   

5. Run the Server

      php artisan serve
   

📂 Architecture

This project follows a Service-Oriented Architecture to ensure scalability and clean code:

• Controllers: Handle HTTP requests and responses only.
• Services: Contain the business logic (e.g., TaskService, ProjectService).
• Resources: Transform data into standardized JSON responses.
• Requests: Handle form validation.