Promotions : publication programmée et affichage limité à la période

Deux comportements demandés :

1. Une promotion n'apparaît sur le site que pendant sa période de validité.
   Les lectures publiques passent par `VISIBLE_PROMO` (`src/lib/queries.ts`) :
   statut `live` **et** fenêtre `starts_on` / `ends_on`, journée calculée en
   Europe/Paris pour qu'un conteneur en UTC ne retire pas une offre deux
   heures trop tôt. Le statut n'est pas touché : hors période, le backoffice
   explique pourquoi l'offre n'est pas visible (`visibilityNote`) et elle
   revient d'elle-même si les dates changent.

2. La publication peut être programmée. `promotions.publish_at` : l'adhérent
   propose une date, le modérateur la garde, la déplace ou la vide dans le
   formulaire « Valider ». Avec une échéance future la promotion passe au
   statut `scheduled` — rien n'est visible, rien n'est diffusé — et
   `releaseDuePromotions()` fait la bascule à l'heure dite, site et réseaux
   ensemble. Un bouton « Publier maintenant » court-circuite l'attente.

Mécanique :
- `src/lib/promo-schedule.ts` (pur, testé) : conversion `datetime-local` ⇄
  heure de l'association, changements d'heure compris, et refus d'une saisie
  illisible plutôt qu'une publication immédiate involontaire.
- `src/lib/promo-publish.ts` reprend `publishPromoShares()` : deux appelants
  désormais, une action serveur et la boucle de libération, qui n'a pas de
  requête et ne peut donc pas appeler `revalidatePath()`. Idem pour
  `logActivity()` dans `src/lib/activity-log.ts`.
- La bascule `scheduled → live` est un `UPDATE … RETURNING` filtré sur le
  statut : atomique, donc pas de double publication même à plusieurs
  instances, en plus de la garde existante sur `social_posts`.
- Déclencheur : `src/instrumentation.ts`, boucle d'une minute avec rattrapage
  au démarrage (`PROMO_SCHEDULER=off` la désactive). Le travail vit dans
  `instrumentation-node.ts`, écarté du bundle edge par `next.config.mjs` :
  Next compile aussi l'instrumentation pour le middleware, où `pg` ne peut
  pas être embarqué.

Migration 0016 : `promo_status += 'scheduled'`, `promotions.publish_at`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QXNXRC4j5VLfKvpyyisrnb

src/lib/promo-validity.ts

@@ -88,3 +88,30 @@ export function isRangeInvalid(promo: PromoValidity): boolean {
   if (!start || !end) return false;
   return Date.UTC(end.year, end.month, end.day) < Date.UTC(start.year, start.month, start.day);
 }
+
+/** `true` si la période n'a pas encore commencé. */
+export function isNotStarted(promo: PromoValidity, today = new Date()): boolean {
+  const start = parse(promo.startsOn);
+  if (!start) return false;
+  return today.getTime() < Date.UTC(start.year, start.month, start.day);
+}
+
+/**
+ * Pourquoi une promotion validée n'apparaît pas sur le site aujourd'hui.
+ *
+ * Les lectures publiques (`src/lib/queries.ts`) écartent les offres hors
+ * période ; ce message l'explique côté backoffice, pour qu'un adhérent ne
+ * cherche pas une offre « en ligne » qui n'est pas encore, ou plus, affichée.
+ * Renvoie `null` quand la promotion est bien visible.
+ */
+export function visibilityNote(promo: PromoValidity, today = new Date()): string | null {
+  const start = parse(promo.startsOn);
+  const end = parse(promo.endsOn);
+  if (start && isNotStarted(promo, today)) {
+    return `Pas encore affichée : elle apparaîtra sur le site le ${full(start)}.`;
+  }
+  if (end && isExpired(promo, today)) {
+    return `Période terminée le ${full(end)} : elle n'apparaît plus sur le site.`;
+  }
+  return null;
+}