PROCÉDURE D'EXPLOITATION, SAUVEGARDE & CONTINUITÉ (PRA)
PROCÉDURE D'EXPLOITATION, SAUVEGARDE & CONTINUITÉ (PRA) — NEBULA
Référence documentaire : NEBULA-OPS-10
Version applicative couverte : Nebula 1.0 test
Dernière mise à jour : 15 novembre 2026
1. Objet du Manuel Opérationnel
Ce document décrit les procédures administratives d'installation, de paramétrage, d'exploitation courante, d'archivage/suppression des sessions et de reprise après incident pour l'application Nebula.
2. Prérequis et Configuration Initiale
2.1 Prérequis Environnement
- Système d'exploitation cible principal : Windows (avec support PowerShell intégré
OSC 633, icônesresources/win32/nebula.ico), architecture 64 bits. - Runtime Node.js / TypeScript & Electron : conformes aux dépendances définies dans
package.json(electron ^45.3.1,typescript ^5.9.3).
2.2 Variables d'Environnement (.env.example)
- Copier
.env.examplevers.env(fichier ignoré par Git via.gitignore). - Renseigner
OPENAIAPIKEYuniquement si l'exploitation utilise un fournisseur cloud compatible OpenAI. - Options d'environnement reconnues par le noyau (
src/main.ts) :
NEBULA_MODEL: modèle par défaut (repli :swe-1.6).NEBULA_SANDBOX: mode sandbox agent (offpar défaut ou mode configuré).
3. Commandes Officielles d'Exploitation (package.json)
| Commande | Action exécutée | Usage recommandé |
|---|---|---|
npm run build | Compile TypeScript (tsc) vers dist/ | Après toute mise à jour du noyau src/ |
npm start | Compile puis démarre Nebula (electron .) | Lancement normal de l'application bureautique |
npm run acp | Démarre node dist/acp-cli.js | Utilisation en serveur ACP JSON-RPC 2.0 headless / stdio |
npm run doctor | Exécute node dist/acp-cli.js --doctor | Diagnostic rapide de santé du noyau et des connecteurs |
4. Cycle de Vie des Données, Archivage & Continuité (PCA / PRA)
4.1 Archivage et Suppression des Conversations / Sessions
- Les sessions actives sont stockées localement sous
.devin/sessions/. - Depuis l'interface Nebula, l'administrateur ou l'utilisateur peut archiver une session (conservation hors vue active), la restaurer, ou la supprimer définitivement (purge disque via
session:delete/session:deleteArchived).
4.2 Sauvegardes & Restauration par Points de Contrôle (Checkpoints)
- Avant toute modification automatisée d'envergure, Nebula crée des instantanés locaux chiffrés (AES-256-GCM) dans
.devin/checkpoints/. - En cas d'erreur de génération ou d'incident de manipulation dans un projet, utiliser la fonction de restauration de checkpoint dans l'interface ou revenir via Git (
git checkout/git revert).
4.3 Procédure de Reprise après Incident Applicatif
- Vérifier la syntaxe et la compilation :
npm run build. - Exécuter le diagnostic noyau :
npm run doctor. - Vérifier l'intégrité des paramètres locaux (
.devin/config.json,hooks.v1.json,.env) et, si un modèle local GGUF/Ollama ne répond plus, redémarrerllama-server/ Ollama puis relancernpm start. - Avant toute diffusion ou validation critique, exécuter les suites de tests unitaires et de sécurité (
node --test ...) ainsi que/lifeguard.
Document rattaché au Portail Administratif Nebula (INDEXADMINISTRATIFNEBULA.html).