Documentation technique et fonctionnelle KWISATZ

Le module Web Statistiques

WebStatistique, aussi appelé WebStat dans certaines versions, publie dans un navigateur des tableaux de bord et indicateurs issus des données KWISATZ. Le module fonctionne comme un service Windows et construit ses analyses à partir de données consolidées.

Télécharger cette fiche en PDF
Fiche : WEB-STAT-001 Module : WebStatistique Public : administrateur ou technicien Risque : critique pour la sécurité réseau Catégorie : Interfaces, e-commerce et multi-sitesMise à jour : 6 août 2026

Réponse directe

Installez WebStatistique sur le serveur ou poste hébergeant les données KWISATZ, installez le pilote ODBC moteur de données, démarrez le service Windows, puis ouvrez l’adresse du module dans un navigateur. Dans Gestion des sources, conservez uniquement les dossiers à publier, lancez la consolidation et créez ensuite les utilisateurs applicatifs.
Les tableaux de bord contiennent des informations commerciales sensibles. N’exposez pas directement le port HTTP sur Internet sans protection. Privilégiez un VPN ou un reverse proxy HTTPS correctement administré.

Conseil technicien général

1. Distinguer KWISATZ des opérations externes

Un enregistrement dans KWISATZ ne prouve pas automatiquement qu’une opération a été exécutée dans un système externe : débit ou remboursement TPE, mouvement physique d’espèces, envoi de SMS ou d’e-mail, ou action réalisée sur une plateforme.

2. Protection des données

3. Architecture générale

Composant Rôle
Dossiers KWISATZ / moteur de données Sources commerciales : tickets, ventes, règlements et éventuellement factures selon la configuration.
Pilote ODBC moteur de données Permet au module Web d’accéder aux données KWISATZ.
Service Windows WebStatistique Héberge l’application Web et exécute les consolidations.
Configuration applicative Contient notamment le chemin source, le port, les options de consolidation et les paramètres techniques.
Base locale WebStatistique Conserve les comptes applicatifs et les données propres au module, selon la version.
Navigateur Affiche l’administration, les sources, les tableaux de bord et les statistiques.
L’intitulé exact du service, du dossier d’installation et de certains fichiers peut varier selon la version du setup WebStatistique.

4. Données consolidées, pas nécessairement instantanées

Le tableau de bord peut donner une impression de temps réel, mais les résultats sont construits à partir de consolidations. Leur date de fraîcheur dépend :

  • du dernier traitement réussi ;
  • de la fréquence planifiée ;
  • du volume historique ;
  • des dossiers inclus ;
  • des options comme l’inclusion des factures ;
  • de la disponibilité des bases sources.
Avant de prendre une décision sur un chiffre, vérifiez l’heure de la dernière consolidation et comparez la période avec une statistique KWISATZ de référence.

5. Prérequis d’installation

  • serveur ou poste Windows compatible et stable ;
  • droits administrateur local ;
  • accès au répertoire réel de KWISATZ ;
  • pilote ODBC moteur de données compatible ;
  • espace disque disponible pour la consolidation ;
  • port TCP libre pour l’application Web ;
  • navigateur récent ;
  • sauvegarde du dossier d’une installation WebStatistique existante ;
  • liste des sociétés ou magasins devant être publiés ;
  • architecture de sécurité validée pour l’accès distant.
Identifiez le vrai chemin KWISATZ à partir du raccourci ou de l’installation active. Ne sélectionnez pas un ancien dossier, une copie de démonstration ou une archive.

6. Installer le module

  1. Connectez-vous au serveur avec un compte administrateur.
  2. Sauvegardez l’ancien dossier WebStatistique s’il existe.
  3. Vérifiez que le port envisagé n’est pas déjà utilisé.
  4. Lancez le setup WebStatistique en tant qu’administrateur.
  5. Sélectionnez le chemin racine KWISATZ réellement exploité.
  6. Cliquez explicitement sur l’étape ou le bouton Installer le pilote ODBC moteur de données.
  7. Configurez le service Windows et son démarrage automatique.
  8. Terminez l’installation.
  9. Ouvrez la console des services Windows.
  10. Vérifiez que le service WebStatistique est démarré.
Un setup parcouru uniquement avec « Suivant » peut laisser le pilote ODBC non installé. Le service peut alors démarrer, mais l’interface renverra une erreur ou ne pourra pas lire les données.

7. Vérifier la configuration technique

Le fichier de configuration est généralement nommé appsettings.json. Son format dépend de la version. Les paramètres documentés comprennent notamment :

Paramètre Contrôle
Chemin KWISATZ Doit pointer vers l’installation et les dossiers réellement utilisés.
Port HTTP Doit être libre, autorisé par le pare-feu et identique au port utilisé dans l’URL.
Source moteur de données / ODBC Doit être disponible et associée au pilote correctement installé.
Années à consolider Limite l’historique chargé lors du traitement initial.
Inclure les factures Ajoute les documents de gestion commerciale lorsque l’option et la version le permettent.
Consolidation au démarrage Lance un traitement lors du démarrage du service.
Consolidation planifiée Définit l’heure du traitement quotidien ; un exemple historique utilise 03:00.
Ne recopiez pas un port ou un fichier JSON d’une autre installation. Les anciens formats de configuration peuvent être incompatibles avec un nouveau setup.
Les paramètres d’accès moteur de données sont techniques et distincts des utilisateurs WebStatistique. Ne les remplacez pas par un identifiant humain ou un compte de connexion à l’interface.

8. Effectuer le premier accès

  1. Depuis le serveur, ouvrez un navigateur.
  2. Saisissez l’adresse locale du service avec le port configuré.
  3. Vérifiez que la page de connexion apparaît.
  4. Contrôlez le journal du service en cas d’erreur.
  5. Testez ensuite depuis un poste du réseau local.
Une adresse DNS ou DynDNS ne remplace pas la configuration réseau. Le nom doit résoudre vers la bonne adresse et le trafic doit être dirigé vers le serveur.

9. Sélectionner les sources à publier

L’interface Gestion des sources permet d’identifier les dossiers KWISATZ disponibles et d’exclure ceux qui ne doivent pas être traités.

  1. Ouvrez la gestion des sources.
  2. Repérez les dossiers de démonstration, formation, test ou archive.
  3. Excluez les dossiers qui ne doivent pas être consolidés.
  4. Conservez uniquement les sociétés ou magasins officiels à publier.
  5. Enregistrez la sélection.
  6. Redémarrez ou relancez la consolidation si la version le demande.
Le traitement de tous les dossiers peut rendre la première consolidation très longue. Excluez les dossiers inutiles avant de lancer l’historique complet.
Ne publiez pas un dossier de démonstration contenant des données copiées d’un client réel. Les données statistiques doivent rester accessibles uniquement aux personnes autorisées.

10. Lancer la consolidation initiale

  1. Choisissez un seul dossier de test au départ.
  2. Limitez les années à une période raisonnable.
  3. Décidez si les factures doivent être incluses.
  4. Lancez la consolidation.
  5. Suivez la progression jusqu’à son terme.
  6. Consultez les journaux si le pourcentage reste bloqué.
  7. Testez le tableau de bord sur une période comportant des tickets.
  8. Élargissez ensuite aux autres dossiers et années.
Une première consolidation peut être longue. Sa durée dépend du nombre de dossiers, de l’historique, du serveur et des types de documents inclus.
La consolidation est considérée comme valide lorsque le traitement se termine, que le tableau de bord affiche une période connue et que les montants concordent avec une statistique KWISATZ de référence.

11. Créer les utilisateurs applicatifs

Les utilisateurs WebStatistique sont créés dans l’interface Web. Ils sont distincts des comptes Windows et de la connexion technique moteur de données.

  1. Ouvrez l’administration des utilisateurs.
  2. Créez un compte nominatif.
  3. Utilisez un identifiant sans espace.
  4. Renseignez une adresse e-mail si elle est utilisée par le module.
  5. Définissez un mot de passe robuste et unique.
  6. Attribuez le rôle et les droits strictement nécessaires.
  7. Testez la connexion dans une fenêtre privée du navigateur.
  8. Désactivez les comptes qui ne sont plus utilisés.
Évitez les comptes partagés. Un compte nominatif facilite la révocation, le suivi des accès et la protection des données commerciales.
Sur certaines anciennes versions, un identifiant contenant un espace pouvait provoquer une erreur technique peu explicite.

12. Utiliser le tableau de bord

Les cas d’usage documentés comprennent la consultation, depuis un ordinateur, une tablette ou un smartphone, d’indicateurs comme :

  • le chiffre d’affaires du jour ;
  • le chiffre d’affaires du mois ;
  • le chiffre d’affaires de l’année ;
  • des comparatifs avec la veille ou une période précédente ;
  • des comparatifs mensuels ou annuels ;
  • les résultats de vente directe ;
  • les factures de gestion si elles sont incluses ;
  • les résultats consolidés de plusieurs magasins ou dossiers.
Les écrans et indicateurs disponibles dépendent de la version. N’annoncez pas un filtre ou une ventilation qui n’a pas été vérifié dans l’interface installée.

Contrôle d’un indicateur

  1. Notez le dossier et la période sélectionnés.
  2. Vérifiez la date de dernière consolidation.
  3. Reproduisez la même période dans KWISATZ.
  4. Contrôlez le périmètre : tickets, factures, magasins et taxes.
  5. Comparez HT, TVA, TTC et règlements lorsque ces valeurs sont disponibles.

13. Gérer plusieurs dossiers ou magasins

WebStatistique peut consolider plusieurs sources KWISATZ. Pour obtenir des résultats exploitables :

  • documentez les dossiers publiés ;
  • excluez les copies et les dossiers de formation ;
  • vérifiez que les périodes des magasins sont comparables ;
  • contrôlez la présence de ventes dans chaque source ;
  • évitez de consolider deux copies du même magasin ;
  • validez l’inclusion ou non des factures de gestion.
Deux dossiers contenant les mêmes tickets peuvent doubler artificiellement les résultats. Contrôlez l’unicité des sources avant toute consolidation multi-magasins.

14. Sécuriser l’accès distant

Un accès depuis l’extérieur peut nécessiter une adresse fixe ou un DNS, une règle de routage et une protection adaptée. La simple ouverture d’un port HTTP n’est pas une architecture de sécurité suffisante.

Méthode recommandée

  1. Utilisez de préférence un VPN d’entreprise.
  2. À défaut, placez le service derrière un reverse proxy HTTPS.
  3. Installez un certificat TLS valide.
  4. Limitez les adresses ou réseaux autorisés.
  5. Utilisez des mots de passe uniques et robustes.
  6. Activez les journaux et surveillez les tentatives de connexion.
  7. Mettez à jour Windows et WebStatistique.
  8. Testez l’accès depuis un réseau extérieur autorisé.
Évitez une redirection NAT directe vers le service HTTP, surtout si aucune couche HTTPS ou authentification renforcée ne protège l’application.

15. Maintenance régulière

  • vérifier que le service Windows est démarré ;
  • contrôler la dernière consolidation réussie ;
  • lire les erreurs du journal applicatif ;
  • contrôler l’espace disque ;
  • sauvegarder le dossier WebStatistique et sa base locale ;
  • supprimer ou désactiver les comptes obsolètes ;
  • réviser la liste des sources publiées ;
  • mettre à jour le module avec une version validée ;
  • contrôler les exclusions de l’antivirus seulement lorsqu’elles sont justifiées.
Une exclusion antivirus ne doit jamais être ajoutée sans preuve de blocage et sans validation de la politique de sécurité de l’entreprise.

16. Diagnostic rapide

La page renvoie une erreur HTTP 500 juste après le setup
Vérifiez d’abord l’installation du pilote ODBC moteur de données. Redémarrez ensuite le service et contrôlez le journal avant de modifier les chemins.
Le service démarre mais le tableau de bord est vide
Contrôlez la fin de la consolidation, la source sélectionnée et la période. Testez une journée contenant des tickets connus.
La consolidation dure anormalement longtemps
Ouvrez Gestion des sources et excluez les dossiers de démonstration, les archives et les copies. Réduisez également le nombre d’années traitées.
Le port configuré ne répond pas
Vérifiez la valeur réellement enregistrée dans la configuration, l’écoute du service, le pare-feu Windows et l’absence d’un autre programme utilisant déjà ce port.
Les comparatifs N-1 ou période précédente sont absents
L’historique correspondant n’a peut-être pas été consolidé. Ajoutez l’année nécessaire, relancez le traitement puis actualisez le tableau de bord.
Les statistiques de vente directe restent à zéro
Vérifiez que la période contient réellement des tickets dans le dossier publié. Contrôlez aussi que vous ne consultez pas uniquement un dossier de facturation sans activité caisse.
La liste des utilisateurs est vide mais un utilisateur existe déjà
Il peut s’agir d’un dysfonctionnement d’une ancienne version ou d’une incohérence de la base locale WebStatistique. Sauvegardez le dossier, consultez les logs et contactez le support. Ne modifiez pas directement les tables utilisateurs.
WebStat fonctionne puis plante avec une erreur ASP.NET Core
Arrêtez le service, sauvegardez tout le dossier WebStatistique, régénérez un journal propre et vérifiez les droits, les fichiers locaux, l’antivirus et la version installée. Toute recréation de la base locale doit être réalisée par un technicien, car elle peut supprimer les comptes et les données propres au module.
Le résultat Web diffère de KWISATZ
Comparez la même période, les mêmes sources et le même périmètre : tickets, factures, magasins, TVA et date de consolidation. Relancez ensuite la consolidation avant de conclure à une anomalie de calcul.

17. Règles de sécurité

  • ne publiez pas de comptes techniques ou mots de passe dans une documentation ;
  • séparez les comptes moteur de données des utilisateurs WebStatistique ;
  • utilisez des comptes applicatifs nominatifs ;
  • limitez les droits et les dossiers accessibles ;
  • n’exposez pas directement le service en HTTP sur Internet ;
  • sauvegardez la base locale avant toute intervention ;
  • n’éditez pas manuellement la base SQLite ou les fichiers JSON sans support ;
  • journalisez les modifications de configuration ;
  • révoquez rapidement les anciens utilisateurs.

18. Liste de contrôle de mise en service

  • Le bon serveur et le bon chemin KWISATZ sont sélectionnés.
  • Le pilote ODBC moteur de données est installé.
  • Le service Windows est démarré automatiquement.
  • Le port configuré est libre et filtré.
  • Les dossiers de démonstration sont exclus.
  • La consolidation initiale est terminée.
  • Une période connue a été comparée avec KWISATZ.
  • Les utilisateurs applicatifs sont nominatifs.
  • Les mots de passe et rôles sont contrôlés.
  • L’accès distant utilise un VPN ou HTTPS sécurisé.
  • La sauvegarde et la maintenance sont planifiées.

19. Résultat attendu

Les utilisateurs autorisés accèdent depuis leur navigateur aux tableaux de bord des dossiers sélectionnés, les données sont consolidées selon la fréquence prévue et les résultats concordent avec les statistiques KWISATZ de référence.

20. Limites documentées

  • le setup et les fichiers de configuration ont évolué selon les versions ;
  • le port par défaut n’est pas constant dans les installations documentées ;
  • la consolidation initiale peut être longue ;
  • un tableau de bord vide peut simplement correspondre à une période sans ventes ;
  • les indicateurs disponibles dépendent de la version ;
  • la publication distante exige une configuration réseau et de sécurité extérieure à KWISATZ.

21. Sources documentaires

  • Base support KWISATZ — installation de WebStatistique et service Windows.
  • Base support KWISATZ — pilote ODBC moteur de données et erreur HTTP 500.
  • Base support KWISATZ — Gestion des sources et exclusion des dossiers de démonstration.
  • Base support KWISATZ — consolidation, tableaux de bord et accès distant.
  • Base support KWISATZ — incidents utilisateurs, base locale et journal ASP.NET Core.