L'application nécessite une connexion pour activer toutes les fonctionnalités de génération et de sauvegarde.

1.1. Connexion / Enregistrement

• Cliquez sur le bouton **🔐 Connexion / Enregistrement**.
• **Pour la première fois (Enregistrement)** : Cliquez sur **Pas encore de compte ? Enregistrez-vous.** Remplissez les champs (Email, Nom, Téléphone, Numéro de transaction) et téléchargez la **Preuve de transaction**, puis cliquez sur **Enregistrer**.
• **Pour les utilisateurs existants (Connexion)** : Entrez votre **Email** et **Mot de passe**, puis cliquez sur **Connexion**.
• *Succès :* La fenêtre se ferme, les boutons d'action (Télécharger, Générer) sont **activés**.

Avant de pouvoir synchroniser des données ou déployer le formulaire étudiant, vous devez créer le classeur qui stockera les informations.

1. Allez à l'onglet **🚀 Avancé**.
2. Entrez un nom pour votre client/école dans le champ **Nom du client / École**.
3. Cliquez sur **🆕 Créer le modèle**.
4. Le système créera la feuille Google Sheets et vous fournira son **ID**.
5. **Copiez cet ID**. Il est essentiel pour l'étape suivante.

Pour que votre formulaire d'inscription dynamique soit accessible via un lien public (URL), vous devez **déployer** le script associé au classeur Google Sheets.

/**
 * saveBadgeDriveId(driveId) — persiste un ID de dossier Drive dans ScriptProperties.
 * Appelé depuis le frontend (fire-and-forget).
 */
function saveBadgeDriveId(driveId) {
  try {
    if (!driveId || typeof driveId !== 'string') return;
    PropertiesService.getScriptProperties().setProperty('BADGE_DRIVE_FOLDER_ID', driveId.trim());
  } catch (e) { Logger.log('[saveBadgeDriveId] error: ' + e.message); }
}

/**
 * saveBadgesToDrive(folderId, badgeImagesData) — sauvegarde un tableau de badges
 * (data URIs ou objets {data, name, code}) dans le dossier Drive indiqué.
 * Retourne { saved, errors, results:[{code,url,fileId}] }.
 */
function saveBadgesToDrive(folderId, badgeImagesData) {
  if (!folderId || !Array.isArray(badgeImagesData) || badgeImagesData.length === 0) {
    return { saved: 0, errors: ['Aucun fichier à sauvegarder ou ID de dossier manquant.'], results: [] };
  }
  try {
    const rootFolder = DriveApp.getFolderById(folderId.trim());
    // Store in Badges sub-folder
    let folder;
    const fi = rootFolder.getFoldersByName('Badges');
    folder = fi.hasNext() ? fi.next() : rootFolder.createFolder('Badges');

    let saved = 0;
    const errors = [], results = [];

    badgeImagesData.forEach(function(item, index) {
      try {
        const dataUrl       = typeof item === 'string' ? item : (item && item.data ? item.data : '');
        const recipientCode = String(item && (item.code || item.Code || item.recipientCode) || '').trim();
        const safeCode      = recipientCode.replace(/[^A-Za-z0-9_-]/g, '_');
        const baseName      = (item && typeof item === 'object' && item.name)
          ? String(item.name)
          : (safeCode || 'badge_' + (index + 1) + '_' + Date.now());
        const name = String(baseName).replace(/\.(png|jpg|jpeg)$/i, '') + '.png';
        if (!dataUrl) return;
        const parts = dataUrl.split(',');
        if (parts.length < 2) return;
        const mime   = (parts[0].match(/data:(.*?);base64/) || [])[1] || 'image/png';
        const blob   = Utilities.newBlob(Utilities.base64Decode(parts[1]), mime, name);
        // Overwrite existing same-name file to avoid duplicates
        const existing = folder.getFilesByName(name);
        while (existing.hasNext()) existing.next().setTrashed(true);
        const file = folder.createFile(blob);
        try { file.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.VIEW); } catch (_) {}
        const fileId   = file.getId();
        const driveUrl = 'https://drive.google.com/file/d/' + fileId + '/view?usp=sharing';
        saved++;
        results.push({ code: recipientCode, url: driveUrl, fileId: fileId });
      } catch (err) { errors.push('Badge ' + (index + 1) + ': ' + err.message); }
    });

    return { saved: saved, errors: errors, results: results };
  } catch (e) {
    throw new Error('Erreur accès Drive (dossier ' + folderId + '): ' + e.message);
  }
}

/**
 * saveSingleBadgeToDrive(badge) — sauvegarde un seul badge et retourne son URL.
 * @param {{code:string, name:string, base64:string}} badge
 * @returns {{url:string, fileId:string}}
 */
function saveSingleBadgeToDrive(badge) {
  const folderId = PropertiesService.getScriptProperties().getProperty('BADGE_DRIVE_FOLDER_ID')
                || PropertiesService.getScriptProperties().getProperty('DRIVE_FOLDER_ID') || '';
  if (!folderId) throw new Error('BADGE_DRIVE_FOLDER_ID not set in Script Properties.');
  const folder = DriveApp.getFolderById(folderId);
  const b64  = badge.base64.replace(/^data:image\/\w+;base64,/, '');
  const bytes = Utilities.base64Decode(b64);
  const name  = (badge.name || badge.code || 'badge') + '.png';
  const blob  = Utilities.newBlob(bytes, 'image/png', name);
  const existing = folder.getFilesByName(name);
  while (existing.hasNext()) existing.next().setTrashed(true);
  const file = folder.createFile(blob);
  file.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.VIEW);
  return { url: file.getUrl(), fileId: file.getId() };
}
                      

2.1. Déploiement du Script (Étapes Critiques)

1. **Ouvrir l'éditeur de script** : Ouvrez votre classeur Google Sheets. Cliquez sur **Extensions** < **Apps Script**.
2. **Lancer le déploiement** : Dans l'éditeur de script, cliquez sur **Déployer** (icône 🚀) > **Nouveau déploiement**.
3. **Configurer l'Application Web** :
   • Sous "Sélectionner le type", choisissez **Application Web**.
   • **Exécuter l'application en tant que :** Choisissez votre propre adresse e-mail.
   • **Qui a accès :** Sélectionnez **Tout le monde** (crucial pour le formulaire public).
4. **Déployer et Autoriser** : Cliquez sur **Déployer**. Suivez les étapes d'autorisation (Paramètres avancés > Accéder à [Nom du projet] > Autoriser).
5. **Copiez l'URL** : Une fois le déploiement réussi, copiez l'**URL de l'application Web** affichée.

2.2. Finaliser la Configuration (Lien)

• Retournez à l'onglet **⚙️ Paramètres** de cette application.
• Allez à la section **🔗 Connexion Google Sheets**.
• Collez l'URL de l'application Web dans le champ : **URL de l'application Web Google Apps**.
• Cliquez sur **💾 Sauvegarder Tous les Paramètres**.
• Vous pouvez maintenant distribuer cette URL à vos participants (**4.3. Partage du Formulaire**).

Personnalisez le visuel et les champs de la carte avant de générer les badges.

3.1. Infos, Design & Mise en page

• Modifiez le **Nom de l'École** et la **Promotion**.
• Choisissez le **Design de la Carte** et téléchargez le **Logo de l'École**.
• Ajustez la **Taille du Logo (%)** et la **Taille du Code-barres**.

3.2. Champs de la Carte et Format du Code

• Sélectionnez les **Champs facultatifs** à afficher.
• **Ajoutez un champ personnalisé** ou **Réordonnez les champs** par glisser-déposer.
• Définissez le **Format du Code à Générer** pour l'attribution automatique.

3.3. Connexion Google Sheets (ID)

• Collez l'**ID Google Sheet** (l'identifiant unique de votre classeur) dans le champ dédié.

⚠️ **IMPORTANT :** Cliquez toujours sur **💾 Sauvegarder Tous les Paramètres** après une modification.

4.1. Saisie Manuelle et Photos

• Remplissez les champs et le **Code / ID de l'Étudiant**.
• Utilisez **📷 Ouvrir Caméra** ou **⬆️ Télécharger Photo** pour le portrait.
• **⬇️ Télécharger la Carte** (PNG) ou **🆔 Générer & Sauvegarder** (dans la galerie locale).

4.2. Génération en Vrac et Recherche

• **Recherche rapide (Live Lookup universelle)** : Si les données sont chargées, tapez **3+ caractères** — Code, ID, Nom, Téléphone, ou toute autre donnée présente dans la fiche — pour remplir le formulaire automatiquement. La recherche fonctionne sur **toutes les colonnes**, quel que soit leur nom.
• **Charger les données** : Utilisez **📂 Charger Données (Sheets)** ou **Importer CSV** pour la synchronisation.
• **Lancer le lot** : Cliquez sur **🆔 Lancer Génération en Lot** pour commencer la création en masse (avec option de **Revue par lots**).