CHAPITRE 25 – TEMPLATE METHOD

// Classe abstraite définissant le Template Method
abstract class GenerateurRapport {
    // LE TEMPLATE METHOD : Définit le squelette de l'algorithme.
    // Elle est finale (par convention) pour empêcher la redéfinition.
    public generer(titre: string, donnees: any[]): string {
        console.log(`\n📊 Début de la génération du rapport: "${titre}"`);
        
        // 1. Entête (fixe)
        const entete = this.genererEntete(titre);
        
        // 2. Corps (variable - méthode abstraite)
        const corps = this.genererCorps(donnees);
        
        // 3. Pied de page (fixe, avec un hook optionnel)
        const pied = this.genererPied();
        
        // 4. Assemblage (fixe)
        const rapportComplet = this.assembler(entete, corps, pied);
        
        // Hook optionnel après génération
        this.postTraitement(rapportComplet);
        
        console.log("✅ Génération terminée.");
        return rapportComplet;
    }

    // --- Méthodes concrètes (étapes fixes) ---
    private genererEntete(titre: string): string {
        const date = new Date().toLocaleDateString();
        return `RAPPORT: ${titre}\nDate: ${date}\n${'='.repeat(50)}\n`;
    }

    private assembler(entete: string, corps: string, pied: string): string {
        return entete + corps + '\n' + pied;
    }

    // --- Méthodes abstraites (points d'extension OBLIGATOIRES) ---
    protected abstract genererCorps(donnees: any[]): string;

    // --- Hooks (points d'extension OPTIONNELS) ---
    protected genererPied(): string {
        // Comportement par défaut
        return `\n${'-'.repeat(50)}\nFin du rapport.`;
    }

    protected postTraitement(rapport: string): void {
        // Hook vide par défaut. Les sous-classes peuvent l'implémenter si besoin.
        // Ex: Envoyer le rapport par email, le logger, etc.
    }
}

// Sous-classe concrète pour un rapport HTML
class GenerateurRapportHTML extends GenerateurRapport {
    protected genererCorps(donnees: any[]): string {
        console.log("   Génération du corps en HTML...");
        let html = '<table border="1">\n';
        html += '  <tr><th>ID</th><th>Valeur</th></tr>\n';
        for (const item of donnees) {
            html += `  <tr><td>${item.id}</td><td>${item.valeur}</td></tr>\n`;
        }
        html += '</table>';
        return html;
    }

    // Redéfinition du hook pour ajouter des balises HTML autour
    protected genererPied(): string {
        const piedParDefaut = super.genererPied(); // On peut appeler l'implémentation parente
        return `<footer>\n${piedParDefaut}\n</footer>`;
    }

    protected postTraitement(rapport: string): void {
        console.log("   (Hook HTML) Rapport HTML prêt. Peut être servi par un serveur web.");
    }
}

// Sous-classe concrète pour un rapport texte simple
class GenerateurRapportTexte extends GenerateurRapport {
    protected genererCorps(donnees: any[]): string {
        console.log("   Génération du corps en texte brut...");
        let texte = '';
        for (const item of donnees) {
            texte += `  - ${item.id}: ${item.valeur}\n`;
        }
        return texte;
    }
    // On ne redéfinit pas genererPied(), on garde le comportement par défaut.
    // On ne redéfinit pas postTraitement().
}

// Sous-classe pour un rapport CSV
class GenerateurRapportCSV extends GenerateurRapport {
    protected genererCorps(donnees: any[]): string {
        console.log("   Génération du corps en CSV...");
        let csv = 'ID,Valeur\n';
        for (const item of donnees) {
            csv += `${item.id},${item.valeur}\n`;
        }
        return csv;
    }

    protected genererPied(): string {
        return ''; // Le CSV n'a pas de pied de page
    }

    protected postTraitement(rapport: string): void {
        console.log("   (Hook CSV) Vérification de la syntaxe CSV...");
        // Simulation d'une validation
        if (rapport.includes(',,')) {
            console.warn("     Attention: cellule vide détectée.");
        }
    }
}

// --- Scénario d'utilisation ---
console.log("=== GÉNÉRATEUR DE RAPPORTS (Template Method) ===\n");

const donnees = [
    { id: 1, valeur: 'Observation A' },
    { id: 2, valeur: 'Observation B' },
    { id: 3, valeur: 'Observation C' }
];

// Génération HTML
const htmlGenerator = new GenerateurRapportHTML();
const rapportHTML = htmlGenerator.generer('Enquête quotidienne', donnees);
console.log("\n--- Rapport HTML (extrait) ---");
console.log(rapportHTML.substring(0, 150) + "...");

// Génération Texte
const texteGenerator = new GenerateurRapportTexte();
const rapportTexte = texteGenerator.generer('Enquête quotidienne', donnees);
console.log("\n--- Rapport Texte ---");
console.log(rapportTexte);

// Génération CSV
const csvGenerator = new GenerateurRapportCSV();
const rapportCSV = csvGenerator.generer('Données export', donnees);
console.log("\n--- Rapport CSV ---");
console.log(rapportCSV);