Documentation fonctionnelle KWISATZ
Administration et maintenance
L’administration quotidienne protège les accès, les dossiers et les sauvegardes. La maintenance technique prépare les mises à jour, contrôle l’intégrité et réserve les opérations de structure aux situations diagnostiquées.
Réponse directe
Administrez KWISATZ avec des profils distincts, un compte SUPERVISEUR réservé, une sauvegarde quotidienne contrôlée et un journal de maintenance. Avant toute mise à jour ou réparation, fermez les postes, services et interfaces, puis créez une sauvegarde complète. Après une mise à jour récente, exécutez le contrôle standard F12. N’utilisez Ctrl+F12,
-A1002 ou -A1003 que lorsqu’un diagnostic le justifie et avec un accès exclusif au dossier.Conseil technicien général
1. Repères de version
Les références de version ci-dessous sont conservées comme repères documentaires. Les menus, options et comportements doivent être contrôlés sur la version et la sérialisation réellement installées ; une évolution plus récente peut avoir modifié le fonctionnement.
2. Licence et disponibilité
La dépendance de licence mentionnée dans ce document provient des sources. Sa disponibilité peut varier selon la version, la sérialisation, le partenaire ou l’installation ; faites-la valider techniquement avant de modifier l’environnement.
3. Protection des données
4. Périmètre de l’administration
| Domaine | Responsabilité |
|---|---|
| Utilisateurs | Profils, mots de passe et droits fonctionnels. |
| Dossiers | Création, ouverture, fermeture, chemins et environnements de test. |
| Sauvegardes | Planification, rotation, vérification et restauration de recette. |
| Versions | Inventaire, mise à jour, notes de version et compatibilité. |
| Base de données | Contrôle F12 et opérations exceptionnelles de structure ou d’index. |
| Postes et réseau | Accès au dossier, paramètres de lancement, services et connectivité. |
| Périphériques | Imprimantes, TPE, balance, monnayeur et tests après maintenance. |
| Conformité | Conservation des données, pistes d’audit et opérations fiscales sensibles. |
5. Niveaux de responsabilité
| Niveau | Exemples | Autorisation |
|---|---|---|
| Administrateur fonctionnel | Profils, droits, préférences, périphériques, contrôles quotidiens. | SUPERVISEUR formé. |
| Maintenance planifiée | Sauvegarde, mise à jour, F12, tests de recette. | Administrateur ou technicien. |
| Maintenance technique | Ctrl+F12, réindexation, restauration de structures, services moteur de données. | Technicien compétent. |
| Maintenance sensible | Fichiers fiscaux, piste d’audit, suppression ou reconstruction de tables. | Support exclusivement. |
Un accès SUPERVISEUR ne signifie pas que toutes les manipulations techniques sont sûres. Les droits applicatifs et la compétence de maintenance sont deux choses différentes.
6. Profils d’utilisateurs
Le menu Profils d’utilisateurs permet de créer des combinaisons nom, mot de passe et droits d’accès.
- Le profil SUPERVISEUR existe par défaut.
- Tant qu’il reste seul, la gestion des utilisateurs n’est pas activée.
- Dès qu’un autre profil est créé, la sélection du profil apparaît au lancement.
- La gestion des profils reste inaccessible aux profils autres que SUPERVISEUR.
Ne partagez pas le mot de passe SUPERVISEUR entre tous les utilisateurs. Conservez un accès de secours documenté et protégé.
7. Concevoir les droits
| Profil | Droits conseillés |
|---|---|
| Vendeur | Vente, recherche et fonctions strictement nécessaires. |
| Responsable caisse | Clôture, décompte, contrôles et corrections autorisées. |
| Gestion | Clients, produits, achats et documents commerciaux. |
| Comptabilité | Exports, règlements, journaux et consultations. |
| Administrateur | Paramètres, profils, périphériques et maintenance planifiée. |
| SUPERVISEUR | Gestion des profils et secours, usage limité. |
Appliquez le principe du moindre privilège : un utilisateur ne doit recevoir que les fonctions dont il a besoin.
8. Lancement automatique d’un profil
Le paramètre -PROFIL=NOM_UTILISATEUR peut sélectionner automatiquement un profil dans le raccourci.
Exemple documenté :
KWISATZ.EXE -P1 -DDEMO -PROFIL=VENDEUR
Si le profil ne possède aucun mot de passe, le lancement peut devenir immédiat. N’utilisez pas cette configuration pour un profil sensible.
9. Gérer les dossiers
- KWISATZ peut gérer plusieurs dossiers mais n’en ouvre qu’un à la fois.
- Ouvrir dossier sélectionne le dossier et ouvre ses fichiers.
- Fermer dossier ferme les fichiers et revient au menu Démarrage.
- À la fermeture, le logiciel peut proposer une sauvegarde si aucune n’a été effectuée depuis sept jours.
Le rappel de sept jours n’est pas une sauvegarde automatique. Une politique quotidienne doit être configurée séparément.
10. Environnement de production et de test
| Environnement | Règle |
|---|---|
| Production | Données réelles, accès limités, sauvegarde et journalisation. |
| Test | Copie isolée, aucun TPE ou automate productif, mentions visibles. |
| Formation | Dossier démonstration sans données sensibles. |
| Restauration de recette | Machine ou chemin isolé, sans écraser la production. |
Ne testez pas une restauration, une contre-passation ou une restructuration directement sur le dossier de production.
11. Politique de sauvegarde
- Sauvegarde quotidienne du dossier et des éléments nécessaires à une restauration complète.
- Conservation sur un support distinct du serveur principal.
- Rotation quotidienne, hebdomadaire et mensuelle adaptée au volume.
- Copie hors site ou cloud selon la politique de sécurité.
- Contrôle des tailles, dates et messages d’erreur.
- Test de restauration périodique.
Une archive présente sur le disque n’est pas une preuve de restauration possible. Seul un test isolé confirme la qualité de la sauvegarde.
12. Sauvegarde manuelle et automatique
La sauvegarde automatique dépend d’un outil ou d’une tâche réellement configurée, notamment WKW_ARCHIVE_CLOUD dans les environnements concernés.
- Contrôlez le chemin de destination.
- Contrôlez la rotation et le nombre d’archives conservées.
- Vérifiez l’espace libre.
- Consultez les journaux ou messages d’exécution.
- Évitez plusieurs sauvegardes concurrentes du même dossier.
Le message proposé lors de la fermeture du dossier ne remplace pas une planification automatique.
13. Contrôler une sauvegarde
| Contrôle | Attendu |
|---|---|
| Date | Archive récente. |
| Taille | Cohérente avec les archives précédentes. |
| Ouverture | Archive lisible, sans erreur. |
| Contenu | Dossier et fichiers attendus présents. |
| Destination | Support distinct et accessible. |
| Restauration de test | Dossier isolé ouvrable et contrôlable. |
14. Restauration : règles impératives
- Identifier précisément la version de l’archive.
- Installer ou préparer une version compatible.
- Restaurer d’abord dans un emplacement isolé.
- Ne pas mélanger exécutables récents et structures anciennes.
- Contrôler l’ouverture et les données principales.
- Tester les journaux, tickets, clients et stocks.
- Planifier seulement ensuite une restauration de production.
Restaurer une archive ancienne complète après une mise à jour peut réintroduire des dossiers Structure base et Structure dossier incompatibles avec les exécutables récents.
15. Préparer une mise à jour
| Préparation | Contrôle |
|---|---|
| Version source | Notée avec sa révision. |
| Version cible | Archive officielle et prérequis vérifiés. |
| Sauvegarde | Complète, récente et contrôlée. |
| Postes | Tous fermés. |
| Services | DB-SERV, FCOM, BCOM et interfaces arrêtés si nécessaire. |
| Espace disque | Suffisant pour copie et traitement. |
| Périphériques | Plan de tests préparé. |
| Retour arrière | Procédure définie avant l’intervention. |
16. Procédure standard de mise à jour
- Créer une sauvegarde complète.
- Fermer tous les postes KWISATZ.
- Arrêter les modules et services concernés.
- Appliquer l’archive ou l’installation officielle.
- Lancer KWISATZ.
- Exécuter le contrôle F12.
- Ouvrir le dossier.
- Contrôler menus, données et journaux.
- Tester une vente, une impression et un règlement de recette.
- Tester balance, TPE, monnayeur et interfaces installées.
- Documenter la réussite ou les anomalies.
17. F12 et recalcul de cohérence
F12 est le contrôle standard après mise à jour récente.
La documentation de support distingue :
- le contrôle standard F12 ;
- le recalcul complet de cohérence ;
- la restructuration Ctrl+F12 ;
- la réindexation.
Ne lancez pas systématiquement un recalcul complet. Le support indique qu’il est notamment requis pour certaines migrations depuis une version antérieure à 3.45, tandis qu’une migration récente utilise normalement F12.
18. Ctrl+F12 et automate -A1002
Ctrl+F12 lance une restructuration du dossier. L’automate équivalent est -A1002.
- Sauvegarde obligatoire.
- Arrêt de tous les utilisateurs.
- Accès exclusif aux tables.
- Temps d’intervention variable selon le volume.
- Contrôle fonctionnel après traitement.
Une erreur moteur de données pendant Ctrl+F12 indique souvent un fichier ou un processus encore actif : DB-SERV, FCOM, BCOM, poste utilisateur ou autre accès au dossier.
19. Réindexation -A1003
L’automate -A1003 lance la réindexation des fichiers du dossier.
La réindexation n’est pas un nettoyage préventif à exécuter périodiquement. Elle ne recrée pas une structure physique manquante et ne répare pas automatiquement un fichier de données corrompu.
Avant de l’utiliser :
- créez une sauvegarde ;
- identifiez le dossier exact ;
- fermez tous les accès ;
- notez l’erreur d’origine ;
- contrôlez les données après le traitement.
20. Accès exclusif et services
| Composant | Action avant maintenance structurelle |
|---|---|
| Postes KWISATZ | Fermer complètement. |
| DB-SERV | Arrêter si la procédure l’exige. |
| FCOM / BCOM | Arrêter les communications. |
| WKW_ARCHIVE_CLOUD | Éviter un archivage concurrent. |
| Connecteurs Web / comptables | Interrompre les lectures et écritures. |
| Antivirus / sauvegarde système | Vérifier qu’aucune analyse ne verrouille les fichiers. |
21. Administrer les postes réseau
- Vérifiez le chemin du dossier partagé.
- Contrôlez les droits Windows en lecture et écriture.
- Attribuez un numéro de poste cohérent avec
-P. - Utilisez un numéro de caisse unique lorsque
-NPCest nécessaire. - Évitez plusieurs raccourcis pointant vers des dossiers différents sans libellé explicite.
- Testez la vente directe après toute modification réseau.
Un mauvais chemin peut donner l’impression que des données ont disparu alors que l’utilisateur a ouvert un autre dossier.
22. Postes distants et moteur de données
Les postes distants documentés peuvent dépendre des ports moteur de données 12005 et 12006, d’une licence adaptée et de paramètres de lancement spécifiques.
N’ouvrez pas des ports sur Internet sans sécurisation, validation de l’architecture et contrôle de la licence. Une connexion distante dépend aussi de la qualité du réseau.
Pour le diagnostic :
- tester la connectivité hors KWISATZ ;
- vérifier le serveur moteur de données ;
- contrôler pare-feu et redirections ;
- valider les paramètres du raccourci ;
- documenter le mode dégradé.
23. Administrer les périphériques
| Périphérique | Test après maintenance |
|---|---|
| Imprimante ticket | Page Windows, ticket de test et coupe. |
| Imprimante cuisine | Routage article et bon de production. |
| TPE | Paiement, refus, annulation et rapprochement. |
| Balance | Poids stable et article pesé. |
| Monnayeur | Encaissement, rendu et inventaire. |
| Lecteur code-barres | Lecture produit et touches spéciales. |
Si la vente directe ne s’ouvre plus après une mise à jour, désactivez les périphériques puis réactivez-les un par un afin d’identifier celui qui bloque l’initialisation.
24. Surveiller l’espace disque
- Contrôler régulièrement l’espace libre du serveur et des caisses.
- Surveiller le répertoire des sauvegardes.
- Configurer une rotation automatique.
- Archiver ou supprimer seulement les anciennes archives validées.
- Utiliser le nettoyage Windows avec les droits nécessaires.
- Tester une nouvelle sauvegarde après nettoyage.
Ne supprimez pas directement des fichiers moteur de données, des extensions techniques ou des fichiers fiscaux pour gagner de la place. Les suppressions techniques sont réservées au support.
25. Journaux et piste d’audit
Les journaux techniques et la piste d’audit servent au diagnostic et à la traçabilité.
- Conservez les messages exacts et leur horodatage.
- Notez le poste, le dossier et l’utilisateur.
- Recherchez les fichiers recréés ou les erreurs de communication.
- Conservez les journaux d’intégration FCOM/BCOM.
- Ne supprimez pas
P_AUDITou les fichiers fiscaux sans procédure support.
Une piste d’audit corrompue ou manquante est un incident sensible. La suppression d’un fichier pour faire redémarrer le logiciel peut détruire la traçabilité.
26. Données fiscales sensibles
- Ne modifiez pas directement les tables de tickets, règlements ou clôtures.
- Ne supprimez pas les historiques fiscaux.
- Ne reconstruisez pas un fichier fiscal sans sauvegarde et procédure documentée.
- Refaites immédiatement les clôtures lorsque le support l’exige.
- Conservez la preuve des interventions.
Les interventions sur les fichiers de clôture ou d’audit sont réservées au support et peuvent avoir un impact réglementaire majeur.
27. Plan de maintenance quotidienne
| Contrôle | Fréquence |
|---|---|
| Sauvegarde terminée sans erreur | Quotidienne. |
| Espace disque disponible | Quotidienne ou automatisée. |
| Services et interfaces actifs | À l’ouverture. |
| Imprimantes, TPE et balance | Avant exploitation. |
| Journaux d’erreurs | Après incident. |
| Clôtures et échanges attendus | Selon le cycle métier. |
28. Plan hebdomadaire et mensuel
| Fréquence | Actions |
|---|---|
| Hebdomadaire | Contrôler archives, espace disque, postes, communications et erreurs récurrentes. |
| Mensuelle | Tester une restauration isolée, vérifier versions, comptes administrateurs et documentation. |
| Trimestrielle | Tester le plan de reprise, les interfaces externes et les droits utilisateurs. |
| Annuelle | Réviser la politique de conservation, l’architecture et le contrat de maintenance. |
29. Journal de maintenance
| Champ | Exemple |
|---|---|
| Date et heure | 19/07/2026 22:00. |
| Dossier | Code et chemin. |
| Version avant / après | Révision exacte. |
| Sauvegarde | Nom, taille et destination. |
| Opération | Mise à jour, F12 ou diagnostic. |
| Intervenant | Nom et société. |
| Résultat | Succès, avertissement ou échec. |
| Tests | Vente, impression, TPE, interfaces. |
| Retour arrière | Non utilisé ou procédure appliquée. |
30. Plan de test après maintenance
| Scénario | Résultat attendu |
|---|---|
| Ouverture du dossier | Aucune erreur de structure. |
| Connexion profil | Droits conformes. |
| Liste produits et clients | Données présentes et recherches fonctionnelles. |
| Vente de test | Calculs et ticket corrects. |
| Paiement CB | Dialogue TPE et journal cohérents. |
| Impression cuisine | Bon envoyé à la bonne imprimante. |
| Export ou interface | Traitement sans doublon. |
| Sauvegarde post-maintenance | Archive créée et contrôlée. |
31. Actions à éviter
- Partager le profil SUPERVISEUR.
- Travailler sans sauvegarde testée.
- Lancer une mise à jour pendant l’exploitation.
- Confondre F12, Ctrl+F12 et réindexation.
- Exécuter systématiquement un recalcul complet.
- Laisser FCOM, BCOM ou DB-SERV verrouiller le dossier.
- Restaurer des structures anciennes sur des exécutables récents.
- Supprimer des fichiers de données ou fiscaux.
- Ouvrir un autre dossier par erreur après changement de serveur.
- Considérer un redémarrage réussi comme une validation complète.
32. Compatibilité documentée
| Fonction | Repère | Condition |
|---|---|---|
| Profils utilisateurs | Menu Démarrage | SUPERVISEUR pour l’administration. |
| Profil automatique | -PROFIL | Profil existant. |
| Contrôle standard | F12 | Après mise à jour récente. |
| Restructuration | Ctrl+F12 / -A1002 | Sauvegarde et accès exclusif. |
| Réindexation | -A1003 | Diagnostic préalable. |
| Numéro de poste | -P | Raccourci du poste. |
| Numéro de caisse forcé | -NPC | Après le paramètre -P. |
| Sauvegarde cloud | WKW_ARCHIVE_CLOUD | Configuration et rotation vérifiées. |
33. Diagnostic rapide
Le profil SUPERVISEUR n’est plus disponible
Ne modifiez pas directement les fichiers utilisateurs. Utilisez la procédure de récupération du support et vérifiez les sauvegardes.
Le logiciel demande désormais un profil au démarrage
Un second profil a été créé ; la gestion des utilisateurs s’est activée automatiquement.
F12 signale une anomalie
Conservez le message exact, arrêtez l’exploitation si nécessaire et faites analyser le dossier avant une restructuration.
Ctrl+F12 affiche une erreur moteur de données
Fermez les postes et arrêtez DB-SERV, FCOM, BCOM et les autres accès avant de relancer.
La réindexation ne corrige rien
La structure ou les données peuvent être manquantes ou corrompues. Une réindexation seule ne suffit pas.
Après restauration, la version est incompatible
Les structures anciennes ont peut-être écrasé les structures récentes. Réappliquez l’archive officielle et récupérez seulement les données nécessaires.
Les données semblent avoir disparu
Vérifiez le dossier et le chemin réellement ouverts avant toute restauration.
La vente directe bloque après mise à jour
Désactivez les périphériques puis réactivez-les un par un afin d’identifier celui qui bloque l’initialisation.
La sauvegarde échoue par manque de place
Contrôlez la rotation et les anciennes archives ; ne supprimez aucun fichier moteur de données ou fiscal.
FCOM échoue après réinitialisation d’une caisse autonome
Arrêtez FCOM, ouvrez une fois le dossier avec KWISATZ autonome pour recréer les structures locales, puis relancez FCOM.
Un poste distant ne se connecte plus
Contrôlez licence, version, ports, pare-feu, serveur moteur de données et paramètres du raccourci.
Une clôture fiscale semble incohérente
N’effacez aucun fichier. Sauvegardez et transmettez le dossier au support pour une procédure contrôlée.
34. Résultat attendu
Les utilisateurs disposent de droits adaptés, le compte SUPERVISEUR reste protégé, les sauvegardes sont récentes et restaurables, les mises à jour sont réalisées hors production avec contrôle F12, et les opérations de structure restent exceptionnelles et tracées. Les postes, interfaces et périphériques sont testés avant reprise, tandis que les données fiscales et la piste d’audit ne sont jamais modifiées sans procédure support.
35. Sources documentaires
- MENUS KWISATZ — ouverture et fermeture des dossiers, sauvegarde proposée après sept jours et profils utilisateurs.
- Tutoriels KWISATZ — paramètres
-PROFIL,-NPC,-A1002et-A1003. - Base support — procédure standard de mise à jour, sauvegarde et contrôle F12.
- Base support — exclusivité Ctrl+F12, DB-SERV, FCOM et BCOM.
- Base support — restauration ancienne, structures de base et incompatibilité de version.
- Base support — espace disque, rotation des sauvegardes et
WKW_ARCHIVE_CLOUD. - Base support — piste d’audit, réindexation et interventions fiscales sensibles.