Implementa le notifiche email via Gmail da un worker Docker (DD-036)

Migration m22: coda notifiche_email_coda, preferenze_utente, trigger che
accoda ogni notifica di notifiche_utente e tre funzioni RPC riservate
alla service role. Worker in mailer/ (bun + nodemailer, solo polling in
uscita) con backoff, tetto giornaliero e healthcheck. Interruttore
«Email» in Profilo → Opzioni, acceso di default. Test unit e di
integrazione; documentazione aggiornata (DD-036 accettata).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

src/lib/preferenze-utente.ts

@@ -0,0 +1,60 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { supabaseNuoveTabelle } from "@/integrations/supabase/client-nuove-tabelle";
+import { useSessione } from "./auth";
+
+/**
+ * Preferenze del singolo account (M22), non dello slot giocatore: oggi solo l'interruttore
+ * «Email» di Profilo → Opzioni (DD-036). Nessuna riga in `preferenze_utente` vuol dire
+ * «mail attive»: la riga nasce solo quando il giocatore tocca l'interruttore. Lettura e
+ * scrittura passano dalla RLS (ognuno vede e scrive solo la propria), senza route API.
+ */
+export type RigaPreferenze = { email_notifiche: boolean };
+
+/** Assenza di riga = valori di default: le email sono attive. */
+export function emailAttive(riga: RigaPreferenze | null | undefined): boolean {
+  return riga?.email_notifiche ?? true;
+}
+
+const chiavePreferenze = (utenteId: string | null) => ["preferenze-utente", utenteId] as const;
+
+/** Stato dell'interruttore «Email» dell'account e mutazione per cambiarlo. */
+export function useEmailNotifiche() {
+  const { utenteId } = useSessione();
+  const qc = useQueryClient();
+
+  const query = useQuery({
+    queryKey: chiavePreferenze(utenteId),
+    queryFn: async (): Promise<RigaPreferenze | null> => {
+      const { data, error } = await supabaseNuoveTabelle
+        .from("preferenze_utente")
+        .select("email_notifiche")
+        .eq("auth_user_id", utenteId)
+        .maybeSingle();
+      if (error) throw error;
+      return (data as RigaPreferenze | null) ?? null;
+    },
+    enabled: !!utenteId,
+    staleTime: 5 * 60_000,
+  });
+
+  const imposta = useMutation({
+    mutationFn: async (attive: boolean) => {
+      const { error } = await supabaseNuoveTabelle.from("preferenze_utente").upsert(
+        {
+          auth_user_id: utenteId,
+          email_notifiche: attive,
+          aggiornata_il: new Date().toISOString(),
+        },
+        { onConflict: "auth_user_id" },
+      );
+      if (error) throw error;
+      return attive;
+    },
+    onSuccess: (attive) => {
+      const riga: RigaPreferenze = { email_notifiche: attive };
+      qc.setQueryData(chiavePreferenze(utenteId), riga);
+    },
+  });
+
+  return { attive: emailAttive(query.data), pronta: !query.isPending, imposta };
+}

src/routes/profilo.tsx

@@ -1,7 +1,7 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
 import { useEffect, useRef, useState } from "react";
 import { toast } from "sonner";
-import { Flame, Trash2, Bell, LogOut, ShieldCheck, Bug, Lightbulb } from "lucide-react";
+import { Flame, Trash2, Bell, Mail, LogOut, ShieldCheck, Bug, Lightbulb } from "lucide-react";
 import { cn } from "@/lib/utils";
 import { Card, PageHeader, StatTile, TeamLogo } from "@/components/crapp/ui-bits";
 import { BarraSottosezioni } from "@/components/crapp/BarraSottosezioni";
@@ -34,6 +34,7 @@ import {
 } from "@/lib/giocatori-squadra";
 import { esci } from "@/lib/auth";
 import { useIsAdmin } from "@/lib/ruoli";
+import { useEmailNotifiche } from "@/lib/preferenze-utente";
 import { Reveal } from "@/components/motion/Reveal";
 import { version as APP_VERSION } from "../../package.json";
 
@@ -255,6 +256,7 @@ function TabOpzioni({ giocatoreId }: { giocatoreId: string }) {
   const [notifiche, setNotifiche] = useState(false);
   const [inCorso, setInCorso] = useState(false);
   const [supportate, setSupportate] = useState(true);
+  const email = useEmailNotifiche();
 
   useEffect(() => {
     setSupportate(pushSupportato());
@@ -283,6 +285,17 @@ function TabOpzioni({ giocatoreId }: { giocatoreId: string }) {
     }
   }
 
+  async function cambiaEmail() {
+    if (email.imposta.isPending) return;
+    const attive = !email.attive;
+    try {
+      await email.imposta.mutateAsync(attive);
+      toast.success(attive ? "Email attive" : "Email disattivate");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "Impossibile salvare la preferenza");
+    }
+  }
+
   async function logout() {
     try {
       await esci();
@@ -322,6 +335,31 @@ function TabOpzioni({ giocatoreId }: { giocatoreId: string }) {
             <Bell className="h-4 w-4" />
           </span>
         </button>
+        <button
+          type="button"
+          onClick={cambiaEmail}
+          disabled={!email.pronta || email.imposta.isPending}
+          className="flex min-h-11 w-full items-center justify-between gap-3 px-4 py-3 text-left text-sm disabled:opacity-60"
+        >
+          <span className="min-w-0">
+            <span className="block truncate">Email</span>
+            <span className="block text-xs text-muted-foreground">
+              {email.attive
+                ? "Le notifiche arrivano anche via email"
+                : "Nessuna email, solo notifiche in app"}
+            </span>
+          </span>
+          <span
+            className={cn(
+              "grid h-8 w-8 shrink-0 place-items-center rounded-xl",
+              email.attive
+                ? "bg-accent-grad text-accent-foreground"
+                : "bg-secondary text-muted-foreground",
+            )}
+          >
+            <Mail className="h-4 w-4" />
+          </span>
+        </button>
         {admin ? (
           <Link
             to="/admin"