# ComptaPro — Guide client : installation, prise en main et sauvegardes Du fichier d'installation reçu de l'éditeur jusqu'aux sauvegardes hebdomadaires, en passant par le premier démarrage, l'essai de 30 jours et l'activation de la clé. > **Public** : vous, le client (dirigeant ou comptable qui installe et gère > ComptaPro). > **Companion** : `installateur/Lisez-moi.txt` (mémo remis à l'installation) et > `installateur/deploiement/README-deploiement.md` (installation silencieuse > sur plusieurs postes, pour votre informaticien). > Les commandes des §5 (sauvegarde, vérification, restauration) ont été > exécutées et vérifiées ; les étapes d'interface décrites en §1 à §4 > correspondent à l'installateur et aux écrans du logiciel. > > **Autres langues** : [English](GUIDE-CLIENT.en.md) · [Español](GUIDE-CLIENT.es.md) --- ## 1. Installation ### 1.1 Ce qu'il faut avant de commencer | Besoin | Détail | |---|---| | Système | Windows 10 ou ultérieur, architecture 64 bits | | Droits | Aucun administrateur requis : l'installation est **par utilisateur** | | Réseau | Aucune connexion Internet nécessaire pour utiliser le logiciel | | Fichier | `ComptaPro-Setup-.exe` reçu de l'éditeur (si une empreinte SHA-256 est publiée à côté du lien, vérifiez-la avant d'exécuter) | ### 1.2 Exécuter l'installateur 1. Double-cliquez sur `ComptaPro-Setup-.exe`. 2. Laissez le dossier d'installation proposé : `%LOCALAPPDATA%\Programs\ComptaPro` — le logiciel et vos données restent côte à côte, inscriptibles, sans droits administrateur. 3. Les cases proposées : | Option | Par défaut | Effet | |---|---|---| | Créer un raccourci sur le Bureau | cochée | raccourci « ComptaPro » pour lancer le logiciel | | Démarrer ComptaPro automatiquement avec Windows | décochée | le serveur démarre au login, fenêtre en arrière-plan | | Créer la tâche de secours qui importe les relevés déposés pendant l'absence du logiciel (toutes les 15 minutes) | décochée (optionnel) | cochez-la si vous déposez des relevés bancaires alors que ComptaPro est fermé : la tâche le relance en arrière-plan pour les importer | 4. À la fin, laissez « Lancer ComptaPro maintenant » coché. ### 1.3 Où vivent vos données Tout est local, dans le dossier d'installation : | Dossier | Contenu | |---|---| | `compta\data\` | base de données, photos des factures, sessions | | `compta\sauvegardes\` | archives de sauvegarde (voir §5) | | `compta\planifier\` | scripts des tâches planifiées (sauvegarde, secours des relevés) | Aucune donnée n'est envoyée sur Internet (voir aussi §4 : l'activation est elle-même vérifiée localement). ### 1.4 Mettre à jour Il suffit de lancer le nouveau `ComptaPro-Setup-.exe` : le serveur est arrêté automatiquement, les fichiers sont remplacés, vos données sont conservées. Les tâches planifiées existantes (sauvegarde, secours des relevés) sont conservées — le dossier d'installation ne changeant pas, leurs chemins demeurent valides. Le script de la tâche de secours n'est régénéré que si l'option « secours » est à nouveau cochée (ou passée via `/TASKS=secours`) au moment de la mise à jour. ### 1.5 Désinstaller Panneau de configuration → Applications → ComptaPro → Désinstaller. Le programme vous demandera si vous souhaitez aussi supprimer vos données comptables (irréversible) ou les conserver. Par défaut, les données et les archives de sauvegarde sont conservées. --- ## 2. Premier démarrage ### 2.1 La fenêtre noire, c'est le logiciel - Double-cliquez sur le raccourci « ComptaPro » (Bureau ou menu Démarrer). - **Laissez la fenêtre noire ouverte** : c'est le serveur du logiciel. **NE FERMEZ PAS cette fenêtre**, sinon le logiciel s'arrête — le cas le plus fréquent de « ComptaPro ne répond plus ». En cas d'accident, relancez le raccourci : c'est tout. - La fenêtre affiche trois adresses : - `http://localhost:8090/` — le logiciel sur **ce** poste (le navigateur s'ouvre automatiquement) ; - `http://localhost:8090/punch` — la page de pointage ; - l'adresse du **réseau local** : c'est elle, et non localhost, que les téléphones des employés utilisent pour pointer. ### 2.2 Première connexion | Champ | Valeur initiale | |---|---| | Identifiant | `admin` | | Mot de passe | `admin1234` | → **Changez le mot de passe immédiatement** : Paramètres → Comptes. ### 2.3 Données de démonstration À la toute première ouverture, le logiciel remplit un jeu de données de démonstration (factures, dépenses, employés, pointages) pour que chaque écran soit parlant. Vous travaillez ensuite sur vos propres données ; en cas de doute sur l'origine d'une pièce, vérifiez sa date. ### 2.4 Pointage des employés - Page dédiée : `http://:8090/punch` (ouvre avec le raccourci « Pointage employés » du menu Démarrer). - Les téléphones pointent via l'adresse réseau affichée par la fenêtre noire — jamais via `localhost`, qui désigne chaque téléphone lui-même. --- ## 3. Essai de 30 jours - **Le compte à rebours démarre à la première ouverture** du logiciel : aucune démarche, aucune carte bancaire, **toutes les fonctions** pendant 30 jours pleins, sur vos vraies données. - La durée est mesurée depuis la première ouverture : reculer l'horloge de la machine ne prolonge pas l'essai. - Rappels : un bandeau s'affiche pendant les **10 derniers jours** d'essai (il passe au rouge en dessous de **3 jours**) et mène directement à l'écran Licence. - Passé les 30 jours, sans clé, le logiciel est bloqué : seules la connexion, l'écran Licence et le pointage restent accessibles. Vos données restent sur la machine. - **Il n'existe pas de commande « prolonger l'essai »** : pour plus de temps, demandez une clé à l'éditeur via le formulaire du site (une clé à durée limitée fait office d'essai prolongé — voir §4). --- ## 4. Activation et renouvellement 1. Menu → **Licence**. 2. Saisissez la clé fournie par l'éditeur — elle commence par **`CMPR2.`** — puis validez. 3. L'écran affiche l'état de votre licence : type et, pour une clé à durée limitée, sa **date de fin de validité**. Faits à retenir : - **La vérification est 100 % locale** : la clé est une signature numérique (Ed25519) contrôlée sur votre machine ; rien n'est envoyé sur Internet, ni clé ni données (affirmation de la page de vente et de l'écran Licence). - **Deux types de clés** : | Type | Validité | |---|---| | Perpétuelle | sans limite de temps | | À durée limitée | 1 an ; passé cette date affichée dans l'écran Licence, le logiciel est bloqué | - **Renouvellement** : l'éditeur vous remet une clé de renouvellement à saisir au même endroit (écran Licence). - **La clé est un titre au porteur** : qui la possède peut l'activer. Conservez-la hors de l'ordinateur (copie papier ou courriel) — elle vous servira en cas de réinstallation ; ne la communiquez pas. --- ## 5. Sauvegardes et restauration ### 5.1 Ce que contient une archive Chaque sauvegarde regroupe **la base de données, les photos des factures et les sessions**, dans un fichier daté : ``` sauvegarde-AAAA-MM-JJ_HH-MM-SS.zip.chiffre (chiffré — par défaut) sauvegarde-AAAA-MM-JJ_HH-MM-SS.zip (non chiffré, avec --sans-chiffrement) ``` - Dossier par défaut : `compta\sauvegardes\`. - **Le mot de passe est indispensable** : sans lui, une archive chiffrée est définitivement inutilisable. Il est donné à la planification via `--mot-de-passe` et stocké dans `compta\planifier\mot-de-passe-sauvegarde.txt` — **conservez-le aussi ailleurs** que sur ce poste. - Les archives ne protègent que si elles quittent la machine : copiez régulièrement `compta\sauvegardes\` sur un disque externe ou un réseau. Ouvrez une fenêtre de commande **dans le dossier d'installation** (`%LOCALAPPDATA%\Programs\ComptaPro`). Si votre PATH ne connaît pas `node`, utilisez le Node fourni avec le logiciel (`.runtime\node\node.exe`), comme ci-dessous. ### 5.2 Sauvegarde manuelle ``` .runtime\node\node.exe compta\scripts\sauvegarde.js ``` - Peut s'exécuter **pendant que le logiciel tourne** (instantané `VACUUM INTO`, rien à arrêter). - Conserve les **5 dernières** archives par défaut : `--conserver N` pour changer, `--tout-conserver` pour ne rien supprimer. - Le mot de passe est pris (dans cet ordre) à `--mot-de-passe`, à la variable `SAUVEGARDE_MOT_DE_PASSE`, puis au fichier `compta\planifier\mot-de-passe-sauvegarde.txt`. ### 5.3 Sauvegarde hebdomadaire planifiée ``` .runtime\node\node.exe compta\scripts\planifier-sauvegarde.js -aide ``` Puis installez-la (défauts : **chaque lundi à 02:00**, 5 archives conservées) : ``` .runtime\node\node.exe compta\scripts\planifier-sauvegarde.js --mot-de-passe ``` - La tâche apparaît dans le Planificateur de tâches Windows sous « ComptaPro - Sauvegarde hebdomadaire » ; le script généré est dans `compta\planifier\`, le journal dans `compta\sauvegardes\`. - Comme toute tâche de l'utilisateur, elle s'exécute seulement si l'ordinateur est allumé et l'utilisateur connecté à l'horaire prévu. - `--jour` / `--heure` / `--conserver` règlent la planification ; `--afficher` l'état ; `--desinstaller` la retire. ### 5.4 Vérifier l'intégrité des archives ``` .runtime\node\node.exe compta\scripts\sauvegarde.js -verifier ``` Contrôle CRC32 de chaque entrée, SHA-256 de la base, intégrité SQLite, comptages, photos et sessions — **sans rien créer ni supprimer**. Code retour 1 si une archive est altérée. Détail d'une seule archive : ``` .runtime\node\node.exe compta\scripts\restauration.js --verifier-seulement ``` ### 5.5 Restaurer 1. **Arrêtez ComptaPro** (fermez la fenêtre noire) : la restauration refuse de s'exécuter si le serveur est en écoute. 2. Vérifiez l'archive si besoin (ci-dessus), puis appliquez-la : ``` .runtime\node\node.exe compta\scripts\restauration.js "" --mot-de-passe ``` 3. **Redémarrez ComptaPro** : vos données sont revenues à l'état de l'archive, à l'identique (la restauration remplace le dossier de données, elle ne « fusionne » rien). En cas de doute sur une archive, `--verifier-seulement` ne modifie rien : c'est le mode de contrôle avant de s'engager.