Guide Caisse & StockLa Clave Latinos Club

Sauvegardes des données

Les ventes, la compta, les employés, le journal et le stock sont dans deux bases de données en ligne. Voici ce qui est sauvegardé, quand, où, et comment on restaure.

Ce qu’il faut protéger

Les applications elles-mêmes (le programme) sont sur GitHub et se remettent en ligne en quelques minutes. Ce qui est précieux, ce sont les données, dans deux bases Cloudflare D1 :

| Base | Contenu | |---|---| | Caisse (caisselatino) | Soirées, commandes, factures, comptages, employés (codes chiffrés), paramètres, catalogue, journal | | Stock (caisselatino-stock) | Ingrédients, recettes, mouvements, inventaires, comptes du stock, journal du stock |

Les deux protections

1. Le retour dans le temps de Cloudflare (Time Travel)

Cloudflare garde automatiquement l’historique de chaque base pendant quelques jours (7 ou 30 jours selon l’offre du compte). On peut remettre une base telle qu’elle était à une minute précise.

  • Avantage : rien à faire, ça marche tout le temps.
  • Danger : cela remet toute la base à cet instant. Tout ce qui a été fait après est perdu : ventes, comptages, réglages.
  • C’est un dernier recours, à ne lancer qu’après un export (ci-dessous), jamais pendant une soirée.

2. Les exports réguliers (la vraie sauvegarde)

Un export est un fichier qui contient toute la base à un instant donné. On le garde aussi longtemps qu’on veut, hors de Cloudflare. Commandes (pour le développeur) :

# depuis le dossier de la caisse
npx wrangler d1 export caisselatino --remote --output sauvegarde-caisse-AAAA-MM-JJ.sql
# depuis le dossier du stock
npx wrangler d1 export caisselatino-stock --remote --output sauvegarde-stock-AAAA-MM-JJ.sql

Quand sauvegarder

  • Avant chaque mise à jour qui touche la base (une « migration ») : obligatoire.
  • Avant toute opération risquée : suppression de nombreuses commandes, gros changement de la carte, restauration.
  • Chaque semaine au minimum, un après-midi.
  • Avant l’ouverture du club, la première fois.

Où ranger les sauvegardes

  • Au moins une copie hors du serveur du développeur : un espace de stockage en ligne protégé, ou une clé USB dans le coffre.
  • Les fichiers contiennent des données sensibles (codes chiffrés, journal avec noms et adresses IP) : accès limité au patron et au développeur, idéalement chiffrés.
  • Nommez-les avec la date, et gardez la caisse et le stock du même jour ensemble.

Combien de temps garder

En Belgique, les documents comptables se gardent en général 7 à 10 ans : à confirmer avec le comptable. Gardez au moins :

  • les exports CSV mensuels des rapports et des factures (Compta, Factures) ;
  • une sauvegarde complète par mois des deux bases.

Les exports CSV sont des archives pour le comptable, pas une sauvegarde : ils ne permettent pas de remettre les applications en route.

Restaurer

C’est un travail du développeur, à faire en dehors des soirées :

  1. Faire un export de l’état actuel, même s’il est abîmé : on ne sait jamais.
  2. Choisir le moment à retrouver : un fichier de sauvegarde, ou une minute précise du retour dans le temps.
  3. Restaurer la caisse et le stock sur le même moment.
  4. Vérifier : la dernière soirée, les totaux, quelques commandes, le stock d’un ingrédient.
  5. Prévenir l’équipe de ce qui a pu être perdu (les ventes faites après le moment restauré doivent être ressaisies).

Où on en est aujourd’hui

  • Les sauvegardes sont faites à la main par le développeur, avant chaque mise à jour de la base.
  • Une sauvegarde automatique chaque semaine, avec une copie hors du serveur, reste à mettre en place avant l’ouverture.
  • Le patron doit savoir qui fait la sauvegarde et où elle est rangée : notez-le dans la fiche incident.