Compte Rendu - SIO Shoes

📋 Informations générales

Nom du projet : SIO Shoes - Application E-commerce Symfony

Date de création : Projet BTS SIO SLAM

Auteur : Abdelmalek Elidrissi

Type : Application e-commerce complète

🎯 Objectifs du projet

Gestion de produits (chaussures) avec catégories et sous-catégories
Gestion d'un panier d'achat fonctionnel
Traitement de commandes en ligne
Intégration de paiements sécurisés via Stripe
Administration complète du site
Génération de factures PDF
Envoi d'emails de confirmation

🛠️ Technologies utilisées

Backend

PHP 8.2+ Symfony 7.3 Doctrine ORM 3.5 Doctrine DBAL 3 PostgreSQL Stripe PHP SDK 18.0 Dompdf 3.1 Symfony Mailer 7.3 Symfony Security 7.3 Symfony Forms 7.3 KnpPaginatorBundle 6.9

Frontend

Twig 2.12/3.0 Bootstrap JavaScript ES6+ Stimulus 2.30 Turbo 2.31 Asset Mapper 7.3

Infrastructure & Outils

Docker & Docker Compose Composer Symfony CLI Git PHPUnit 11.5

📁 Structure du projet

Site_eShoes-main/ ├── config/ # Configuration Symfony │ ├── packages/ # Configuration des bundles │ ├── routes/ # Routes de l'application │ └── services.yaml # Configuration des services ├── public/ # Point d'entrée web │ └── index.php # Front controller ├── src/ │ ├── Controller/ # 12 contrôleurs (Bill, Cart, Category, etc.) │ ├── Entity/ # 8 entités Doctrine │ ├── Form/ # 7 formulaires Symfony │ ├── Repository/ # Repositories Doctrine │ ├── Service/ # Services métier (StripePayment) │ └── Twig/ # Extensions Twig ├── templates/ # Templates Twig (~50 templates) ├── migrations/ # 15 migrations de base de données ├── assets/ # Assets frontend (JS/CSS) ├── tests/ # Tests unitaires └── docker/ # Configuration Docker

🔧 Fonctionnalités implémentées

1. Gestion des produits (ProductController)

CRUD Produits

Create : Ajout de nouveaux produits avec upload d'images (nom, description, prix, stock, catégorie, sous-catégorie)
Read : Affichage des produits avec pagination (liste admin + détails public)
Update : Modification des produits existants (infos, stock, image)
Delete : Suppression de produits avec confirmation
Show : Affichage détaillé d'un produit avec disponibilité en stock

Gestion du stock

Historique des ajouts de stock (AddProductHistory)
Suivi des modifications de stock avec date et quantité
Interface pour ajouter du stock à un produit existant
Affichage de l'historique pour chaque produit

Catégories et sous-catégories

Gestion hiérarchique : Catégories avec sous-catégories
CRUD complet pour catégories et sous-catégories
Filtrage des produits par catégorie/sous-catégorie sur la page d'accueil

2. Panier d'achat (CartController)

Ajout de produits au panier avec gestion des quantités
Modification des quantités (augmentation/diminution)
Suppression d'articles du panier
Calcul automatique du total du panier
Persistance en session Symfony
Affichage du nombre d'articles dans la navigation
Validation du stock avant ajout

3. Système de commandes (OrderController)

Processus de commande

Passage de commande depuis le panier
Enregistrement des informations de livraison et facturation
Gestion des adresses (sélection de la ville de livraison)
Suivi des commandes par utilisateur
Historique des commandes passées avec détails

Entités

Order : Statut, total, date, utilisateur, ville de livraison
OrderProducts : Produits, quantités, prix unitaire au moment de la commande

4. Paiement Stripe (StripeController)

Intégration complète avec SDK Stripe PHP officiel (version 18.0)
Paiement sécurisé par carte bancaire avec Stripe Checkout
Gestion des succès : Page de confirmation après paiement réussi
Gestion des annulations : Page d'annulation en cas d'abandon
Service dédié `StripePayment` pour encapsuler la logique
Support des clés de test Stripe (pk_test_, sk_test_)

5. Authentification et sécurité

Inscription et connexion

Formulaire d'inscription avec validation (email unique, force du mot de passe)
Connexion et déconnexion sécurisées
Gestion des rôles (ROLE_USER, ROLE_ADMIN)

Sécurité Symfony

Protection CSRF sur tous les formulaires
Chiffrement des mots de passe avec bcrypt (Symfony PasswordHasher)
Protection des routes par rôle (Symfony Security)
Sessions sécurisées
Validation côté serveur (Symfony Validator)

6. Administration

Gestion des utilisateurs (liste, attribution de rôles)
CRUD complet pour produits, catégories, sous-catégories
Interface d'administration intuitive

7. Génération de factures PDF (BillController)

Création de factures PDF avec Dompdf (version 3.1)
Détails complets de la commande sur la facture
Informations client (nom, email, adresse)
Liste des produits avec quantités et prix
Calcul automatique du total
Design professionnel de la facture
Téléchargement en PDF

8. Envoi d'emails (Symfony Mailer)

Email de confirmation automatique après commande
Templates d'emails avec Twig (orderConfirm.html.twig)
Intégration Symfony Mailer
Gestion des erreurs d'envoi

9. Gestion des villes (CityController)

CRUD villes de livraison
Sélection de la ville lors du passage de commande
Relation avec les commandes (OneToMany)

10. Page d'accueil et catalogue (HomeController)

Catalogue de tous les produits disponibles
Pagination avec KnpPaginatorBundle (6 produits par page)
Filtrage par catégorie et sous-catégorie
Affichage détaillé d'un produit avec ajout au panier

📊 Modèle de données

Entités principales

Entité	Propriétés principales	Relations
User	id, email, password, roles	orders (OneToMany)
Product	id, name, description, price, stock, image	category (ManyToOne), subCategory (ManyToOne), addProductHistories (OneToMany)
Category	id, name	products (OneToMany), subCategories (OneToMany)
SubCategory	id, name	category (ManyToOne), products (OneToMany)
Order	id, total, status, createdAt	user (ManyToOne), orderProducts (OneToMany), city (ManyToOne)
OrderProducts	id, quantity, price	order (ManyToOne), product (ManyToOne)
AddProductHistory	id, quantity, addedAt	product (ManyToOne)
City	id, name	orders (OneToMany)

🌐 Routes principales

Routes publiques

Route	Méthode	Description
/	GET	Page d'accueil avec catalogue de produits
/product/{id}	GET	Détails d'un produit
/register	GET, POST	Inscription
/login	GET, POST	Connexion
/cart	GET	Panier d'achat

Routes authentifiées

Route	Méthode	Description
/cart/add/{id}	POST	Ajouter au panier
/cart/remove/{id}	POST	Retirer du panier
/order	GET, POST	Passer une commande
/orders	GET	Historique des commandes
/order/{id}/bill	GET	Facture d'une commande (PDF)

Routes Stripe

Route	Méthode	Description
/stripe/checkout	GET, POST	Page de paiement Stripe
/stripe/success	GET	Succès du paiement
/stripe/cancel	GET	Annulation du paiement

Routes administrateur

Route	Méthode	Description
/admin/products	GET	Liste des produits (admin)
/admin/products/new	GET, POST	Créer un produit
/admin/products/{id}/edit	GET, POST	Modifier un produit
/admin/categories	GET	Gestion des catégories
/admin/users	GET	Gestion des utilisateurs

🚀 Installation et démarrage

Prérequis

PHP >= 8.2
Composer (gestionnaire de dépendances PHP)
Docker et Docker Compose (pour PostgreSQL)
Node.js et npm (pour les assets frontend)
Symfony CLI (optionnel, mais recommandé)

Étapes d'installation

Installer les dépendances PHP
cd Projets/Site_eShoes-main composer install
Configurer les variables d'environnement
Créer `.env.local` :

DATABASE_URL="postgresql://app:!ChangeMe!@127.0.0.1:5432/app?serverVersion=16&charset=utf8" STRIPE_PUBLIC_KEY="votre_clé_publique_stripe" STRIPE_SECRET_KEY="votre_clé_secrète_stripe" MAILER_DSN="smtp://localhost:1025"
Démarrer la base de données
docker compose up -d
Créer la base de données et exécuter les migrations
php bin/console doctrine:database:create php bin/console doctrine:migrations:migrate
Installer les assets frontend
npm install npm run build
Lancer l'application
symfony server:start # Ou avec PHP natif php -S localhost:8000 -t public

💡 Points techniques remarquables

Architecture MVC

Séparation Modèle-Vue-Contrôleur
Design Pattern Repository
Services dédiés (StripePayment)
Formulaires Symfony

Sécurité

Protection CSRF automatique
Chiffrement bcrypt
Contrôle d'accès par rôle
Sessions sécurisées

Base de données

15 migrations versionnées
Doctrine ORM avec annotations
Relations OneToMany/ManyToOne
Requêtes optimisées

Performance

Pagination KnpPaginatorBundle
Cache Symfony
Turbo pour navigation
Asset Mapper

🐛 Difficultés rencontrées et solutions

Problème 1 : Gestion des relations Doctrine

Création correcte des relations entre entités (OneToMany, ManyToOne).

Solution : Étude approfondie de la documentation Doctrine et création correcte des annotations de relations avec les propriétés `inversedBy` et `mappedBy`.

Problème 2 : Intégration Stripe

Configuration et utilisation correcte du SDK Stripe PHP.

Solution : Utilisation du SDK Stripe PHP officiel (version 18.0), configuration correcte des clés API de test dans `.env.local`, et création d'un service dédié pour encapsuler la logique de paiement.

Problème 3 : Génération de PDF

Génération de factures PDF avec Dompdf.

Solution : Utilisation de Dompdf (version 3.1) avec création de templates HTML dédiés pour les factures, puis conversion en PDF.

Problème 4 : Gestion du panier en session

Sauvegarde du panier en session et persistance entre les requêtes.

Solution : Utilisation de la session Symfony pour stocker temporairement les articles du panier avec gestion des quantités et des totaux.

Problème 5 : Pagination des produits

Implémentation de la pagination sur la liste des produits.

Solution : Utilisation de KnpPaginatorBundle qui permet une pagination simple et efficace avec configuration dans le contrôleur.

Problème 6 : Upload d'images

Upload et stockage des images de produits.

Solution : Utilisation de VichUploaderBundle ou gestion manuelle avec Symfony Filesystem, stockage dans le dossier `public/uploads/products/`.

📈 Améliorations possibles

Fonctionnalités

Recherche avancée avec filtres
Avis clients et notation
Favoris / Liste de souhaits
Codes promotionnels
Multi-langue (i18n)

Technique

API REST pour mobile
Webhooks Stripe
Tableau de bord admin
Images multiples par produit
Système de notifications

E-commerce

Gestion des tailles
Stock par taille
Comparaison de produits
Historique de navigation
Recommandations produits

📚 Compétences développées

Framework Symfony

Maîtrise de Symfony 7
Doctrine ORM 3.5
Architecture MVC
Formulaires Symfony
Sécurité Symfony

Base de données

PostgreSQL
Migrations (15 migrations)
Relations entités
Requêtes optimisées

Sécurité web

Protection CSRF
Chiffrement bcrypt
Contrôle d'accès par rôle
Validation serveur

Intégrations

Stripe (paiements)
Dompdf (génération PDF)
Symfony Mailer (emails)

Frontend

Twig (templates)
Bootstrap (responsive)
JavaScript moderne
Stimulus

Infrastructure

Docker
Git
Tests PHPUnit
Débogage Symfony

🎓 Conclusion

Ce projet constitue une application e-commerce complète et fonctionnelle, démontrant une maîtrise approfondie du framework Symfony et des concepts de développement web moderne. L'application intègre tous les composants essentiels d'un site e-commerce : gestion de produits, panier, commandes, paiement sécurisé, et administration.

Points forts :

Architecture bien structurée et maintenable
Code propre et organisé suivant les conventions Symfony
Sécurité prise en compte à tous les niveaux
Fonctionnalités complètes pour un e-commerce
Documentation claire et installation simple
Tests unitaires pour valider les fonctionnalités

Points techniques remarquables :

Utilisation de Doctrine ORM pour une gestion efficace de la base de données
Intégration complète de Stripe pour les paiements sécurisés
Génération de factures PDF professionnelles
Système de pagination pour les listes de produits
Gestion du panier en session avec persistance

Prochaines étapes : Amélioration de l'interface utilisateur, ajout de fonctionnalités avancées (recherche, avis, favoris), optimisation des performances, et transformation en API REST pour application mobile.