Exploitation
Déploiement (MacLustr)
Application sp-browser-backend gérée par mld (manifeste M1M32:~/dispatch/apps/sp-browser-backend.json), processus PM2 sp-browser-backend (node src/server.ts, port 8710) et sp-browser-backup (cron quotidien). Domaine browser.spboucher.ai → passerelle BHS64 (route Caddy posée par mld deploy).
Le dossier déployé est le dépôt (origin = spbgit sp-browser-backend.git) : modifier sur le nœud, pm2 restart sp-browser-backend, puis git commit && git push sur le nœud.
Secrets : ~/apps/sp-browser-backend/.env (600), exclu de git et du rsync. Données : ~/apps-data/sp-browser-backend/sp-browser.sqlite (+ -wal, -shm).
Configuration
Voir .env.example. Points d'attention :
RP_ID/PUBLIC_ORIGIN: les clés d'accès sont liées à ce domaine — le changer invalide toutes les clés d'accès.APPLE_APP_IDS: identifiants<équipe>.<bundle>servis dans/.well-known/apple-app-site-association(Apple met ce fichier en cache, jusqu'à 24 h).DAILY_CREDIT_BUDGET: plafond de crédits Tavily par jour UTC.
Migrations
src/db.ts : liste MIGRATIONS, ajout en fin de liste uniquement ; version suivie par PRAGMA user_version, chaque migration dans une transaction, appliquée au démarrage. GET /api/health renvoie schema.
Sauvegarde
scripts/backup.sh : copie cohérente à chaud (VACUUM INTO), contrôle d'intégrité, gzip, rétention 30 jours dans ~/backups/sp-browser-backend/. La base contient des clés publiques, des hachages de jetons et du texte chiffré de bout en bout : une sauvegarde seule ne révèle pas la navigation.
Restauration
pm2 stop sp-browser-backend
cd ~/apps-data/sp-browser-backend && mv sp-browser.sqlite sp-browser.sqlite.bad; rm -f sp-browser.sqlite-wal sp-browser.sqlite-shm
gunzip -c ~/backups/sp-browser-backend/sp-browser-<date>.sqlite.gz > sp-browser.sqlite && chmod 600 sp-browser.sqlite
sqlite3 sp-browser.sqlite 'PRAGMA integrity_check'
pm2 start sp-browser-backend && curl -s localhost:8710/api/healthAprès restauration, les appareils dont le numéro de séquence dépasse celui de la sauvegarde renvoient leurs changements manquants au prochain cycle (l'app repousse tout enregistrement local que le serveur ne connaît plus).
Reprise après perte
- Nœud perdu :
mld deploy sp-browser-backend --node X, recopier.env(copie :~/Desktop/Cluster/secrets/sp-browser-backend/sur le laptop) et la dernière sauvegarde. - Clé Tavily compromise : la régénérer chez Tavily, remplacer
TAVILY_API_KEY,pm2 restart. Les apps n'ont jamais la clé. - Utilisateur sans clé d'accès : il utilise sa clé de récupération dans l'app. Sans elle, personne (pas même l'administrateur) ne peut rouvrir ses données ; on peut seulement supprimer le compte.
- Invitation :
node scripts/invite.ts create "pour qui".
Surveillance
/admin (ou GET /api/admin/overview, Authorization: Bearer $ADMIN_TOKEN) : santé, crédits du jour / plafond, usage 30 jours et coût estimé (0,008 $ US par crédit, tarif à l'usage), compte Tavily (/usage), comptes/appareils/sessions, enregistrements chiffrés par collection, appareils en attente de clé, erreurs 24 h, journal opérationnel.