karbe/src/lib/plugins/registry.ts
Claude Integration 62cc464738 feat(plugins): foundation système Plugin Karbé
- Modèle Prisma Plugin (key, name, description, category, version, enabled,
  config JSONB, migrationsApplied, timestamps) + migration SQL
- PluginRegistry (src/lib/plugins/registry.ts) avec 12 plugins déclarés :
  visuels (theme-guyane, landing-hero, landing-sections, image-gallery-seed,
  demo-carbets-seed), métier (access-type, seasonality, pirogue-providers,
  min-stay), contenus (content-pages, legal-pages), i18n (i18n-fr-en)
- Server helpers (server.ts) : sync, isEnabled, getEnabledKeys, toggle avec
  hooks onEnable/onDisable, updateConfig, cache 5s
- Client bridge (client.tsx) : PluginProvider + useIsPluginEnabled
- Composant <IfPluginEnabled plugin=... fallback=...>
- Guard requirePluginOr404 pour pages et routes
- Page admin /admin/plugins avec table toggle par catégorie + édition config
- Route PATCH /api/admin/plugins/[key] + GET
- Layout async qui sync registry + passe enabledKeys au PluginProvider

Tous plugins en enabled=false par défaut, activation pilotée depuis l'admin.
2026-05-30 22:17:10 +00:00

127 lines
3.8 KiB
TypeScript

/**
* Plugin Karbé — registry statique des plugins disponibles.
*
* Chaque plugin déclaré ici sera synchronisé en DB au démarrage (insertion si absent,
* sans toucher au flag `enabled` existant). L'état (enabled / config) est piloté
* depuis /admin/plugins. Le code des plugins est TOUJOURS présent dans le bundle ;
* l'activation au runtime conditionne juste l'exposition des pages, routes et composants.
*/
export type PluginCategory = "core" | "visual" | "business" | "content" | "i18n";
export interface PluginDescriptor {
key: string;
name: string;
description: string;
category: PluginCategory;
version: string;
}
export const PLUGINS: PluginDescriptor[] = [
// Visuels
{
key: "theme-guyane",
name: "Thème Guyane",
description:
"Palette tropicale (vert canopée, eau Maroni, ocre latérite, bois karbé) + typographies display + tokens Tailwind.",
category: "visual",
version: "0.1.0",
},
{
key: "landing-hero",
name: "Hero d'accueil",
description:
"Refonte de la page d'accueil avec hero plein écran, claim, CTA double Découvrir/Proposer.",
category: "visual",
version: "0.1.0",
},
{
key: "landing-sections",
name: "Sections d'accueil",
description:
"Sections « 2 expériences », « Comment ça marche », « Pour comités d'entreprise », « Témoignages », footer riche.",
category: "visual",
version: "0.1.0",
},
{
key: "image-gallery-seed",
name: "Galerie d'images seed",
description:
"8 images photo-réalistes générées (carbets, intérieurs, pirogue) stockées dans MinIO. Illustrations vectorielles pour les sections.",
category: "visual",
version: "0.1.0",
},
{
key: "demo-carbets-seed",
name: "Carbets de démo",
description:
"5-8 carbets d'exemple avec photos, GPS réels, types d'accès variés. Désactivation = soft-delete via tag.",
category: "visual",
version: "0.1.0",
},
// Métier
{
key: "access-type",
name: "Type d'accès route/fleuve",
description:
"Distinction ROAD_AND_RIVER vs RIVER_ONLY (badge, filtre recherche, fiche enrichie). Migration soft.",
category: "business",
version: "0.1.0",
},
{
key: "seasonality",
name: "Saisonnalité",
description:
"Saison sèche / pluies / étiage. Bandeau d'alerte, dispo conditionnelle, filtre « ouvert maintenant ».",
category: "business",
version: "0.1.0",
},
{
key: "pirogue-providers",
name: "Prestataires pirogue",
description:
"Partenaires pirogue + mode transport sur Carbet (OWNER_PROVIDES / SELF_ARRANGE / PARTNER_PROVIDER).",
category: "business",
version: "0.1.0",
},
{
key: "min-stay",
name: "Durée min/max séjour",
description:
"Contraintes nuits min/max, capacité min, règles week-end CE vs semaine public mappées dans Availability.",
category: "business",
version: "0.1.0",
},
// Contenus / i18n
{
key: "content-pages",
name: "Pages de contenu",
description:
"Pages markdown éditables depuis l'admin (À propos, FAQ, Comment ça marche, Pour CE, Devenir loueur).",
category: "content",
version: "0.1.0",
},
{
key: "i18n-fr-en",
name: "i18n FR + EN",
description: "Routes [locale]/, détection navigateur, switcher header. Plugin désactivable = FR pur sans préfixe.",
category: "i18n",
version: "0.1.0",
},
{
key: "legal-pages",
name: "Pages légales",
description: "CGV, RGPD, mentions légales (absorbe SYS-9). Markdown + rendu statique.",
category: "content",
version: "0.1.0",
},
];
export const PLUGIN_KEYS = PLUGINS.map((p) => p.key);
export type PluginKey = (typeof PLUGIN_KEYS)[number];
export function findDescriptor(key: string): PluginDescriptor | undefined {
return PLUGINS.find((p) => p.key === key);
}