Mettre en service

L’installation répond. Voici ce qu’on fait avant d’ouvrir la porte, puis ce qu’on prend l’habitude de faire.

Avant d’ouvrir aux utilisateurs

1. La société

Paramètres → Société porte le nom légal, le pays, la devise et le fuseau horaire.

Ces deux derniers méritent une minute. Ils servent à convertir et à afficher, et les changer plus tard ne réécrit pas l’historique : une écriture comptable garde le taux figé à sa date. C’est voulu, et c’est ce qui rend vos comptes défendables.

Une devise vide donne des prix vides

Si la société n’a pas de devise, les montants s’affichent sans valeur au lieu de lever une erreur. Le symptôme classique est « le prix ne se remplit pas ». Vérifiez ce réglage en premier.

2. Les modules

Paramètres → Modules liste ce qui est disponible. Activez ce dont vous avez besoin, et rien de plus : un module désactivé n’encombre ni les menus ni la formation de vos équipes.

Un module se désactive aussi. Ses données restent en place, seuls les écrans disparaissent.

3. Les utilisateurs et leurs droits

Créez les comptes, puis donnez à chacun ses groupes. Un groupe est un ensemble de droits ; c’est lui qui décide de ce qu’un utilisateur voit et peut modifier.

Prenez le temps sur ce point. Il est beaucoup plus facile d’ouvrir un droit que de rattraper une donnée qu’une personne n’aurait pas dû voir.

4. Le courrier sortant

Paramètres → Courrier porte votre serveur d’envoi. Testez l’envoi avant d’ouvrir : un utilisateur qui ne reçoit pas son mot de passe initial ouvre un ticket le premier jour.

5. La sauvegarde

Mettez-la en place avant la première donnée réelle, pas après.

Une sauvegarde est une commande, et une seule :

kewos backup create \
  --database-url "$KEWOS_DATABASE_URL" \
  --tenant acme \
  --output /backups/acme/$(date -u +%Y-%m-%dT%H%M%SZ).tar.gz

Elle produit une archive qui contient un pg_dump de votre base et un manifeste qui dit de quel client elle vient, quand elle a été prise, et avec quelle version des outils. Les outils clients PostgreSQL (pg_dump, pg_restore, paquet postgresql-client) doivent être installés sur la machine ; sinon la commande vous le dit, avec le nom du paquet.

En cron, une fois par nuit :

/etc/cron.d/kewos-backup

0 2 * * * kewos kewos backup create --database-url "postgresql+psycopg://kewos@127.0.0.1:5432/kewos_acme" --tenant acme --output /backups/acme/$(date -u +\%Y-\%m-\%dT\%H\%M\%SZ).tar.gz

Ne mettez pas le mot de passe dans la ligne de commande : ps est lisible par tous les comptes de la machine. Utilisez ~/.pgpass en mode 0600, ou l’authentification par socket local.

Pour savoir ce que contient une archive, sans rien restaurer :

kewos backup show --input /backups/acme/2026-09-06T020000Z.tar.gz
# tenant_slug: acme
# dialect: postgresql
# created_at: 2026-09-06T02:00:03.114882+00:00

6. La restauration, essayée une fois pour de vrai

On restaure à côté, jamais par-dessus. La commande refuse d’ailleurs une base qui contient déjà des tables.

createdb -O kewos kewos_acme_restore

kewos backup restore \
  --input /backups/acme/2026-09-06T020000Z.tar.gz \
  --database-url "postgresql+psycopg://kewos@127.0.0.1:5432/kewos_acme_restore" \
  --confirm

Vérifiez sur la base restaurée, puis basculez en renommant les deux bases, service arrêté. La base d’origine est renommée, pas supprimée : c’est la seule copie de ce qui s’est passé.

La procédure complète, avec les scénarios de sinistre, est dans le runbook docs/runbook-backup-dr.md livré avec le produit.

Une sauvegarde sans sa clé n’est pas une sauvegarde

Les données confidentielles sont chiffrées par la clé de votre installation. Une base restaurée sans cette clé rend ces données illisibles.

Conservez la clé ailleurs que sur le serveur sauvegardé, et faites l’essai de restauration au moins une fois, avant d’en avoir besoin. Une sauvegarde jamais restaurée est une hypothèse.

Ce que l’archive ne contient pas

Elle contient la base. Elle ne contient ni vos pièces jointes (KEWOS_STORAGE_ROOT, à sauvegarder séparément), ni la base master si votre installation en a une. Et une restauration ramène l’état de la nuit, pas de la minute : il n’y a pas de retour à un instant précis aujourd’hui.

Les habitudes à prendre

Après chaque mise à jour

Une nouvelle version peut apporter des changements de structure. La procédure de mise à jour fournie avec le paquet les applique ; elle n’efface jamais rien.

Vérifiez ensuite que l’installation se déclare saine :

curl https://erp.example.com/health/live

Surveillez trois choses

Quoi	Pourquoi
L’échéance de votre licence	Vous serez prévenu par un bandeau, mais un renouvellement se prépare.
L’espace disque	Les pièces jointes et les sauvegardes grossissent sans prévenir.
Vos sauvegardes	Non pas qu’elles tournent : qu’elles se restaurent.

Ce qui va poser question en premier

Par ordre de fréquence observée.

Une liste vide alors que les données existent. Presque toujours une question de droits : le compte ne voit pas ces lignes, ou pas cette société. Les permissions s’appliquent sous l’interface, donc une liste vide est une réponse correcte, pas une panne.

Un courriel qui ne part pas. Les envois sont mis en file d’attente, jamais expédiés depuis l’écran. Si le service de traitement des tâches ne tourne pas, le message attend sans erreur visible.

Un utilisateur qui ne voit pas un module activé. Il lui manque le groupe correspondant.

Un montant affiché sans devise. Voir le réglage de société, plus haut.

Besoin d’aide

Écrivez à support@kewos.io en indiquant votre numéro de version et, si le service ne démarre pas, les dernières lignes de son journal.