SPB Git

Repository Public

OPERATIONS.md 3.2 KB

# 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

bash
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/health

Aprè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.

Files main
Menu

Theme