/laravel-geolocation-app

Gestion géographique avec Laravel : zones, régions, terrains et promoteurs.

Primary LanguagePHPMIT LicenseMIT

Laravel Logo

Oracle Project (laravel-geolocation-app)

Ce projet constitue un petit challenge lancé par notre professeur d'Oracle afin de mettre à l'épreuve nos compétences en Laravel,
en particulier dans la gestion des zones, régions, terrains et promoteurs.

Outils Utilisés

  1. Framework : Laravel 10
  2. Moteur de templating : Blade
  3. Système d'authentification : Breeze
  4. Framework CSS : Tailwind CSS

Prérequis

Avant de commencer à travailler sur ce projet, assurez-vous d'avoir installé les éléments suivants :

  • Composer : Pour gérer les dépendances PHP.
  • Node.js : Nécessaire pour l'utilisation de npm.
  • npm : Gestionnaire de packages pour JavaScript.

Installation

Suivez ces étapes pour installer et démarrer le projet localement :

  1. Clonez ce dépôt sur votre machine locale :

    git clone https://github.com/LamineGitHub/laravel-geolocation-app.git

  2. Accédez au répertoire fraîchement cloné :

    cd laravel-geolocation-app

  3. Installez les dépendances PHP avec Composer :

    composer install

  4. Copiez le fichier .env.example et renommez-le en .env :

    cp .env.example .env

  5. Générez la clé d'application Laravel :

    php artisan key:generate

  6. Configurez votre base de données dans le fichier .env.

  7. Exécutez les migrations pour créer les tables de base de données :

    php artisan migrate

  8. Compilez les assets CSS et JavaScript :

    npm install && npm run dev

Utilisation

Une fois le projet installé, vous pouvez le démarrer en local en exécutant la commande suivante :

php artisan serve

Cela démarrera un serveur de développement local à l'adresse http://localhost:8000. Vous pouvez alors accéder au projet dans votre navigateur.

Contribution

Les contributions sont les bienvenues ! Avant de soumettre une pull request, veuillez vous assurer de suivre ces étapes :

  1. Créez une branche pour votre fonctionnalité ou correctif :

    git checkout -b nom-de-votre-branche

  2. Effectuez vos modifications et ajoutez-les à l'index :

    git add .

  3. Faites un commit de vos modifications avec un message clair :

    git commit -m "Votre message de commit ici"

  4. Poussez vos modifications vers votre branche :

    git push origin nom-de-votre-branche

  5. Ouvrez une pull request sur la branche principale du projet.

Licence

Ce projet est sous licence MIT. Pour plus d'informations, veuillez consulter le fichier LICENSE.