Guide DC — FRACTILIS

🏗 Architecture de la Plateforme

FRACTILIS est une Single Page Application multi-fichiers en HTML/CSS/JS vanilla (sans framework). Chaque page est autonome mais partage des fichiers communs. Le backend est entièrement Firebase — pas de serveur dédié.

Accès Hub Architecte

Ordre de chargement des scripts (critique)

1. fractilis-firebase.js   ← TOUJOURS en premier (expose window.db / window.auth)
2. fractilis-bg.js         ← dépend de window.db pour Firestore (slideshow + CSS)
3. fractilis-nav.js        ← dépend de window.auth (menu, Oracle, état connexion)
4. fractilis-mailer.js     ← uniquement sur architecte.html
5. NexusRouter.js          ← en dernier (vérifie auth + rang avant affichage)

📁 Fichiers & Dépendances

Fichiers système (tous présents dans public/)

Bibliothèques CDN (aucune installation)

🔥 Firebase & Firestore

Collections Firestore — carte complète

Accéder à Firestore directement

Variables d'environnement importantes

// Dans config.js (public, normal)
const firebaseConfig = { apiKey: "...", projectId: "fractilis", ... };

// Dans Firestore config_dc/secrets (privé)
{ groq_key: "gsk_...", openai_key: "sk-...", admin_pwd_hash: "sha256..." }

// Dans fractilis-bg.js
window.CLOUDINARY_CLOUD_NAME    = 'davzicbph';
window.CLOUDINARY_UPLOAD_PRESET = 'fractilis_gallery';

// Code DC (à changer tous les 3 mois)
FozaStudio2026

🚀 Déploiement

Déploiement standard

# Depuis la racine du projet (PowerShell)
cd C:\...\FRACTILIS_Final

# Hosting uniquement (le plus courant)
firebase deploy --only hosting

# Hosting + règles Firestore
firebase deploy --only hosting,firestore:rules

# Tout (hosting + firestore rules + indexes)
firebase deploy

Forcer la mise à jour du Service Worker

// Dans sw.js, incrémenter le numéro de version
const CACHE_NAME = 'fractilis-v6'; // était v5 → maintenant v6
// Les visiteurs reçoivent le nouveau SW à leur prochain chargement

Rollback d'urgence

# Voir les déploiements précédents
firebase hosting:releases:list --limit 10

# Revenir à la version précédente
firebase hosting:rollback

👥 Membres & Rangs

Hiérarchie complète des rôles

Promouvoir un membre

Bannir un membre

// Firestore → users/{uid}
{ "role": "banni", "banned": true, "ban_reason": "...", "ban_date": "2026-05-01" }
// ET Firebase Console → Authentication → Désactiver le compte

★ Économie & Points Mérite (PM)

Sources de PM

Multiplicateurs économiques

// fractilis_meta/economy
{
  "global_rate": 1.0,        // Taux de base
  "global_multiplier": 1.5,  // Événement actif (×1.5 PM) → modifier ici pour un event
  "total_pm_distribues": 4280
}

Progression automatique → rangs

La fonction getRang() dans config.js calcule le rang à partir de points_merite. Les accès se débloquent automatiquement. Seuils approximatifs :

RevShare — Opération irréversible

⚔ Gestion des Quêtes

Cycle de vie

Créer une quête manuellement

Niveaux et calibration

🗳 Votes & Gouvernance

Types de vote

Gérer un véto

Un véto membre gèle le vote 48h. Hub Architecte → Votes → Vétos actifs. Tu peux lever un véto si la décision est urgente (bouton "Lever le veto") ou si le véto n'est pas fondé. Documenter la décision dans le devlog.

💡 Résonateur & Creuset

Pipeline complet

Actions DC sur le Résonateur

Hub Architecte → Résonateur → idées en attente :

• Valider : statut = "validee", notification + PM bonus à l'auteur auto
• Refuser : statut = "refusee" avec motif envoyé
• Escalader : statut = "escalade" → apparaît dans Votes → Escalades
• Forger : convertir directement en quête ou entrée Forge

Réinitialiser les votes d'une idée

// Si les votes ne se comptent pas :
// 1. Vérifier collection votes/{ideaId}_{userId} dans Firestore
// 2. Vérifier règle Firestore sur collection "votes"
// 3. En local : localStorage.removeItem('res_votes') pour réinitialiser

📋 Candidatures

Toutes les candidatures arrivent dans Firestore fractilis_candidatures ET dans le Google Sheet via Apps Script.

Workflow de traitement

Google Apps Script

// Google Sheets → Extensions → Apps Script → FRACTILIS_AppsScript.js
// Remplir SHEET_URL et DC_WA_NUMBER en tête de fichier
// Déployer → App Web → "Tout le monde (anonyme)"
// Copier l'URL dans script_onboarding.js (variable APPS_URL)
// Déclencheur : sendWeeklyDigest → Lundi → 8h–9h
// Tester : exécuter testEmails() depuis Apps Script

🔥 La Forge (Worldbuilder OS)

La Forge (FORGE.html, 4600+ lignes) est l'éditeur worldbuilding central. Elle contient : Carte Nexus · Assistant IA Oracle · Arbre dynastique · Graphe de relations · Chronologie · Kanban · Générateurs · Export Godot · Viewer 3D · Panel Équipe.

Modules de La Forge

Lore L2 (secret)

Activer L2 : cliquer badge "L2" en haut de la Forge → entrer FozaStudio2026 → les sections D8/D13/D14/D15 deviennent visibles.

Corpus / Documents

Niveaux d'accès documents : public · l1 · l2 · arch_only. Pour ajouter un document long : stocker dans Google Drive → coller le lien dans la Forge. Champ niveau_acces dans Firestore.

🗺 Carte Nexus

Carte interactive Leaflet.js. Chaque calque (Districts, Fractures, Biomes…) est toggleable indépendamment.

Usage

• Outil actif = bouton mis en surbrillance dans la toolbar gauche
• Une forme dessinée → onglet "Liste" → éditable via onglet "Propriétés"
• Sauvegarde dans fnx/map_data (Firestore) ET fnx_map (localStorage)
• Export GeoJSON = format standard, importable dans QGIS, Azgaar, Godot

Si la carte ne s'affiche pas

// Console : typeof L doit renvoyer "object" (Leaflet chargé)
// #body-map doit avoir une hauteur CSS définie
// Appeler _map.invalidateSize() après un changement de layout
// Leaflet.draw requiert Leaflet chargé EN PREMIER (ordre scripts)

🎓 Academy

Classes de contenu

Membre reconnu "Initié" malgré son rang

L'Academy lit data.role uniquement. Si le doc Firestore contient grade ou rang_studio au lieu de role, le membre sera Classe 1. Fix : s'assurer que le champ est role (pas grade ni rang).

Tests de vérification

Hub Architecte → Vérification → deux modes :

• ⚡ IA : génère auto un test via Groq selon le rôle
• ✏ Manuel : composer les questions (Texte / QCM / Vrai-Faux). Le candidat reçoit un lien unique vers candidate_interview.html?id=XXX

🖼 Galerie & Médias

Pipeline upload d'image

Cloudinary — config

Cloud name : davzicbph
Upload preset : fractilis_gallery (unsigned — pas de signature requise)
Dossier upload : gallery/
Console : cloudinary.com/console → Settings → Upload → Upload presets

Limite Firestore (stockage base64)

Sans Cloudinary : images compressées max 800×600px/80% JPEG avant stockage. Limite : 1MB par document Firestore. Au-delà de ~15 images en base64, migrer vers Cloudinary obligatoire.

💎 Boutique

Initialiser les 28 articles

Hub Architecte → Boutique → bouton "Initialiser les 28 articles". Une seule fois (ou si la boutique est vide).

Catégories et articles par défaut

Gestion du stock

stock = null → illimité. stock = 0 → épuisé. stock = n → décrémenté automatiquement à chaque achat.

⚙ Arsenal IA

Bibliothèque de prompts par catégorie pour les outils IA utilisés en production. Accessible aux Concepteurs+ via La Forge ou l'outil dédié.

Outils principaux

Si la clé Groq est expirée

// 1. console.groq.com → générer une nouvelle clé
// 2. Firestore → config_dc/secrets → groq_key = "gsk_nouvelle_cle"
// 3. Tester : ouvrir Oracle dans La Forge → poser une question
// Si toujours muet : vérifier aussi FRACTILIS_AppsScript.js → variable GROQ_KEY

🎮 Export Godot 4

Seuls les articles avec statut: 'canon' sont inclus dans l'export.

// JSON généré : data_export.json → placer dans res://data/ de Godot
// DataHandler.gd charge via ResourceLoader.load("res://data/data_export.json")

// API Godot :
DataHandler.get_entity("uuid")
DataHandler.get_by_type("arme")

// Structure JSON exportée :
{
  "id": "uuid",
  "nom": "Eran Kalen",
  "type": "personnage",
  "l1": "Texte public (Layer 1)",
  "l2": "Révélation secrète (Layer 2 — non exporté en production)",
  "stats": { ... }
}

✅ Checklist Mensuelle DC

Modifier la progression globale

// Firestore : fractilis_meta/progression
{
  "global": 18,   // % affiché sur l'index et dans les stats live
  "lore": 35,     // % pôle Narration
  "tech": 12,     // % pôle Technique
  "visuel": 22,   // % pôle Visuel
  "audio": 5,     // % pôle Audio
  "studio": 10    // % organisation studio
}
// Alternative : triple-clic sur ◈ en footer de progression.html → FozaStudio2026

🔧 Dépannage Complet

Activer le mode debug

// Sur n'importe quelle page : Ctrl + Shift + D
// → Panneau debug (coin bas gauche) avec état Firebase, auth, heure

// Depuis la console navigateur :
console.log('DB:', !!window.db, 'Auth:', !!window.auth, 'Ready:', window.FIREBASE_READY)
window.fracBgReload()   // Forcer rechargement slideshow fond
loadArticles && loadArticles()  // Forcer rechargement boutique

🛡 Sécurité

Rotation des mots de passe — tous les 3 mois

Le code DC FozaStudio2026 est hardcodé dans plusieurs fichiers. Pour le changer :

// Fichiers à modifier :
architecte.html     → variable ADMIN_PWD
progression.html    → triple-clic ◈ footer
Hall of Fame.html   → triple-clic ◈ footer
FORGE.html          → variable L2_PASSWORD (code L2 distinct)
guide_dc.html       → (ce document — section sécurité)

// Notifier les Concepteurs du nouveau code L2.

CSP — Content Security Policy

Définie dans firebase.json → headers. Si une ressource externe est bloquée :

// Ajouter dans la directive appropriée de firebase.json
"script-src": "... https://nouveau-domaine.com"
"connect-src": "... https://api.nouveau-service.com"
// Puis : firebase deploy --only hosting

Règles Firestore recommandées

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    function isArchitecte() {
      return request.auth != null && (
        get(/databases/$(database)/documents/users/$(request.auth.uid)).data.role == 'architecte'
        || get(/databases/$(database)/documents/users/$(request.auth.uid)).data.role == 'admin'
      );
    }
    function level() {
      return get(/databases/$(database)/documents/users/$(request.auth.uid)).data.niveau || 0;
    }
    // Forge — lecture membres, écriture concepteurs+
    match /fnx/{doc} {
      allow read: if request.auth != null;
      allow write: if request.auth != null && level() >= 4;
    }
    // Lore — lecture publique, canonisation DC
    match /fractilis_lore/{id} {
      allow read: if true;
      allow create: if request.auth != null;
      allow update: if isArchitecte();
    }
    // Users — chacun lit/modifie le sien, DC modifie tous
    match /users/{uid} {
      allow read: if request.auth != null;
      allow write: if request.auth.uid == uid || isArchitecte();
    }
  }
}

Sauvegardes

// Export manuel depuis Hub Architecte → Export → JSON/Markdown/HTML
// Ou Firebase Console → Firestore → Exporter (plan Blaze requis pour export auto)
// Fréquence recommandée : mensuelle minimum

🚨 Gestion de Crise

🔗 Liens Admin Essentiels

📖 Glossaire FRACTILIS

📝 Changelog Plateforme

v4.0 — Mai 2026

• Guide DC fusionné : v3.0 original + nouvelle documentation technique complète
• fractilis-bg.js : slideshow fond d'écran plein écran toutes pages, CSS transparence globale, mobile responsive, warning portrait non-bloquant
• boutique.html : tooltips au survol, catégories Identité/Pouvoir ajoutées, fix syntaxe apostrophes
• architecte.html : boutique tri client-side (28 articles), votes sans orderBy, formation manuelle, test DC
• academy-engine.js : resolveClass lit data.role → fin du bug "Initié" pour l'Architecte
• FORGE.html : accès architecte débloqué, Oracle button visible, timeline hauteur fixée
• fractilis-nav.js : menu WA collapsible, pages triées par rang, codex économique retiré
• sw.js : bypass Cloudinary + CDN images (fin des images noires)

v3.0 — Avril–Mai 2026

• Carte Nexus v2 : Leaflet.draw, calques FRACTILIS, export GeoJSON
• Viewer 3D (.glb/.gltf via Three.js + model-viewer)
• Panel Équipe temps réel (Firestore onSnapshot)
• Assistant IA Oracle flottant global
• Creuset double vue + statistiques de flux
• Vote pondéré ×1–×5 selon rôle
• Notifications canonisation (+50 mérites)

v2.0 — Mars 2026

• Résonateur v2 · Carte Nexus v1 · Export Godot 4 · Arbre dynastique vis.js · Graphe de relations

v1.0 — Janvier 2026

• Forge initiale · Firebase Auth · Kanban · Générateurs · Hall of Fame