Project 13: the pattern shop (5 design patterns that earn their keep)

<?php
// ============================================================================
// LA BOUTIQUE AUX PATTERNS — un seul fichier PHP, et 5 design patterns
// qui gagnent chacun leur place.
//
// Ce fichier est l'artefact du projet « Construire la boutique, un pattern à
// la fois ». Chaque pattern y répond à un besoin NOMMABLE de la boutique :
//
//   STRATEGY   → les frais de port varient (Colissimo, Chrono, retrait)
//   DECORATOR  → la promo « offert dès 50 € » s'empile sur n'importe quel
//                transporteur, sans modifier aucun transporteur
//   STATE      → la commande change de comportement selon son étape de vie
//                (au panier / payée / expédiée), zéro if dans annuler()
//   OBSERVER   → payer déclenche l'email, le stock, la compta... sans que la
//                commande connaisse aucun d'eux
//   FACADE     → le « contrôleur » (le POST tout en bas) n'appelle qu'UN objet
//
// Et aussi important : les patterns ABSENTS. Pas de Singleton (tout est
// assemblé et injecté à la racine), pas de Command (personne n'a demandé
// d'annuler/rejouer pas à pas), pas d'Abstract Factory (un seul thème).
// Un bon design se reconnaît autant à ses patterns absents que présents.
//
// PLAN DU FICHIER :
//   1) Les classes : Panier, Strategy, Decorator, State, Observer, Facade
//   2) L'état de la démo (session) + l'assemblage À LA RACINE
//   3) Traitement du POST (le « contrôleur » : il ne connaît que la façade)
//   4) Le HTML
// ============================================================================

session_start();

// --- Langue (fr par défaut) -------------------------------------------------
$lang = ((($_REQUEST['lang'] ?? 'fr')) === 'en') ? 'en' : 'fr';

// Échappe une valeur AVANT de l'afficher : la parade universelle contre le XSS.
function e($s) { return htmlspecialchars((string)$s, ENT_QUOTES, 'UTF-8'); }

// ============================================================================
// 1) LES CLASSES
// ============================================================================

// --- Le panier : la classe la plus centrale est la plus bête. AUCUN pattern.
class Panier {
    /** @var array<string,int> nom du produit => quantité */
    private array $lignes = [];
    public function __construct(private array $catalogue) {}
    public function ajouter(string $produit): void {
        if (isset($this->catalogue[$produit])) {
            $this->lignes[$produit] = ($this->lignes[$produit] ?? 0) + 1;
        }
    }
    public function vider(): void { $this->lignes = []; }
    public function lignes(): array { return $this->lignes; }
    public function estVide(): bool { return $this->lignes === []; }
    public function total(): float {
        $t = 0.0;
        foreach ($this->lignes as $produit => $qte) {
            $t += $this->catalogue[$produit] * $qte;
        }
        return $t;
    }
}

// --- STRATEGY : les frais de port varient -----------------------------------
// Une interface, des calculs interchangeables. Ajouter un transporteur demain
// = ajouter UNE classe. Ni le panier, ni le checkout, ni le HTML ne bougent.
interface FraisDePort {
    public function calculer(Panier $p): float;
}
class Colissimo implements FraisDePort {
    public function calculer(Panier $p): float { return 4.99; }
}
class Chronopost implements FraisDePort {
    public function calculer(Panier $p): float { return 9.99; }
}
class RetraitMagasin implements FraisDePort {
    public function calculer(Panier $p): float { return 0.0; }
}

// --- DECORATOR : la promo s'empile sur N'IMPORTE quel transporteur ----------
// Même interface que ce qu'il enveloppe : pour le reste du code, un transporteur
// décoré EST un transporteur. C'est ça qui rend la promo empilable.
class FraisOffertsDes implements FraisDePort {
    public function __construct(private FraisDePort $base, private float $seuil) {}
    public function calculer(Panier $p): float {
        return $p->total() >= $this->seuil ? 0.0 : $this->base->calculer($p);
    }
}

// --- STATE : la commande change de comportement selon son étape -------------
// Chaque état sait ce qu'« annuler » veut dire POUR LUI. La commande remplace
// son objet-état à chaque étape, et annuler() délègue. Zéro if, pour toujours.
interface EtatCommande {
    public function annuler(Commande $c): string;  // renvoie ce qui s'est passé
    public function libelle(string $lang): string;
}
class AuPanier implements EtatCommande {
    public function annuler(Commande $c): string {
        $c->panier()->vider();
        return $c->lang() === 'en' ? 'Cart emptied. Nothing to refund: nothing was paid.' : 'Panier vidé. Rien à rembourser : rien n\'était payé.';
    }
    public function libelle(string $lang): string { return $lang === 'en' ? 'in cart' : 'au panier'; }
}
class Payee implements EtatCommande {
    public function annuler(Commande $c): string {
        $c->changerEtat(new AuPanier());
        return $c->lang() === 'en' ? 'Order refunded. Items are back in your cart.' : 'Commande remboursée. Les articles sont de retour dans le panier.';
    }
    public function libelle(string $lang): string { return $lang === 'en' ? 'paid' : 'payée'; }
}
class Expediee implements EtatCommande {
    public function annuler(Commande $c): string {
        return $c->lang() === 'en' ? 'Too late to refund directly: a carrier return has been requested.' : 'Trop tard pour rembourser directement : un retour transporteur est demandé.';
    }
    public function libelle(string $lang): string { return $lang === 'en' ? 'shipped' : 'expédiée'; }
}
class Commande {
    private EtatCommande $etat;
    public function __construct(private Panier $panier, private string $lang) {
        $this->etat = new AuPanier();   // état de départ
    }
    public function payer(): void    { $this->etat = new Payee(); }
    public function expedier(): void { $this->etat = new Expediee(); }
    public function annuler(): string { return $this->etat->annuler($this); }
    public function changerEtat(EtatCommande $e): void { $this->etat = $e; }
    public function etat(): EtatCommande { return $this->etat; }
    public function panier(): Panier { return $this->panier; }
    public function lang(): string { return $this->lang; }
}

// --- OBSERVER : payer déclenche l'inconnu ------------------------------------
// Une liste d'abonnés + une boucle : c'est TOUT le pattern. La commande publie,
// elle ne connaît ni l'email, ni le stock, ni les abonnés de demain.
class Evenements {
    /** @var array<string, callable[]> */
    private array $abonnes = [];
    public function abonner(string $evt, callable $fn): void {
        $this->abonnes[$evt][] = $fn;
    }
    public function publier(string $evt, $donnees = null): void {
        foreach ($this->abonnes[$evt] ?? [] as $fn) { $fn($donnees); }
    }
}

// --- FACADE : un seul point d'entrée -----------------------------------------
// Le contrôleur (le POST plus bas) ne connaît que cet objet. Les dépendances
// arrivent en INTERFACES : c'est aussi l'inversion de dépendance de Clean
// Architecture. Les deux livres convergent sur le même geste.
class Checkout {
    public function __construct(
        private FraisDePort $livraison,   // la Strategy (éventuellement décorée)
        private Evenements  $evenements,  // l'Observer
    ) {}
    public function totalAPayer(Panier $p): float {
        return $p->total() + $this->livraison->calculer($p);
    }
    public function fraisDePort(Panier $p): float {
        return $this->livraison->calculer($p);
    }
    public function commander(Commande $c): void {
        $c->payer();
        $this->evenements->publier('commande.payee', $c);
    }
}

// ============================================================================
// 2) L'ÉTAT DE LA DÉMO (session) + L'ASSEMBLAGE À LA RACINE
// ============================================================================

$catalogue = [
    'Clavier mécanique' => 79.00,
    'Tasse « it works »' => 12.50,
    'Stickers (lot de 10)' => 4.00,
];
$catalogueEn = [
    'Clavier mécanique' => 'Mechanical keyboard',
    'Tasse « it works »' => '"It works" mug',
    'Stickers (lot de 10)' => 'Stickers (pack of 10)',
];

// L'état persistant de la démo : lignes du panier, choix, statut, journal.
$_SESSION['boutique'] ??= [
    'lignes' => [], 'transporteur' => 'colissimo', 'promo' => false,
    'statut' => 'panier', 'journal' => [],
];
$etatDemo = &$_SESSION['boutique'];

// On reconstruit les objets depuis la session (une démo HTTP est sans mémoire :
// chaque requête repart de zéro, la session est notre disque dur).
$panier = new Panier($catalogue);
foreach ($etatDemo['lignes'] as $produit => $qte) {
    for ($i = 0; $i < $qte; $i++) { $panier->ajouter($produit); }
}
$commande = new Commande($panier, $lang);
if ($etatDemo['statut'] === 'payee')    { $commande->payer(); }
if ($etatDemo['statut'] === 'expediee') { $commande->expedier(); }

// --- Les abonnés Observer : chacun ignore l'existence des autres ------------
$evenements = new Evenements();
$evenements->abonner('commande.payee', function () use (&$etatDemo, $lang) {
    $etatDemo['journal'][] = $lang === 'en' ? '📧 Email subscriber: confirmation sent' : '📧 Abonné email : confirmation envoyée';
});
$evenements->abonner('commande.payee', function () use (&$etatDemo, $lang) {
    $etatDemo['journal'][] = $lang === 'en' ? '📦 Stock subscriber: items reserved' : '📦 Abonné stock : articles réservés';
});
$evenements->abonner('commande.payee', function () use (&$etatDemo, $lang) {
    $etatDemo['journal'][] = $lang === 'en' ? '🧾 Accounting subscriber: invoice drafted' : '🧾 Abonné compta : facture préparée';
});

// --- L'ASSEMBLAGE : tous les choix concrets se font ICI, à la racine ---------
// C'est le seul endroit du fichier qui connaît les classes concrètes.
$transporteurs = [
    'colissimo' => new Colissimo(),
    'chrono'    => new Chronopost(),
    'retrait'   => new RetraitMagasin(),
];
$livraison = $transporteurs[$etatDemo['transporteur']] ?? $transporteurs['colissimo'];
if ($etatDemo['promo']) {
    $livraison = new FraisOffertsDes($livraison, 50.00);   // le Decorator s'empile
}
$checkout = new Checkout($livraison, $evenements);

// ============================================================================
// 3) LE « CONTRÔLEUR » : il ne connaît que la façade (et la session)
// ============================================================================
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $action = $_POST['action'] ?? '';

    if ($action === 'ajouter' && $etatDemo['statut'] === 'panier') {
        $produit = (string)($_POST['produit'] ?? '');
        if (isset($catalogue[$produit])) {
            $etatDemo['lignes'][$produit] = ($etatDemo['lignes'][$produit] ?? 0) + 1;
        }
    }
    if ($action === 'options' && $etatDemo['statut'] === 'panier') {
        $t = (string)($_POST['transporteur'] ?? 'colissimo');
        $etatDemo['transporteur'] = isset($transporteurs[$t]) ? $t : 'colissimo';
        $etatDemo['promo'] = isset($_POST['promo']);
    }
    if ($action === 'payer' && $etatDemo['statut'] === 'panier' && !$panier->estVide()) {
        $checkout->commander($commande);            // la façade orchestre
        $etatDemo['statut'] = 'payee';
    }
    if ($action === 'expedier' && $etatDemo['statut'] === 'payee') {
        $commande->expedier();
        $etatDemo['statut'] = 'expediee';
        $etatDemo['journal'][] = $lang === 'en' ? '🚚 Order handed to the carrier' : '🚚 Commande remise au transporteur';
    }
    if ($action === 'annuler') {
        $resultat = $commande->annuler();           // STATE décide tout seul
        $etatDemo['journal'][] = '↩️ ' . $resultat;
        // on resynchronise la session avec ce que l'état a décidé
        $etatDemo['statut'] = $commande->etat()->libelle('fr') === 'payée' ? 'payee'
            : ($commande->etat()->libelle('fr') === 'expédiée' ? 'expediee' : 'panier');
        if ($etatDemo['statut'] === 'panier' && $panier->estVide()) { $etatDemo['lignes'] = []; }
    }
    if ($action === 'reset') {
        $etatDemo = ['lignes' => [], 'transporteur' => 'colissimo', 'promo' => false, 'statut' => 'panier', 'journal' => []];
    }

    // PRG : on redirige pour éviter le re-POST au F5.
    header('Location: ?lang=' . $lang);
    exit;
}

// ============================================================================
// 4) LE HTML
// ============================================================================
$S = [
  'fr' => [
    'title' => 'La boutique aux patterns', 'sub' => 'Chaque bouton de cette page traverse un design pattern. Le journal en bas raconte lesquels.',
    'cat' => 'Catalogue', 'add' => 'Ajouter',
    'cart' => 'Panier', 'empty' => 'Panier vide. Ajoute un article ci-dessus.',
    'ship' => 'Livraison (Strategy)', 'promo' => 'Code promo : offert dès 50 € (Decorator)',
    'colissimo' => 'Colissimo · 4,99 €', 'chrono' => 'Chronopost · 9,99 €', 'retrait' => 'Retrait magasin · 0 €',
    'apply' => 'Appliquer',
    'subtotal' => 'Sous-total', 'fees' => 'Frais de port', 'total' => 'Total à payer',
    'status' => 'Statut de la commande (State)', 'pay' => 'Payer', 'shipit' => 'Expédier', 'cancel' => 'Annuler',
    'log' => 'Journal des événements (Observer)', 'logEmpty' => 'Rien pour l\'instant. Paie la commande et regarde qui se réveille.',
    'reset' => 'Réinitialiser la démo',
    'note' => 'Annuler ne contient aucun if : c\'est l\'objet-état courant qui décide (vider, rembourser ou demander un retour).',
    'credit' => '5 design patterns dans un fichier PHP · Mini-projet du cours <a href="/apprendre/projets/">Projets appliqués</a>',
    'statuts' => ['panier' => 'au panier', 'payee' => 'payée', 'expediee' => 'expédiée'],
  ],
  'en' => [
    'title' => 'The pattern shop', 'sub' => 'Every button on this page goes through a design pattern. The log below tells you which.',
    'cat' => 'Catalog', 'add' => 'Add',
    'cart' => 'Cart', 'empty' => 'Empty cart. Add an item above.',
    'ship' => 'Shipping (Strategy)', 'promo' => 'Promo code: free over €50 (Decorator)',
    'colissimo' => 'Standard post · €4.99', 'chrono' => 'Express · €9.99', 'retrait' => 'Store pickup · €0',
    'apply' => 'Apply',
    'subtotal' => 'Subtotal', 'fees' => 'Shipping fee', 'total' => 'Total to pay',
    'status' => 'Order status (State)', 'pay' => 'Pay', 'shipit' => 'Ship', 'cancel' => 'Cancel',
    'log' => 'Event log (Observer)', 'logEmpty' => 'Nothing yet. Pay the order and watch who wakes up.',
    'reset' => 'Reset the demo',
    'note' => 'Cancel contains no if: the current state object decides (empty, refund, or request a return).',
    'credit' => '5 design patterns in one PHP file · A mini-project from the <a href="/apprendre/projets/">Applied projects</a> course',
    'statuts' => ['panier' => 'in cart', 'payee' => 'paid', 'expediee' => 'shipped'],
  ],
][$lang];

$sousTotal = $panier->total();
// panier vide : pas de frais à afficher (on ne livre pas du vide)
$frais = $panier->estVide() ? 0.0 : $checkout->fraisDePort($panier);
$total = $sousTotal + $frais;
$statut = $etatDemo['statut'];
?>
<!DOCTYPE html>
<html lang="<?= $lang ?>">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="robots" content="noindex">
<title><?= e($S['title']) ?></title>
<style>
  :root { --accent:#329e5a; --ink:#23262b; --muted:#6a7178; --bg:#f6f4ef; --card:#fff; --line:#e4e1d8; --warn:#a84f2d; }
  * { box-sizing:border-box; }
  body { margin:0; font-family:system-ui,-apple-system,'Segoe UI',sans-serif; background:var(--bg); color:var(--ink); padding:18px 14px 30px; }
  .wrap { max-width:660px; margin:0 auto; }
  h1 { font-size:1.35rem; margin:0 0 4px; }
  .sub { color:var(--muted); font-size:.9rem; margin:0 0 18px; }
  .card { background:var(--card); border:1px solid var(--line); border-radius:12px; padding:16px; margin-bottom:14px; }
  .card h2 { font-size:.78rem; text-transform:uppercase; letter-spacing:.07em; color:var(--accent); margin:0 0 10px; }
  .prod { display:flex; justify-content:space-between; align-items:center; padding:7px 0; border-bottom:1px dashed var(--line); gap:8px; }
  .prod:last-child { border-bottom:0; }
  .price { color:var(--muted); white-space:nowrap; }
  button { font:inherit; border:1px solid var(--accent); background:var(--accent); color:#fff; border-radius:8px; padding:7px 14px; cursor:pointer; }
  button.ghost { background:transparent; color:var(--accent); }
  button.warn { background:transparent; color:var(--warn); border-color:var(--warn); }
  button:disabled { opacity:.4; cursor:not-allowed; }
  label { display:flex; align-items:center; gap:8px; padding:5px 0; cursor:pointer; }
  .totaux { border-top:2px solid var(--ink); margin-top:10px; padding-top:10px; }
  .row { display:flex; justify-content:space-between; padding:3px 0; }
  .row.big { font-weight:700; font-size:1.05rem; }
  .statut { display:inline-block; padding:3px 12px; border-radius:999px; font-weight:700; font-size:.85rem; }
  .st-panier   { background:#eef3f7; color:#456; }
  .st-payee    { background:#e6f3ec; color:#267d42; }
  .st-expediee { background:#fdf0e7; color:#a84f2d; }
  .actions { display:flex; gap:8px; flex-wrap:wrap; margin-top:12px; }
  .log { list-style:none; margin:0; padding:0; font-size:.9rem; }
  .log li { padding:5px 0; border-bottom:1px dashed var(--line); }
  .log li:last-child { border-bottom:0; }
  .muted { color:var(--muted); font-size:.85rem; }
  .note { font-size:.82rem; color:var(--muted); margin-top:10px; }
  .credit { text-align:center; font-size:.78rem; color:var(--muted); margin-top:16px; }
  .credit a { color:var(--accent); }
  .resetline { text-align:center; margin-top:10px; }
  .barre { text-decoration:line-through; color:var(--muted); font-weight:400; margin-right:6px; }
</style>
</head>
<body>
<div class="wrap">
  <h1><?= e($S['title']) ?></h1>
  <p class="sub"><?= e($S['sub']) ?></p>

  <div class="card">
    <h2><?= e($S['cat']) ?></h2>
    <?php foreach ($catalogue as $produit => $prix): ?>
    <div class="prod">
      <span><?= e($lang === 'en' ? $catalogueEn[$produit] : $produit) ?></span>
      <span class="price"><?= number_format($prix, 2, ',', ' ') ?> €</span>
      <form method="post" style="margin:0">
        <input type="hidden" name="action" value="ajouter">
        <input type="hidden" name="produit" value="<?= e($produit) ?>">
        <input type="hidden" name="lang" value="<?= e($lang) ?>">
        <button class="ghost" <?= $statut !== 'panier' ? 'disabled' : '' ?>>+ <?= e($S['add']) ?></button>
      </form>
    </div>
    <?php endforeach; ?>
  </div>

  <div class="card">
    <h2><?= e($S['cart']) ?></h2>
    <?php if ($panier->estVide()): ?>
      <p class="muted"><?= e($S['empty']) ?></p>
    <?php else: ?>
      <?php foreach ($panier->lignes() as $produit => $qte): ?>
      <div class="prod">
        <span><?= e($lang === 'en' ? $catalogueEn[$produit] : $produit) ?> × <?= (int)$qte ?></span>
        <span class="price"><?= number_format($catalogue[$produit] * $qte, 2, ',', ' ') ?> €</span>
      </div>
      <?php endforeach; ?>
    <?php endif; ?>

    <form method="post" style="margin-top:12px">
      <input type="hidden" name="action" value="options">
      <input type="hidden" name="lang" value="<?= e($lang) ?>">
      <h2 style="margin-top:6px"><?= e($S['ship']) ?></h2>
      <label><input type="radio" name="transporteur" value="colissimo" <?= $etatDemo['transporteur'] === 'colissimo' ? 'checked' : '' ?>> <?= e($S['colissimo']) ?></label>
      <label><input type="radio" name="transporteur" value="chrono" <?= $etatDemo['transporteur'] === 'chrono' ? 'checked' : '' ?>> <?= e($S['chrono']) ?></label>
      <label><input type="radio" name="transporteur" value="retrait" <?= $etatDemo['transporteur'] === 'retrait' ? 'checked' : '' ?>> <?= e($S['retrait']) ?></label>
      <label style="margin-top:4px"><input type="checkbox" name="promo" <?= $etatDemo['promo'] ? 'checked' : '' ?>> <?= e($S['promo']) ?></label>
      <button class="ghost" <?= $statut !== 'panier' ? 'disabled' : '' ?>><?= e($S['apply']) ?></button>
    </form>

    <div class="totaux">
      <div class="row"><span><?= e($S['subtotal']) ?></span><span><?= number_format($sousTotal, 2, ',', ' ') ?> €</span></div>
      <div class="row"><span><?= e($S['fees']) ?></span>
        <span>
          <?php if ($etatDemo['promo'] && $frais == 0 && $sousTotal >= 50): ?>
            <span class="barre"><?= number_format($transporteurs[$etatDemo['transporteur']]->calculer($panier), 2, ',', ' ') ?> €</span>
          <?php endif; ?>
          <?= number_format($frais, 2, ',', ' ') ?> €
        </span>
      </div>
      <div class="row big"><span><?= e($S['total']) ?></span><span><?= number_format($total, 2, ',', ' ') ?> €</span></div>
    </div>
  </div>

  <div class="card">
    <h2><?= e($S['status']) ?></h2>
    <span class="statut st-<?= e($statut) ?>"><?= e($S['statuts'][$statut]) ?></span>
    <div class="actions">
      <form method="post"><input type="hidden" name="action" value="payer"><input type="hidden" name="lang" value="<?= e($lang) ?>"><button <?= ($statut !== 'panier' || $panier->estVide()) ? 'disabled' : '' ?>><?= e($S['pay']) ?></button></form>
      <form method="post"><input type="hidden" name="action" value="expedier"><input type="hidden" name="lang" value="<?= e($lang) ?>"><button <?= $statut !== 'payee' ? 'disabled' : '' ?>><?= e($S['shipit']) ?></button></form>
      <form method="post"><input type="hidden" name="action" value="annuler"><input type="hidden" name="lang" value="<?= e($lang) ?>"><button class="warn" <?= ($statut === 'panier' && $panier->estVide()) ? 'disabled' : '' ?>><?= e($S['cancel']) ?></button></form>
    </div>
    <p class="note"><?= e($S['note']) ?></p>
  </div>

  <div class="card">
    <h2><?= e($S['log']) ?></h2>
    <?php if (empty($etatDemo['journal'])): ?>
      <p class="muted"><?= e($S['logEmpty']) ?></p>
    <?php else: ?>
      <ul class="log">
        <?php foreach (array_reverse($etatDemo['journal']) as $evt): ?>
        <li><?= e($evt) ?></li>
        <?php endforeach; ?>
      </ul>
    <?php endif; ?>
  </div>

  <div class="resetline">
    <form method="post" style="display:inline"><input type="hidden" name="action" value="reset"><input type="hidden" name="lang" value="<?= e($lang) ?>"><button class="ghost"><?= e($S['reset']) ?></button></form>
  </div>

  <p class="credit"><?= $S['credit'] ?></p>
</div>
</body>
</html>