Tableau de bord /nouvelles — Guide pour assistants IA

Pour le contexte général du site CJEAO, voir CLAUDE.md à la racine.

Le tableau de bord /nouvelles est la fonctionnalité la plus complexe du site : ~20 sources de données opérationnelles + ~15 sources d’articles de presse, le tout agrégé en widgets sur une seule page. C’est de loin la zone où l’on passe le plus de temps de développement.

Architecture en 1 minute

┌──────────────┐    cron     ┌────────────────────┐    REST   ┌──────────┐
│ Source web   │ ─────────→  │  Netlify Function  │  ──────→  │ Supabase │
│ (RSS, HTML,  │             │  nouvelles-*.js    │   upsert  │  table   │
│  API, CSV)   │             └────────────────────┘           └────┬─────┘
└──────────────┘                                                   │
                                                                   │ SELECT (anon)
                                                                   ▼
                                                          ┌─────────────────┐
                                                          │ nouvelles.astro │
                                                          │  render widget  │
                                                          └─────────────────┘

• Une source ⇄ une fonction Netlify ⇄ une table Supabase ⇄ un widget
• Les crons écrivent (via SUPABASE_SERVICE_KEY), le client lit en direct via SUPABASE_ANON_KEY (RLS SELECT public)
• Filet de secours : nouvelles-proxy.js qui agrège les tables côté serveur si la lecture directe échoue

Inventaire des sources

Données opérationnelles (1 table = 1 ligne unique, schéma {id:1, ...payload, mis_a_jour})

Sources d’agenda (widget consolidé)

Le widget Agenda déduplique entre Loisirs A-O et Ville LS (match flou par date + similitude de titre). Ville LS gagne en cas de conflit (source officielle).

Sources d’articles de presse (table partagée nouvelles_articles, schéma

{source, titre, url, resume, date_publication, image_url, mis_a_jour})

Chaque function fait INSERT ... ON CONFLICT DO UPDATE (upsert) avec une contrainte unique sur url.

Fonctions auxiliaires

• nouvelles-proxy.js — agrège toutes les tables en un seul JSON (filet de secours)
• nouvelles-archives.js — gestion des archives
• nouvelles-commentaire.js — formulaire de suggestions (GET/POST)
• nouvelles-healthcheck.js — monitoring interne (anon: aucun accès)
• nouvelles-presence.js — compteur « en ligne » first-party (battement + table presence)
• push-subscribe.js / push-unsubscribe.js / push-envoyer.js — push notifications
• facebook-feed.js — publication automatique vers Facebook
• envoyer-rappels.js — rappels d’inscription aux activités

Conventions strictes

Schéma d’une nouvelle table « widget »

create table if not exists public.nouvelles_xxx (
  id smallint primary key default 1,         -- toujours 1 ligne
  ...payload jsonb ou colonnes typées...,
  mis_a_jour timestamptz not null default now()
);
alter table public.nouvelles_xxx enable row level security;
create policy "lecture publique" on public.nouvelles_xxx
  for select to anon using (true);
grant select on public.nouvelles_xxx to anon;

Squelette d’une nouvelle function nouvelles-xxx.js

import { withSentry } from '../lib/sentry.js';

export const config = {
  schedule: '0 8 * * *', // cron Netlify (en UTC)
};

const __sentryHandler = async () => {
  const SUPABASE_URL = process.env.SUPABASE_URL;
  const SUPABASE_SERVICE_KEY = process.env.SUPABASE_SERVICE_KEY;
  if (!SUPABASE_URL || !SUPABASE_SERVICE_KEY) {
    console.error('[xxx] Variables manquantes');
    return new Response('Erreur de configuration', { status: 500 });
  }

  // 1. Fetch source
  // 2. Parse
  // 3. Upsert : POST /rest/v1/nouvelles_xxx avec Prefer: resolution=merge-duplicates

  return new Response(JSON.stringify({ ok: true, ... }), { status: 200 });
};

export default withSentry(__sentryHandler);

Ajouter une nouvelle source en 5 étapes

1. Migration SQL dans supabase/migrations/AAAAMMJJ_nom.sql (appliquer manuellement dans Supabase SQL Editor)
2. Function netlify/functions/nouvelles-xxx.js selon le squelette
3. Proxy (nouvelles-proxy.js) — ajouter le fetchTable(...), le res, le data, et la clé dans le payload final
4. Widget dans src/pages/nouvelles.astro :
   • Ajouter à TABLES_NOUVELLES (mapping clé → nom de table)
   • Écrire la fonction renderXxx(data) qui produit du HTML
   • Ajouter <div id="widget-xxx"> dans le markup
   • Ajouter if (wXxx && data.xxx) wXxx.innerHTML = renderXxx(data.xxx); dans appliquerDonnees
5. Méthodologie (src/pages/nouvelles/methodologie.astro) — ligne dans le tableau des sources

Pièges connus (apprentissages durs)

FacetWP / lazy-load nonce-protégé

• Sites concernés : lasarre.ca/calendrier-des-activites/
• Le HTML initial ne montre que les premiers items (3 dans ce cas), la suite s’affiche via un AJAX /wp-json/facetwp/v1/refresh qui exige un cookie + nonce → pas reproductible côté serveur.
• Workaround : se contenter de ce qui est dans le HTML initial. Documenter la limite dans methodologie.astro.

RSS de réseaux WordPress multi-sites

• Sites concernés : Mon Abitibi (réseau Mon La Tuque / Mon Joliette / Mon Victo, etc.)
• Le flux republie automatiquement le contenu des sites jumeaux → critiques automobiles, économie nationale, etc. dans un flux régional.
• Workaround : filtrer sur le GUID (new URL(item.guid).hostname) pour ne garder que l’host attendu.

API REST WordPress qui n’expose pas les dates d’événements

• Sites concernés : lasarre.ca/wp-json/wp/v2/event
• Le champ date du post est la date d’IMPORT en lot dans le CMS, pas la date réelle de l’événement. Les dates réelles sont dans des post-meta non exposés.
• Workaround : scraper la page HTML qui rend les dates correctement.

Pages détail avec dates stale d’une année antérieure

• Sites concernés : lasarre.ca/evenements/*
• Les pages détail affichent souvent des dates de l’année précédente (probablement parce que les événements sont dupliqués/copiés d’une année à l’autre sans mettre à jour la date canonique).
• Workaround : ne pas faire confiance aux pages détail, utiliser uniquement les pages listing qui rendent les dates par occurrence.

Quebec 511 retourne toutes les entraves de la route

• Workaround : netlify/lib/abitibi-temiscamingue.js expose la liste des municipalités d’A-T + lieux-dits, on filtre sur la localisation de chaque entrave.

Stratégie de filtrage

Côté source (filtres dans les ingest functions)

• Mots-clés régionaux (Radio-Canada) : tableau MOTS_REGION avec 60+ toponymes → l’article doit en mentionner au moins un
• GUID host (Mon Abitibi) : new URL(item.guid).hostname === 'monabitibi.ca'
• Géolocalisation (Quebec 511, essence) : filtrage contre abitibi-temiscamingue.js

Côté affichage (filtre Abitibi-Ouest dans nouvelles.astro)

• Whitelist : 23 municipalités MRC A-O
• Article mentionnant A-O → affiché
• Article 100 % local (Ville LS, MRC AO, CSSLA, École musique AO) → toujours affiché
• Article mentionnant UNIQUEMENT une autre MRC → masqué
• Article général/provincial → affiché par défaut

Dédup agenda

• Ville LS prioritaire sur Loisirs A-O
• Match flou : même date YYYY-MM-DD + titres similaires (titre contient l’autre OU ≥ 3 mots significatifs partagés de ≥ 4 lettres)

Modèle de lecture côté client

nouvelles.astro lit directement Supabase (clé anon) en priorité — la function nouvelles-proxy.js n’est qu’un filet de secours. Cette stratégie économise des invocations Netlify (les lectures direct Supabase ne coûtent rien côté Netlify) et permet l’auto-refresh sans surcharger nos quotas.

Quand on ajoute une source au widget, il faut donc s’assurer que :

• La table a bien RLS + grant SELECT to anon
• Elle est mappée dans TABLES_NOUVELLES (pour la lecture directe)
• Elle est aussi dans nouvelles-proxy.js (pour le filet de secours)

Ce qu’il ne faut pas faire

• Ne pas exposer la clé SUPABASE_SERVICE_KEY côté client (jamais).
• Ne pas committer la migration SQL sans l’appliquer dans Supabase — sinon le déploiement casse à la première exécution.
• Ne pas reproduire le contenu intégral d’un article — on extrait toujours titre, résumé court, image, et on renvoie au lien original.
• Ne pas ajouter une source qui n’est pas dans l’esprit du tableau : focus Abitibi-Ouest régional, pas du contenu national.
• Ne pas oublier la documentation — chaque nouvelle source doit apparaître dans methodologie.astro (transparence).

Notes & todos en cours

Voir docs/notes-nouvelles-todo.md pour le carnet de travail.