Aller au contenu

🏛️ Architecture Globale du Projet EGS & Instatic

Bienvenue dans la documentation d'architecture du projet Gallois Sisal (EGS) propulsé par la stack hybride Astro et le moteur Instatic.

🎯 Vue d'ensemble

Le projet est conçu selon une architecture ultra-performante et modulaire :

graph TD
    Client[Visiteur / Navigateur Web]
    Cloudflare[Cloudflare Edge / Pages & DNS]
    VPS[VPS Nginx 85.190.240.49]
    AstroApp[Astro SSR / Static Frontend]
    InstaticCore[Moteur Instatic - Bun Runtime]
    QuickJS[Workers Sandboxed QuickJS]
    DB[(SQLite / Postgres)]
    MCPClient[Client Externe Claude / Cursor]

    Client --> Cloudflare
    Cloudflare -->|Site Principal & Docs| AstroApp
    VPS -->|Page de Maintenance Prod| AstroApp
    MCPClient -->|Protocole MCP 2026-07-28| InstaticCore
    InstaticCore --> QuickJS
    InstaticCore --> DB
    InstaticCore -->|Publication Atomique| AstroApp

📑 Sommaire de la section

  1. Stack Globale — Décomposition des couches frontend, backend, runtime Bun, workers et base de données.
  2. Moteur Instatic Core — Modèle de données unifié (data_tables/data_rows), arbre de nœuds NodeTree, gestionnaire de store Zustand et isolation QuickJS.
  3. Frontend Astro & Design — Intégration Astro, optimisation des assets, design system Overused Grotesk et micro-interactions.
  4. Système de Publication Multi-Couches — Layer A (Static Bake symlink swap), Layer B (LRU Cache), Layer C (Dynamic Holes <instatic-hole>).