Projet Intégrateur

⏱️ Durée estimée : 8h — 12h

🎯 Objectif du Projet Intégrateur

Le projet intégrateur est l’aboutissement du Drupal Bootcamp. Vous allez livrer une version complète et fonctionnelle de TailStore, démontrant votre maîtrise de l’ensemble des compétences acquises durant la formation.

Synthèse

Appliquez les acquis des 8 étapes dans un projet cohérent.

Autonomie

Travaillez en autonomie avec les ressources du bootcamp.

Production

Livrez un site fonctionnel, versionné et documenté.

---

🛒 Fonctionnalités attendues

Périmètre minimum (obligatoire)

Fonctionnalité	Description	Étapes concernées
Catalogue produits	Liste des produits avec filtres et pagination	2, 3, 4
Page produit	Affichage détaillé avec images et informations	2, 6
Panier dynamique	Ajout/modification/suppression avec htmx	8
Mini-cart header	Affichage du compteur et total en temps réel	8
Checkout Stripe	Paiement fonctionnel en mode test	8
Thème responsive	Design Tailwind CSS adaptatif	6
Navigation	Menus, header, footer fonctionnels	5

Fonctionnalités bonus (optionnel)

• 🔍 Recherche de produits
• ⭐ Système d’avis/notes
• 👤 Espace utilisateur (historique commandes)
• 📧 Emails de confirmation (via Webform ou custom)
• 🏷️ Système de codes promo
• 📱 PWA / Mode offline

---

📋 Livrables attendus

1. Code source

tailstore/
├── web/
│   ├── modules/custom/
│   │   └── tailstore_cart/        # Module panier + Stripe
│   └── themes/custom/
│       └── tailstore_theme/       # Thème Tailwind
├── config/
│   └── sync/                      # Export configuration
├── composer.json
├── composer.lock
└── README.md                      # Documentation projet

2. Documentation (README.md)

Votre README doit contenir :

# TailStore - Projet Drupal 11

## Installation

1. Cloner le projet
2. `ddev start`
3. `ddev composer install`
4. `ddev drush site:install --existing-config -y`
5. `ddev drush uli`

## Configuration Stripe

Clés de test à configurer dans `/admin/config/system/tailstore-cart` :
- Publishable key: `pk_test_...`
- Secret key: `sk_test_...`

## Compte test

- Admin : admin / admin
- Carte test : 4242 4242 4242 4242

## Fonctionnalités

- [x] Catalogue produits
- [x] Panier htmx
- [x] Checkout Stripe
...

3. Export de configuration

ddev drush cex -y

4. Démonstration

• Vidéo de 3-5 minutes OU
• README détaillé avec captures d’écran

---

✅ Critères d’évaluation

Grille d’évaluation

Critère	Points	Description
Fonctionnalités	/30	Toutes les features minimum fonctionnent
Code qualité	/20	PSR-4, injection de dépendances, pas de code mort
Theming	/15	Templates propres, responsive, accessible
Documentation	/15	README complet, instructions claires
Git	/10	Historique propre, commits atomiques
Bonus	/10	Fonctionnalités supplémentaires
Total	/100

Détail des points

Fonctionnalités (30 pts)

• Catalogue avec filtres : 5 pts
• Page produit complète : 5 pts
• Panier fonctionnel : 8 pts
• Checkout Stripe : 8 pts
• Navigation et UX : 4 pts

Code (20 pts)

• Structure module PSR-4 : 5 pts
• Services et injection : 5 pts
• Controllers propres : 5 pts
• Sécurité (CSRF, validation) : 5 pts

Theming (15 pts)

• Templates Twig : 5 pts
• Tailwind CSS : 5 pts
• Responsive design : 5 pts

---

🧭 Planning recommandé

1. Initialisation (30 min)

   • Fork/clone du projet de base
   • Configuration DDEV
   • Import de la configuration existante

2. Modélisation (1h)

   • Vérifier les types de contenu
   • Ajuster les champs si nécessaire
   • Créer les taxonomies manquantes

3. Contenu (1h)

   • Importer ou créer 10+ produits
   • Ajouter des images
   • Configurer les termes de taxonomie

4. Module panier (2-3h)

   • Structure du module
   • CartService
   • Routes et controllers
   • Intégration htmx

5. Stripe Checkout (1-2h)

   • StripeService
   • CheckoutController
   • Webhook
   • Tests de paiement

6. Theming (1-2h)

   • Finaliser les templates
   • Ajuster le CSS
   • Tester le responsive

7. Tests & Debug (1h)

   • Parcours utilisateur complet
   • Vérification des logs
   • Correction des bugs

8. Documentation (30-60 min)

   • README complet
   • Export configuration
   • Commit final

---

📚 Ressources

Documentation du Bootcamp

• Étape 1 - Installation
• Étape 2 - Contenus
• Étape 3 - Taxonomies
• Étape 4 - Vues
• Étape 5 - Navigation
• Étape 6 - Theming
• Étape 7 - Modules
• Étape 8 - Développement

Ressources externes

• Stripe Test Cards
• htmx Documentation
• Tailwind CSS
• Drupal API

Conseil Git

Créez une branche projet/votre-nom et commitez régulièrement avec des messages descriptifs :

git checkout -b projet/jean-dupont
git add .
git commit -m "feat(cart): add CartService with session storage"

---

📤 Remise du projet

Format de remise

1. Dépôt Git (recommandé)

   • Invitez le correcteur en lecture
   • Ou créez un repo public temporaire

2. Archive ZIP

   • Excluez vendor/ et node_modules/
   • Incluez un dump de la base (optionnel)

Checklist avant remise

• Le site s’installe avec ddev drush site:install --existing-config
• Les clés Stripe test sont documentées
• Le parcours d’achat fonctionne de A à Z
• Le README est complet
• Tous les fichiers sont commités

Date limite

Deadline

Consultez votre espace de cours pour la date limite de remise.

---

🚀 C’est parti !

Vous avez toutes les cartes en main. Consultez les exercices détaillés pour un guide pas à pas.

Exercices

Guide détaillé étape par étape. Voir les exercices →

Correction

Points de vérification et exemples. Voir la correction →

---

Bonne chance ! 🎓 C’est le moment de montrer tout ce que vous avez appris !