refine: required confirmation_email field on both student forms, StudentEmail uses it directly

- Add dedicated 'confirmation_email' (type=email, required) field to student form at end of submission (partage + admin). - ThesisCreateController now validates it is present and a valid email; form is rejected if missing/invalid. - Autofocus mapping for confirmation_email errors. - StudentEmail uses confirmation_email directly (removed extractEmail hack that mined email from free-form contact field).
2026-05-06 19:19:19 +02:00 · 2026-04-20 15:02:28 +02:00
parent fa75ca4a65
commit e21a4d81a2
9 changed files with 189 additions and 1 deletions
--- a/app/src/StudentEmail.php
+++ b/app/src/StudentEmail.php
@@ -0,0 +1,112 @@
+<?php
+
+/**
+ * StudentEmail — builds and sends confirmation e-mails to students
+ * after a successful TFE submission via a share-link form.
+ *
+ * The e-mail is addressed to the confirmation e-mail field provided
+ * by the student and contains a recap of every field submitted.
+ */
+class StudentEmail {
+
+    /**
+     * Build the HTML body for the confirmation e-mail.
+     *
+     * @param array $thesis  Thesis row (from getThesis / v_theses_full)
+     * @return string        HTML body
+     */
+    private static function buildHtml(array $thesis): string {
+        $rows = '';
+        $fields = [
+            'Identifiant'  => $thesis['identifier']             ?? '',
+            'Titre'        => $thesis['title']                  ?? '',
+            'Sous-titre'   => $thesis['subtitle']               ?? '',
+            'Auteur·ice(s)'=> $thesis['authors']                ?? '',
+            'Année'        => $thesis['year']                   ?? '',
+            'Orientation'  => $thesis['orientation']            ?? '',
+            'Atelier pluridisciplinaire' => $thesis['ap_program'] ?? '',
+            'Finalité'     => $thesis['finality_type']          ?? '',
+            'Synopsis'     => $thesis['synopsis']               ?? '',
+            'Langue(s)'    => $thesis['languages']              ?? '',
+            'Format(s)'    => $thesis['formats']                ?? '',
+            'Mots-clés'    => $thesis['keywords']               ?? '',
+            'Promoteur·ice(s)' => $thesis['jury_promoteurs']    ?? '',
+            'Président·e du jury' => $thesis['jury_president']  ?? '',
+            'Lecteurs·rices' => $thesis['jury_lecteurs']        ?? '',
+            'Durée / Taille' => $thesis['file_size_info']       ?? '',
+            'Lien'         => $thesis['baiu_link']              ?? '',
+            'Type d\'accès' => $thesis['access_type']           ?? '',
+            'Licence'      => $thesis['license_type']           ?? '',
+        ];
+
+        foreach ($fields as $label => $value) {
+            $v = $value === '' ? '–' : htmlspecialchars((string)$value);
+            $rows .= "<tr><th style='text-align:left;padding:6px 10px;border-bottom:1px solid #eee'>"
+                   . htmlspecialchars($label) . "</th>"
+                   . "<td style='padding:6px 10px;border-bottom:1px solid #eee'>{$v}</td></tr>\n";
+        }
+
+        return <<<HTML
+        <div style="font-family:system-ui,sans-serif;max-width:600px;margin:0 auto;color:#333">
+            <h1 style="font-size:1.4rem;color:#222">Merci — ton TFE a bien été enregistré 🎉</h1>
+            <p style="color:#555;font-size:0.95rem">
+                Voici un récapitulatif de ta soumission. Tu n'as pas besoin de répondre à cet e-mail.
+            </p>
+            <table style="width:100%;border-collapse:collapse;margin-top:1.5rem">
+            {$rows}
+            </table>
+            <p style="margin-top:2rem;font-size:0.85rem;color:#999">
+                Plateforme xamxam · erg Bruxelles
+            </p>
+        </div>
+        HTML;
+    }
+
+    /**
+     * Send a confirmation e-mail for a given thesis.
+     *
+     * @param Database $db
+     * @param int      $thesisId
+     * @param array    $postData Raw $_POST (must contain 'confirmation_email')
+     * @return bool              True when sent, false otherwise
+     */
+    public static function sendConfirmation(
+        Database $db,
+        int      $thesisId,
+        array    $postData
+    ): bool {
+        // ── 1. Read e-mail from confirmation field ─────────────────────────
+        $to = trim($postData['confirmation_email'] ?? '');
+        if ($to === '' || filter_var($to, FILTER_VALIDATE_EMAIL) === false) {
+            error_log('[StudentEmail] No valid confirmation e-mail — skipping thesis #' . $thesisId);
+            return false;
+        }
+
+        // ── 2. Check SMTP config ────────────────────────────────────────────
+        if (!SmtpRelay::isConfigured($db)) {
+            error_log('[StudentEmail] SMTP not configured — skipping thesis #' . $thesisId);
+            return false;
+        }
+
+        // ── 3. Fetch thesis data ────────────────────────────────────────────
+        $thesis = $db->getThesis($thesisId);
+        if (!$thesis) {
+            error_log('[StudentEmail] Thesis #' . $thesisId . ' not found after creation');
+            return false;
+        }
+
+        // ── 4. Send ─────────────────────────────────────────────────────────
+        $subject   = 'Merci — ton TFE a bien été enregistré';
+        $htmlBody  = self::buildHtml($thesis);
+
+        $result = SmtpRelay::send($db, $to, $subject, $htmlBody);
+
+        if ($result) {
+            error_log("[StudentEmail] Confirmation sent to {$to} for thesis #{$thesisId}");
+        } else {
+            error_log("[StudentEmail] Failed to send to {$to} for thesis #{$thesisId}");
+        }
+
+        return $result;
+    }
+}