Référentiel & publication
Du référentiel Airtable à un catalogue web vivant.
Au départ…
La communication doit publier un catalogue consultable et des pages programme à partir du référentiel métier, tout en gardant la maîtrise de ce que les visiteurs voient.
Ce que nous avons construit
Une copie de publication Supabase et un site Next.js sur Vercel. Les champs sources sélectionnés alimentent le catalogue ; les statuts éditoriaux, médias conservés et requêtes publiques définissent le parcours visiteur.
- Airtable
Maintenir
Modèle métier et relations
- Supabase
Préparer la diffusion
Champs choisis, statuts et médias
- Vercel
Servir le site
Next.js lit le catalogue publiable
Le flux documenté utilise une synchronisation dédiée. Zapier peut coordonner d’autres événements, mais ne remplace pas ce moteur dans ce cas.
Entrez dans l’outil
Écran 1 sur 22. Explorer le catalogue public
Le site propose recherche et filtres à partir du référentiel synchronisé.
Ce que nous voulons changer
Tenir l’offre publique à jour tout en donnant à la communication une décision explicite de publication.
Comment c’est construitModèle de données, code, contrôles et autonomie des équipes
Parcours utilisateur
- 01
Synchroniser les champs sources sélectionnés dans la copie de publication.
- 02
Relire le contenu éditorial et approuver la publication.
- 03
Servir le catalogue consultable et les pages programme liées.
Structure des données et des échanges
| Entité / table | Champs clés | Relations |
|---|---|---|
| Catalogue web | airtable_id · statut · slug | Copie de diffusion Supabase |
| Versions & synchronisations | État · journal · version | Historique de diffusion |
Implémentation technique
- Les champs sont remappés explicitement ; les enregistrements sont mis à jour par airtable_id stable.
- Les visuels nécessaires au site sont copiés dans Storage, plutôt que de dépendre d’URL de pièces jointes temporaires.
- Les nouveaux contenus arrivent en brouillon. Les disparitions sont marquées, avec un contrôle sur les variations importantes du catalogue.
Décision d’ingénierie
Limiter les écritures et préserver les décisions de publication
Adapté de l’upsert par lots et du mapping des champs pilotés par Airtable. Les identifiants source retrouvent les lignes existantes ; les champs éditoriaux de publication sont omis. Une erreur arrête les lots suivants et remonte au rapport. Les lots précédents restent écrits : une reprise peut reconverger, sans transaction globale du catalogue.
import type { SupabaseClient } from "@supabase/supabase-js";type Programme = { sourceId: string; name: string; slug: string;};export async function syncProgrammes(db: SupabaseClient, source: Programme[]) { // Only source-owned fields belong in this mapping. // is_published, editorial content and SEO overrides stay out. const rows = source.map(row => ({ airtable_id: row.sourceId, name: row.name, slug: row.slug, })); let written = 0; for (let offset = 0; offset < rows.length; offset += 500) { const chunk = rows.slice(offset, offset + 500); const { error, count } = await db.from("programmes").upsert(chunk, { onConflict: "airtable_id", count: "exact", }); if (error) { throw new Error(`Catalogue sync stopped after ${written} rows`); } written += count ?? chunk.length; } return { written };}// Database prerequisites: unique airtable_id, new rows default to draft.// Validate slugs and resolve collisions before this writer runs.Extrait adapté de l’implémentation
Contrôles et limites
- Le navigateur ne reçoit pas de jeton Airtable ni de clé Supabase privilégiée.
- Les champs internes et données de personnel ne font pas partie du catalogue public.
- Une synchronisation n’est pas une publication : les droits, statuts et filtres de diffusion ont leur propre rôle.
Qui peut contribuer
- Métier : maintenir les formations, campus et liens Airtable.
- Communication : enrichir et valider la publication dans le back-office web.
- Développeurs : faire évoluer les mappings, contrôles et composants versionnés.
Ce qui documente ce cas
Source de synchronisation et modèle de publication examinés ; catalogue public et fiche formation ouverts. Les captures montrent le vrai parcours, avec les marques masquées.