# Hyper'Num — Documentation maître de la plateforme > **Socle figé :** V1.0.0 « Genesis » — gel officiel du 2026-06-27 > **Version courante :** V1.4.35 « Studio » — 2026-08-23 (lignée post-Genesis, stable) > **Propriétaire / éditeur :** Honorus Tech · **Produit :** Hyper'Num · **Modèle :** SaaS marque blanche > **Statut du document :** source unique de vérité — consolide `docs/hypernum/v1/*`, `docs/hypernum/v1.1/*`, `docs/hypernum/architecture/*`, les rapports de phase (0 → 49) et la mémoire projet. > **Source de vérité version :** `src/hypernum/core/version.ts` (constante `HYPERNUM_VERSION`) > **Mise à jour :** ce document est réécrit manuellement à chaque nouvelle lignée. Un marqueur `HYPERNUM_DOC_VERSION` en tête de fichier garantit la cohérence avec `HYPERNUM_VERSION` — un bandeau d'avertissement apparaît sur `/manuel/plateforme-complete` en cas de désynchronisation. Ce document décrit **l'intégralité de la plateforme Hyper'Num** : sa raison d'être, son architecture technique, ses 37 modules Genesis + le module Pack de communication Emissary, son cycle de vie du contenu, sa sécurité, ses performances, son historique de construction et ses guides opérationnels. Il est destiné à trois audiences : - **Décideurs / structures clientes** — sections 1, 4 (survol), 12, 13. - **Opérateurs & administrateurs** — sections 4, 5, 7, 12. - **Développeurs, architectes, auditeurs** — sections 2, 3, 6, 8, 9, 10, 11, 14. --- ## Table des matières 1. [Introduction & vision](#1-introduction--vision) 2. [Architecture technique](#2-architecture-technique) 3. [Modèle de données](#3-modèle-de-données) 4. [Catalogue des modules (37 Genesis + 1 Emissary)](#4-catalogue-des-modules-37-genesis--1-emissary) 5. [Navigation & shell applicatif](#5-navigation--shell-applicatif) 6. [Sécurité](#6-sécurité) 7. [Cycle de vie du contenu](#7-cycle-de-vie-du-contenu) 8. [Import / Export Engine](#8-import--export-engine) 9. [IA transverse](#9-ia-transverse) 10. [Performance & exploitation](#10-performance--exploitation) 11. [Historique de construction — Phases 0 → 49](#11-historique-de-construction--phases-0--49) 12. [Guides opérationnels](#12-guides-opérationnels) 13. [Glossaire](#13-glossaire) 14. [Annexes & sources](#14-annexes--sources) --- ## 1. Introduction & vision ### 1.1 Qu'est-ce qu'Hyper'Num ? Hyper'Num est un **logiciel SaaS autonome** de pilotage et de diffusion de contenu multi-canal, propriété de **Honorus Tech**. Il est distribué en **marque blanche** : chaque structure cliente peut le personnaliser (identité, palette, modules activés, quotas) sans modification du code. L'application est un **shell unique** : toutes les URL applicatives sont sous `/hypernum/...`. Les seules routes publiques hors application sont `/auth`, `/reset-password`, `/pending`, `/install`. Aucune couche concurrente n'existe — voir mémoire *Hyper'Num Isolation* (Phase 0). ### 1.2 Version courante — V1.4.19 « Studio » **Socle figé — V1.0.0 « Genesis »** (2026-06-27) - Statut : stable, figée. Aucune fonctionnalité nouvelle sur cette lignée sans nouvelle feuille de route. - Correctifs autorisés : lignée `1.0.x` (sécurité, bugs uniquement). - Certification : V1 certifiée en Phase 48 avec 0 réserve bloquante, 3 importantes, 5 mineures (voir mémoire *V1 Certification*). **Lignée V1.1 « Emissary »** (ouverte le 2026-07-15, stable) - **1.1.0 → 1.1.3** — MVP module **Pack de communication** : génération, clonage de ressources, duplication d'instance. - **1.1.4 → 1.1.7** — Éditeur WYSIWYG universel (Pro Controls, Live Canvas, Intelligence IA). - **1.1.8** — Clôture Lot 5, Phase 49 (suivi réserves V1). - **1.1.9 → 1.1.13** — Fortify & Polish : catalogue d'automatisations, MFA TOTP, monitoring OTLP, recherche accélérée, thèmes visuels. - **1.1.14 → 1.1.15** — Audit du découplage backend (~97 % d'abstraction). **Lignée V1.2 « Atelier »** - **1.2.0** — Presets d'apparence réutilisables. - **1.2.1** — Génération d'images IA via Lovable AI Gateway. - **1.2.2** — Édition multi-blocs simultanée. **Lignée V1.3 « Studio »** - **1.3.0** — Séparation des espaces « Créer » et « Outils ». - **1.3.1** — Pont Hyper'Connect (bidirectionnel avec référentiel partagé). - **1.3.2** — Sélecteur universel de partenaire et intégration dans les parcours de création. - **1.3.3** — Auto-création des entités parentes Hyper'Connect et messages utilisateur clarifiés. **Lignée V1.4 « Packs Partenaires »** - **1.4.0 → 1.4.3** — Mécanique modulaire, modèles, entrées/finitions, livraison (publication, duplication, export). - **1.4.4 → 1.4.7** — Contrôle qualité, journal de traçabilité, portail partenaire public `/pack/:token`, transmission par QR/e-mail. - **1.4.8 → 1.4.12** — Suivi de consultation, synthèse de pilotage, tri & filtres rapides, export portefeuille, fiche A4 imprimable. - **1.4.13 → 1.4.18** — Vue par partenaire, alertes d'échéance, réutilisation guidée, recherche transversale, réorganisation, renommage de dossier. - **1.4.19** — Navigation simplifiée : sidebar avec accès rapides, recherche d'outil, ouverture auto du pôle actif ; navigation mobile par pôles ; pied de page utile. Détail complet : `CHANGELOG.md`, `docs/hypernum/v1.1/README.md`, `docs/hypernum/v1.4/PACKS_PARTENAIRES.md`. Périmètre livré (Genesis + Emissary + Atelier + Studio + Packs Partenaires) : - **37 modules Genesis + modules 1.1 → 1.4** couvrant Pilotage, Contenus, Catalogue, Diffusion, Écosystème, Qualité, Administration, Packs Partenaires. - **~230 tables** sous le préfixe `hypernum_*`, RLS systématique, `workspace_id` propagé. - **6 rôles SaaS** (`super_admin`, `admin`, `editor`, `contributor`, `viewer`, `guest`). - **14+ contrats internes** garantissant le découplage entre modules. - **9 slots de connecteurs** prêts mais inactifs (out of scope V1). Hors-périmètre restant (documenté) : connecteurs externes actifs, marketplace publique d'extensions, API publique versionnée, bundles `.hnb` multi-packs, déclencheurs JsonLogic sur `pack.published`. ### 1.3 Modèle marque blanche L'identité par défaut du produit (Hyper'Num) et la structure propriétaire/éditrice (Honorus Tech) sont déclarées dans `src/config/branding.ts`. Chaque structure cliente peut surcharger l'apparence pour ses propres utilisateurs : nom produit, logo, favicon, palette, entité légale, texte de copyright. Le code couleurs de référence — hérité historiquement du projet d'origine « Opération Hypérion » — reste la valeur par défaut, mais il ne désigne pas la structure propriétaire de la plateforme : - Primary navy `#0B2545` - Accent orange `#F28C38` - Surface immersive navy `#0B1B2B` - Typographie : **Sora** (display), **Manrope** (body) > **Clarification identitaire** : Honorus Tech est seule propriétaire et éditrice du logiciel Hyper'Num. « Opération Hypérion » est un nom de code historique. Le domaine technique historique `hyperion-defense.fr` est en cours de migration vers `www.hypernum.fr` ; il ne représente aucune autre entité propriétaire. --- ## 2. Architecture technique ### 2.1 Stack | Couche | Technologie | |---|---| | Frontend | React 18, Vite 5, TypeScript 5 (strict), Tailwind CSS 3, shadcn/ui | | Data client | react-query v5, Zod (validation), react-hook-form | | Backend managé | **Lovable Cloud** (Supabase géré : PostgreSQL, Auth, Storage, Edge Functions, pg_cron) | | Edge Functions | Deno + imports `npm:` uniquement, auth via `auth.getClaims()` | | IA transverse | Lovable AI Gateway (Google Gemini + OpenAI, aucune clé côté client) | | Emails | Domaine dédié `notify.www.hyperion-defense.fr`, templates custom | Le projet est **strictement client-side + backend managé** : aucun serveur applicatif propre, aucun conteneur. La stack est verrouillée — pas de Next.js, pas de SSR, pas de framework alternatif. ### 2.2 Vue en couches ```text ┌──────────────────────────────────────────────────────────────────────┐ │ UI (React + shadcn) │ │ HyperNumLayout · Sidebar 7 pôles · ⌘K · Onboarding · Health Footer │ ├──────────────────────────────────────────────────────────────────────┤ │ Modules (37) │ │ Pilotage · Contenus · Catalogue · Diffusion · Écosystème · Qualité │ │ · Administration │ ├──────────────────────────────────────────────────────────────────────┤ │ Core Hyper'Num │ │ HyperNumProvider · WorkspaceProvider · UxProvider │ │ ConfigCenter · EventBus · Lifecycle · RuleEngine · Contracts │ │ Shortcuts · Inheritance · Version │ ├──────────────────────────────────────────────────────────────────────┤ │ Lovable Cloud (Postgres) │ │ ~230 tables hypernum_* · RLS + GRANTs · SECURITY DEFINER RPC │ │ pg_cron jobs · Edge Functions (audit-runner, dependency-scan, …) │ └──────────────────────────────────────────────────────────────────────┘ ``` ### 2.3 Arborescence `src/hypernum/` ```text src/hypernum/ ├── core/ # Providers, services transverses, contrats │ ├── HyperNumProvider.tsx │ ├── workspace/ # WorkspaceProvider, switcher, isolation │ ├── ux/ # ⌘K, favoris, récents, onboarding, shortcuts │ ├── services/ # configCenter, lifecycle, ruleEngine │ ├── events/ # eventBus (→ hypernum_analytics_events) │ ├── contracts/ # 14 contrats de découplage │ ├── inheritance/ # Résolution PMP marque → produit → service │ ├── publish/ # useContentLock, LockConflictDialog, workflow │ └── version.ts # Constantes de version officielles ├── modules/ # 37 modules (voir §4) │ └── / │ ├── HyperNum.tsx # entrée lazy │ ├── components/ │ ├── hooks/ │ └── lib/ ├── layout/ # HyperNumLayout, sidebar, topbar, footer ├── ui/ # Composants transverses (UnderlineAccent, HelpHint, …) └── routes/ # navigation.ts (registre 7 pôles), lazy routes ``` Chaque module suit la même convention et **ne dépend d'aucun autre module** ; seuls les contrats (`src/hypernum/core/contracts/`) sont partagés. ### 2.4 Conventions transverses - **Tables** : `hypernum__` — préfixe obligatoire (`NAMING_CONVENTIONS.md`). - **RPC** : `hypernum__` (ex. `hypernum_promote_sandbox`). - **Événements** : `hypernum..` (catalogue : `EVENT_CATALOG.md`). - **Routes** : `/hypernum/[/sous-route]`. - **Hooks** : `useHyperNum...` (transverses) ou `use