Projet - Trip Planner

• à rendre avant le 26/03 à 23h59
• soutenance le 30/03

Présentation

L’objectif est de développer une application web permettant à un utilisateur de:

• créer et organiser des voyages
• ajouter des destinations, activités, hébergements et transports
• afficher et maintenir un coût total calculé dynamiquement

Le projet est à réaliser en groupe.

Conseils

• Lisez bien le sujet.
• Utilisez Trello (ou équivalent) pour lister les tâches et vous répartir le travail.
• Terminez bien le TP (Trip Planner), puis ajoutez des fonctionnalités supplémentaires.
• Testez l’installation sur Linux en suivant votre README.
• Entraide autorisée, mais pas de copie de code. Si vous utilisez du code externe, citez vos sources.

Consignes (base attendue)

TP2 complété

• Vous devez avoir complété le TP guidé Trip Planner:
  • Sujet du TP Trip Planner
• Avec SQLite, pas de MySQL
• Avec du code commenté (controllers, modèles, migrations, etc.)

Github

• Faites des commits pendant le développement.
• Des commits clairs, correspondant à une progression réelle, seront appréciés.
• Un seul commit final le dernier jour sera pénalisé.

README.md obligatoire

Le fichier README.md (à la racine du dépôt) fera office de rapport.

Il doit contenir:

• le guide d’installation (toutes les commandes)
• les fichiers à configurer (ex: .env)
• les fonctionnalités implémentées
• pour chaque fonctionnalité: comment je la teste (URLs, boutons, identifiants si besoin)
• Soignez la mise en forme et l’orthographe (Passez votre fichier dans un correcteur orthographique)

Important: je dois pouvoir cloner votre repo et suivre votre README pour lancer votre projet.

Rendu

• Le repository git (Github Classroom) est votre rendu.

• le nom de votre «team» est bien constitué des noms des différents membres de votre groupe.

• Le dernier commit doit dater d’avant le 26/03 à 23h59.

• Travail en groupe (3 ou 4 personnes). Sauf exception validée avec moi, des points seront retirés si vous n’êtes pas en groupe.

  Caution

  Tester votre installation sur différentes machines (Je travaille sur Linux, donc assurez-vous que ça fonctionne sur Linux). En général quand ça fonctionne sous Linux, cela fonctionne sur les autres systèmes, l’inverse n’est pas vrai. (Attention notamment aux majuscules sur les noms de fichier)

Soutenance

• démo rapide (moins de 5 minutes)
• Pas de slide nécessaire.
• questions individuelles: vous devez expliquer une fonctionnalité en naviguant dans votre code

Évaluation

La note finale sera donnée en fonction:

• des fonctionnalités supplémentaires
• de la qualité de votre code
• de votre compte rendu
• de votre soutenance

Tip

La cohérence globale et le travail d’ensemble est également apprécié.(Je préfère peu de fonctionnalités, claires, bien exécutées, et qui fonctionnent plutôt qu’une multitude de fonctionnalités qui ne fonctionnent pas.) La clarté du code (indentation, commentaires, etc) est aussi prise en compte.

En résumé, cela dépend du travail fourni et du résultat.

Sujet du projet: Trip Planner (fonctionnalités attendues)

Fonctionnalités minimales (MVP)

Vous devez implémenter au minimum:

1) Gestion des voyages

• CRUD voyages (title, description, dates, nombre de personnes)
• Un voyage appartient à un utilisateur
• Un utilisateur ne voit que ses voyages (si auth mise en place) ou au minimum user_id et filtrage

2) Ajout d’éléments à un voyage

Votre voyage doit pouvoir contenir:

• des destinations
• des activités (rattachées à une destination)
• des hébergements (rattachés à une destination)
• des transports (rattachés au voyage)

3) Calcul du coût total (dynamique)

Le coût total doit être calculé dynamiquement (pas stocké en base sans justification) et dépendre:

• du nombre de personnes
• des activités
• des hébergements
• des transports

Règles MVP proposées:

• activités: price_per_person * people_count
• hébergements: price_per_night * nights
• transports:
  • per_person: price * people_count
  • fixed: price

Le total doit s’afficher sur la page détail d’un voyage.

4) Validation

• Utiliser des FormRequest pour valider les formulaires importants.
• Exemples de validations attendues:
  • dates cohérentes (starts_at <= ends_at)
  • nights >= 1
  • people_count >= 1

5) Base de données, migrations, seeders

• Migrations propres, clés étrangères
• Factories + seeders obligatoires

Commande attendue:

php artisan migrate:fresh --seed

doit produire une base avec des données permettant de tester l’application.

Fonctionnalités supplémentaires (au choix)

Voici des idées (choisissez en quelques unes, bien finies):

Authentification / Autorisation

• Voir authentication et starter kits
• Protéger l’accès aux voyages
• Policies: un utilisateur ne peut modifier que ses voyages
• Inviter des utilisateurs à collaborer sur un voyage
• Rôles (admin, user) avec permissions différentes

Attention

Attention, l’installation d’un starter kit peut modifier / écraser certains fichiers (ex: routes/web.php). Assurez-vous de faire des commits avant d’installer un starter kit pour pouvoir revenir en arrière si besoin.

Consigne

Si vous créez des utilisateurs de test/admin, n’oubliez pas de les mentionner dans votre README (identifiants, rôles, password etc). Utiliser de préférence les logins et mots de passe suivants pour les utilisateurs de test:

• login: test, password: testtest
• login: test2, password: testtest
• login: admin, password: adminadmin (si rôle admin)

Vous pouvez utiliser d’autres identifiants avec d’autres rôles si besoin, mais assurez-vous de les mentionner dans votre README.

Recherche / filtres

• Recherche sur la liste des voyages
• Filtre par date, destination, budget

Contraintes métier avancées

• Une activité ne peut pas être planifiée en dehors des dates du voyage
• people_count ne doit pas dépasser la capacité d’un hébergement
• Un voyage doit contenir au moins une destination

Améliorations UI / UX

• Interface plus soignée (Tailwind / Bootstrap)
• Tableau de bord récapitulatif

Médias

• Upload d’une image de couverture pour un voyage ou une destination

Notes / commentaires

• Noter un voyage
• Ajouter des commentaires (et éventuellement modération admin)
• Ajout d’un captcha

Tests

• Testing
• Tests Feature / Unit
• Bonus: Dusk (browser tests)

Librairies de destinations / activités / transports

• Intégration d’une API externe (ex: Google Places) pour suggérer des destinations ou activités
• Librairie de transports avec calcul d’itinéraire (ex: Google Maps)
• Librairie d’hébergements (ex: Booking.com)
• Librairie interne de destinations / activités / transports à choisir lors de la création d’un voyage (avec possibilité d’ajouter des éléments à la librairie pour l’admin?)

Aide à la planification par IA

• Génération de suggestions de voyages, destinations ou activités à partir d’une description textuelle (ex: « Je veux un voyage de 10 jours en Italie avec des activités culturelles et gastronomiques »)
• Utilisation d’une API d’IA (ex: OpenAI, Mistral) pour générer ces suggestions. Eventuellement intégrer ces suggestions dans la création d’un voyage (ex: bouton « Générer un voyage » qui pré-remplit les champs du formulaire de création d’un voyage avec les suggestions de l’IA).
• Possibilité d’ajout d’un token par l’utilisateur pour éviter d’utiliser votre token personnel.

Surprise

• Toute fonctionnalité cohérente et bien réalisée
• Soyez créatifs, mais assurez-vous que votre fonctionnalité supplémentaire est bien finie et fonctionne correctement. Il vaut mieux une fonctionnalité simple et fonctionnelle qu’une fonctionnalité complexe qui ne fonctionne pas ou est incomplète.
• À vos risques et périls, mais si vous faites quelque chose de puissant, ça peut payer.
• N’oubliez pas de bien le préciser dans vos comptes rendus et de me donner des détails.
• Dans le doute, vous pouvez me soumettre vos idées avant de commencer.