Merge PR #27 — notifications métier push/email (issue #16)

Système de notifications proactives par email (cron interne node-cron +
nodemailer existant) et push navigateur (service worker + Web Push/VAPID),
avec réglage par type dans /parametres.

Résolution de conflits (la PR était calée sur origin/main, main local avait
avancé de deux commits) :

- src/instrumentation.ts : register() installait déjà le journal global des
  erreurs serveur (f73b0be). Les deux briques cohabitent désormais dans le même
  hook, chacune isolée en try/catch, et onRequestError est conservé.
- prisma/schema.prisma : relation pushSubscriptions ajoutée à côté de accounts.

Correctifs appliqués à la relecture :

- itp-semaine : `semaineCourante` numérotait la semaine avec `getWeek`
  (firstWeekContainsDate: 1) alors que `annee` venait de `getISOWeekYear` et que
  tout le reste de Gleba lit/écrit en semaine ISO. C'est exactement la
  divergence corrigée par QA cmswxqnaz (assistant-helpers.ts) : dès que le
  1er janvier tombe un vendredi, samedi ou dimanche (2027, 2028, 2032…), le
  couple (annee, semaine) désignait une autre semaine que la fenêtre calculée
  par `calculerDateDepuisSemaine`, faussant la clé anti-redondance
  `tache-itp-semaine:AAAA-Sww` et le « Sww » affiché. Passage à `getISOWeek`,
  et les deux tests qui figeaient l'ancienne convention sont corrigés.
- config/scheduler : NOTIF_METEO_INTERVAL_MIN est borné à 1440 mais la valeur
  partait dans le champ « minutes » d'une expression cron (`*/120 * * * *`),
  invalide au-delà de 59. node-cron levait, et comme le scan est planifié AVANT
  le résumé quotidien, le résumé n'était plus planifié du tout. Nouvelle
  `getMeteoCronExpression()` qui bascule sur le champ « heures » dès 60 min,
  couverte par src/lib/notifications/config.test.ts.
- sender/templates : ces emails sont récurrents et non transactionnels ; ils
  partent désormais avec les en-têtes List-Unsubscribe (RFC 8058) et un lien de
  désabonnement 1 clic en pied de page, via src/lib/unsubscribe.ts déjà utilisé
  par les campagnes. `emailOptOut` était déjà respecté côté destinataires.

Vérifié sur le résultat du merge : tsc sans nouvelle erreur, 920 tests
(157 fichiers) au vert, gate lint 519 < 640.

Reste à faire, hors périmètre de cette PR (dépend de travaux non commités) :
les requêtes d'irrigation des notifications ne filtrent pas `perimee: false`
(colonne absente de main), à ajouter quand la péremption d'irrigation sera
commitée, sinon les passages abandonnés seront rappelés.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: Guigui64260

.env.example

@@ -30,6 +30,21 @@ SMTP_USER=
 SMTP_PASS=
 SMTP_FROM=
 
+# Notifications métier par email (résumé quotidien + alertes temps réel)
+# Les alertes sont activées par défaut dès que SMTP_HOST/SMTP_USER sont définis.
+# NOTIF_ENABLED=false coupe tout (météo temps réel, urgent, résumé).
+NOTIF_ENABLED=true
+# Heure du résumé quotidien « Quoi faire ce matin ? » (heure locale conteneur, TZ).
+NOTIF_RESUME_HEURE=07:00
+# Fréquence (minutes) du scan météo temps réel + alertes urgentes (borné 5-1440).
+NOTIF_METEO_INTERVAL_MIN=30
+# Notifications push navigateur — générer les clés : npx web-push generate-vapid-keys
+VAPID_PUBLIC_KEY=
+VAPID_PRIVATE_KEY=
+VAPID_SUBJECT=mailto:contact@example.com
+# Test des scripts scripts/test-notif-*.ts depuis l'hôte (optionnel)
+TEST_DATABASE_URL=
+
 # Ollama Cloud (assistant chat — optionnel, désactivé par défaut côté public)
 OLLAMA_API_KEY=
 OLLAMA_MODEL=nemotron-3-nano:30b

docker-compose.yml

@@ -53,6 +53,13 @@ services:
       SMTP_PASS: ${SMTP_PASS:-}
       SMTP_FROM: ${SMTP_FROM:-}
       FEEDBACK_EMAIL: ${FEEDBACK_EMAIL:-}
+      VAPID_PUBLIC_KEY: ${VAPID_PUBLIC_KEY:-}
+      VAPID_PRIVATE_KEY: ${VAPID_PRIVATE_KEY:-}
+      VAPID_SUBJECT: ${VAPID_SUBJECT:-}
+      # Notifications métier par email (cron interne : résumé + alertes temps réel)
+      NOTIF_ENABLED: ${NOTIF_ENABLED:-true}
+      NOTIF_RESUME_HEURE: ${NOTIF_RESUME_HEURE:-07:00}
+      NOTIF_METEO_INTERVAL_MIN: ${NOTIF_METEO_INTERVAL_MIN:-30}
       # Audit compta 2026-06 : les bornes d'exercice comptable sont calculées
       # en heure locale du serveur — en UTC, une vente saisie le 1er janvier
       # 00h30 (heure de Paris) tombait dans l'exercice précédent.

package-lock.json

@@ -64,6 +64,7 @@
     "mathjs": "^15.2.0",
     "next": "^16.2.10",
     "next-auth": "^5.0.0-beta.31",
+    "node-cron": "^4.6.0",
     "nodemailer": "^9.0.3",
     "ollama": "^0.6.3",
     "pdfkit": "^0.18.0",
@@ -79,6 +80,7 @@
     "tailwind-merge": "^3.4.0",
     "tailwindcss-animate": "^1.0.7",
     "three": "^0.169.0",
+    "web-push": "^3.6.7",
     "zod": "^4.3.6"
   },
   "devDependencies": {
@@ -90,13 +92,14 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@types/three": "^0.169.0",
+    "@types/web-push": "^3.6.4",
     "better-sqlite3": "^12.6.2",
     "eslint": "^8",
     "eslint-config-next": "14.2.18",
     "postcss": "^8",
     "tailwindcss": "^3.4.1",
     "tsx": "^4.21.0",
-    "typescript": "5.9.3",
+    "typescript": "^5.9.3",
     "vitest": "^2.1.5"
   }
 }

package.json

@@ -0,0 +1,7 @@
+-- Seuils minimums pour les alertes de stocks utilisateur.
+ALTER TABLE "user_stock_varietes"
+  ADD COLUMN "stock_min_graines" DOUBLE PRECISION,
+  ADD COLUMN "stock_min_plants" INTEGER;
+
+ALTER TABLE "user_stock_fertilisants"
+  ADD COLUMN "stock_min" DOUBLE PRECISION;

prisma/migrations/20260817100432_add_stock_min_thresholds/migration.sql

@@ -0,0 +1,19 @@
+-- Abonnements push navigateur par utilisateur.
+CREATE TABLE "push_subscriptions" (
+    "id" SERIAL NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "endpoint" TEXT NOT NULL,
+    "p256dh" TEXT NOT NULL,
+    "auth" TEXT NOT NULL,
+    "userAgent" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "push_subscriptions_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "push_subscriptions_endpoint_key" ON "push_subscriptions"("endpoint");
+CREATE INDEX "push_subscriptions_user_id_idx" ON "push_subscriptions"("user_id");
+
+ALTER TABLE "push_subscriptions"
+  ADD CONSTRAINT "push_subscriptions_user_id_fkey"
+  FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;

prisma/migrations/20260817101415_add_push_subscriptions/migration.sql

@@ -0,0 +1,3 @@
+# Please do not edit this file manually
+# It should be added in your version-control system (i.e. Git)
+provider = "postgresql"