🇫🇷 Français
================================================================================
  SELGORITHM — SYSTÈME DE POINT DE VENTE
  MANUEL D'UTILISATION
  Version 2026
================================================================================

--------------------------------------------------------------------------------
TABLE DES MATIÈRES
--------------------------------------------------------------------------------
  1. Introduction et présentation du système
  2. Avantages clés
  3. Prise en main
  4. Fonctionnalités principales
     4.1  Saisie de produit et lecture de code-barres
     4.2  Gestion du panier
     4.3  Paiement et traitement des ventes
     4.4  Gestion des clients (comptes)
     4.5  Mise en attente de commande
     4.6  Gestion des produits
     4.7  Système de codes de type
     4.8  Cartes de fidélité et points
     4.9  Rapports
     4.10 Rapport de bénéfices
     4.11 Annulation et correction de vente
     4.12 Rapport de mouvements
     4.13 Module finance et personnel
     4.14 Liste de sortie d'entrepôt
     4.15 Import / export de données
     4.16 Impression de reçus
     4.17 Impression d'étiquettes code-barres
  5. Administration
     5.1  Gestion des utilisateurs
     5.2  Paramètres et thèmes
  6. Raccourcis clavier
  7. Sécurité des données et sauvegarde
  8. Notes techniques

================================================================================
1. INTRODUCTION ET PRÉSENTATION DU SYSTÈME
================================================================================

Selgorithm est une application de point de vente (POS) professionnelle,
utilisable hors ligne, conçue spécifiquement pour les librairies et les
commerces de détail. Construite sur une interface web moderne fonctionnant
localement sous Windows, elle combine la flexibilité d'une interface
utilisateur basée sur navigateur avec la fiabilité et la rapidité d'une
application de bureau.

Selgorithm ne nécessite aucune connexion Internet pour les opérations
quotidiennes. Toutes les données sont stockées localement dans une base de
données SQLite chiffrée, garantissant que vos données professionnelles
restent privées et immédiatement accessibles même sans connexion réseau.

L'application prend en charge 8 langues, 13 thèmes visuels et plusieurs
formats de devise — la rendant adaptée aux opérations nationales et
internationales.

================================================================================
2. AVANTAGES CLÉS
================================================================================

  RAPIDITÉ ET EFFICACITÉ
  ——————————————————————
  La lecture de code-barres finalise une vente en quelques secondes. Les
  raccourcis clavier éliminent le besoin d'atteindre la souris aux heures de
  pointe, réduisant considérablement le temps de transaction et la fatigue
  du caissier.

  PROPRIÉTÉ DES DONNÉES
  ——————————————————————
  Vos données ne quittent jamais votre appareil. Aucun abonnement, aucune
  dépendance au cloud, aucun risque d'interruption de service. Propriété
  totale de votre historique de ventes, données clients et inventaire à
  tout moment.

  VISIBILITÉ DES BÉNÉFICES
  —————————————————————————
  Le rapport de bénéfices intégré calcule le bénéfice net par jour, semaine,
  mois et année en comparant les prix de vente aux coûts d'achat. Cela permet
  aux propriétaires d'identifier les périodes à forte marge et de prendre des
  décisions d'approvisionnement éclairées.

  RELATIONS CLIENTS
  ——————————————————
  Le système de cartes de fidélité et de points encourage les clients
  réguliers. Le suivi détaillé des comptes (ventes à crédit) aide à gérer
  les clients créditeurs et les soldes impayés de manière transparente.

  CONTRÔLE D'ACCÈS MULTI-UTILISATEURS
  ————————————————————————————————————
  L'accès basé sur les rôles (admin vs. personnel) garantit que les caissiers
  ne peuvent effectuer que les opérations autorisées, tandis que les managers
  conservent le contrôle total sur les fonctions sensibles telles que les
  annulations, les rapports et la configuration.

  CONTRÔLE DES STOCKS
  ————————————————————
  Mises à jour automatiques des stocks à chaque vente et annulation. Les
  alertes de stock faible évitent les ruptures de stock sur les titres
  populaires. La liste de sortie d'entrepôt produit un PDF imprimable
  affichant tous les articles vendus sur n'importe quelle plage de dates.

================================================================================
3. PRISE EN MAIN
================================================================================

  PREMIER LANCEMENT
  ——————————————————
  Au premier lancement, un assistant de configuration vous guide pour
  paramétrer :
    - Nom de l'entreprise et emoji logo
    - Langue et devise par défaut
    - Nom d'utilisateur et mot de passe administrateur

  CONNEXION
  —————————
  Accédez à la page de connexion et saisissez vos identifiants. Utilisez
  l'option « Se souvenir de moi » sur les appareils partagés uniquement si
  cela est approprié pour votre politique de sécurité.

  COMPATIBILITÉ DES APPAREILS
  —————————————————————————
  Selgorithm détecte automatiquement votre type d'appareil et charge une
  mise en page optimisée :
    - Bureau : Mise en page à double panneau complète
    - Tablette : Mise en page adaptée avec navigation par tiroir coulissant
    - Mobile : Interface compacte optimisée pour le toucher

================================================================================
4. FONCTIONNALITÉS PRINCIPALES
================================================================================

4.1  SAISIE DE PRODUIT ET LECTURE DE CODE-BARRES
—————————————————————————————————————————————————
  Scannez un code-barres de produit avec un scanner USB ou Bluetooth, ou
  tapez le code-barres manuellement dans le champ de saisie. Le produit est
  immédiatement récupéré dans la base de données et ajouté au panier.

  AVANTAGE : La lecture de code-barres élimine les erreurs de saisie manuelle
  des prix et réduit le temps de transaction à moins de 2 secondes par article,
  même avec de grands inventaires.

  - Appuyez sur F4 à tout moment pour mettre immédiatement le focus sur le
    champ de saisie du code-barres.
  - Appuyez sur F3 pour rechercher des produits par nom lorsqu'un code-barres
    n'est pas disponible.


4.2  GESTION DU PANIER
——————————————————————
  Le panier affiche tous les articles scannés avec des champs modifiables
  pour la quantité, la remise et le prix unitaire. Cliquez sur une cellule
  pour la modifier en ligne.

  AVANTAGE : La modification du panier en temps réel permet aux caissiers
  d'appliquer des remises personnalisées, de corriger les quantités et d'ajuster
  les prix sans redémarrer la transaction.

  - Sélectionnez une ligne et appuyez sur F2 pour ouvrir le modal complet
    de modification du produit.
  - Utilisez Ctrl+↓ / Ctrl+↑ pour naviguer entre les lignes du panier au
    clavier.
  - Clic droit sur une ligne pour les options du menu contextuel
    (modifier / supprimer).


4.3  PAIEMENT ET TRAITEMENT DES VENTES
—————————————————————————————————————
  Selgorithm prend en charge trois méthodes de paiement :

    ESPÈCES (F8)    — Paiement immédiat en espèces. Le stock est réduit,
                       le compteur de revenus journaliers est mis à jour.
    CARTE (F9)      — Paiement par carte de crédit/débit. Même processus
                       qu'en espèces.
    CRÉDIT (F6)     — Paiement différé assigné à un compte client. Crée
                       automatiquement une entrée de dette dans le grand livre
                       du client. Disponible uniquement lorsqu'un client est
                       sélectionné.

  AVANTAGE : Les options de paiement flexibles prennent en charge tous les
  scénarios de vente au détail. Les ventes à crédit permettent une gestion
  formelle des comptes sans logiciel de comptabilité externe.


4.4  GESTION DES CLIENTS (COMPTES)
————————————————————————————————
  Ajoutez et gérez les comptes clients pour le suivi des crédits. Chaque
  client dispose d'un grand livre affichant toutes les ventes à crédit,
  les paiements et les soldes.

  AVANTAGE : Remplacez les livres de compte papier par un enregistrement
  numérique consultable et toujours précis de chaque solde impayé et de
  l'historique des transactions de chaque client.

  - Renommez ou supprimez des clients depuis le menu des paramètres.
  - Les comptes clients sont directement intégrés aux ventes à crédit.


4.5  MISE EN ATTENTE DE COMMANDE (F7)
——————————————————————————————————————
  Enregistrez un panier partiellement complété dans la file d'attente pendant
  que vous servez un autre client. Les commandes en attente sont listées dans
  le panneau droit et peuvent être restaurées à tout moment.

  AVANTAGE : Élimine les ventes perdues dues aux interruptions des clients.
  Les caissiers peuvent gérer plusieurs transactions simultanément sans perte
  de données.


4.6  GESTION DES PRODUITS
——————————————————————————
  Chaque fiche produit contient :
    - Code-barres, titre, éditeur
    - Prix de liste (prix de couverture)
    - Remise d'achat (base de coût pour le calcul du bénéfice)
    - Remise revendeur
    - Remise client
    - Niveau de stock actuel
    - Code de type (catégorie)
    - Image de couverture

  Clic droit sur un produit scanné pour modifier ses détails.

  AVANTAGE : Les données centralisées de produits garantissent une tarification
  cohérente pour toutes les transactions. L'intégration de la remise d'achat
  permet un suivi automatique des bénéfices sans saisies manuelles des coûts.


4.7  SYSTÈME DE CODES DE TYPE
———————————————————————————
  Attribuez des codes de type de 1 à 3 caractères pour catégoriser les
  produits (ex. R = Roman, T = Test/Scolaire, C = Enfants). Créez des codes
  personnalisés illimités avec des couleurs personnalisées via Paramètres →
  Gérer les codes de type.

  AVANTAGE : Les codes de type permettent des listes de sortie d'entrepôt
  filtrées, permettant au personnel d'entrepôt de ne voir que les catégories
  de produits pertinentes pour leur zone de travail.


4.8  CARTES DE FIDÉLITÉ ET POINTS
——————————————————————————————————
  Émettez des cartes de fidélité physiques avec des numéros de carte uniques.
  Les points sont gagnés automatiquement sur la base d'un taux de gain
  configurable par achat. Consultez le total des points et l'historique des
  transactions de chaque client dans le module Finance.

  AVANTAGE : Les programmes de fidélité augmentent les taux de rachat. Le
  système de points automatisé ne nécessite aucun suivi manuel et s'intègre
  parfaitement au traitement des ventes.


4.9  RAPPORTS — RAPPORT DE VENTES SUR UNE PLAGE DE DATES
——————————————————————————————————————————————————————————
  Accès via Rapports → Rapport par plage de dates. Sélectionnez n'importe
  quelle date de début et de fin pour générer une liste complète des ventes
  incluant : date, code-barres, titre, éditeur, quantité, prix unitaire,
  remise, total, client et type de paiement.

  AVANTAGE : Accès instantané aux données de ventes historiques pour toute
  période. Exportez vers Excel pour une analyse approfondie ou une intégration
  comptable. Imprimez directement depuis le navigateur pour des enregistrements
  physiques.


4.10 RAPPORT DE BÉNÉFICES
——————————————————————————
  Accès via Rapports → Rapport de bénéfices. Consultez les données de bénéfices
  agrégées sur quatre échelles de temps : Quotidien, Hebdomadaire, Mensuel,
  Annuel.

  Chaque ligne affiche : Période | Qté | Revenus | Coût | Bénéfice | Marge%
  Les cartes récapitulatives affichent le chiffre d'affaires total, les coûts,
  le bénéfice net et la marge moyenne.

  Bénéfice = Revenus − (Qté × Prix de liste × (1 − Remise d'achat%))

  AVANTAGE : Données de rentabilité en temps réel sans comptable. Identifiez
  quelles périodes, saisons ou mois génèrent les marges les plus élevées.
  Comparez les performances hebdomadaires pour optimiser les décisions de
  commande et de personnel.


4.11 ANNULATION ET CORRECTION DE VENTE
————————————————————————————————————
  ANNULATION : Recherchez une vente passée par code-barres. Consultez les
  détails de la vente et confirmez l'annulation. L'enregistrement annulé est
  archivé, le stock est automatiquement restauré et les revenus sont ajustés.

  CORRECTION : Déplace les articles d'une vente passée dans le panier actif
  pour une retarification ou une nouvelle numérisation avant de revendre aux
  valeurs corrigées.

  AVANTAGE : Corrections sécurisées pour l'audit sans suppression permanente
  de données. Les ventes annulées sont conservées dans une archive séparée
  pour la conformité et la révision.


4.12 RAPPORT DE MOUVEMENTS
——————————————————————————
  Accès via Rapports → Mouvements. Scannez ou saisissez un code-barres pour
  consulter les 7 derniers jours d'activité de vente pour ce produit
  spécifique, y compris la quantité vendue par jour.

  AVANTAGE : Identifiez rapidement les stocks à rotation rapide pour prioriser
  les réapprovisionnements avant qu'une rupture de stock ne survienne.


4.13 MODULE FINANCE ET PERSONNEL
—————————————————————————————————
  Accès via Admin → Finance et Personnel (/finans).

  Fonctionnalités :
    - Gestion du personnel : ajouter du personnel, suivre les heures de travail
      (prise en charge des heures supplémentaires)
    - Paiements salariaux : enregistrer et suivre l'historique des paiements
      par employé
    - Suivi des dépenses : enregistrer les dépenses professionnelles par
      catégorie
    - Résumé financier quotidien : revenus, dépenses, solde net
    - Comptes clients : grand livre débit/crédit complet par client
    - Exportation des données financières vers Excel

  AVANTAGE : Vue d'ensemble financière complète des petites entreprises sur
  un seul écran. Pas besoin de logiciel de paie ou de dépenses séparé pour
  les petites équipes.


4.14 LISTE DE SORTIE D'ENTREPÔT (eksik-listesi)
——————————————————————————————————————————————
  Accès via Admin → Liste manquante. Sélectionnez une plage de dates et des
  filtres de type de produit pour générer un PDF imprimable affichant tous
  les articles vendus (liste de sortie/préparation d'entrepôt).

  AVANTAGE : Fournit au personnel d'entrepôt une liste de préparation claire
  filtrée par type directement à partir des données de vente — éliminant la
  préparation manuelle des listes et réduisant les erreurs d'exécution.


4.15 IMPORT / EXPORT DE DONNÉES
————————————————————————————
  Accès via le menu Données.

  EXPORT :
    - Liste de stock vers Excel (.xlsx)
    - Rapport de ventes vers Excel pour toute plage de dates
    - Sauvegarde complète de la base de données (fichier .db)

  IMPORT :
    - Import de produits en masse via modèle Excel
    - Le mode aperçu montre les problèmes potentiels avant application
    - Restauration de la base de données depuis une sauvegarde

  AVANTAGE : Intégration transparente avec les flux de travail basés sur Excel.
  La saisie de produits en masse réduit considérablement le temps de configuration
  pour les nouveaux magasins. Les sauvegardes régulières protègent contre la
  perte de données.


4.16 IMPRESSION DE REÇUS
—————————————————————————
  Configurez votre imprimante de reçus thermique dans Paramètres → Paramètres
  des reçus. Les reçus comprennent le nom de l'entreprise, le sous-en-tête,
  le panier détaillé, les totaux, le résumé des remises et les informations
  client.

  AVANTAGE : Des reçus professionnels renforcent la confiance des clients et
  fournissent un enregistrement physique de chaque transaction pour les deux
  parties.


4.17 IMPRESSION D'ÉTIQUETTES CODE-BARRES
——————————————————————————————————————
  Dans le modal de modification du produit, cliquez sur le bouton d'impression
  pour ouvrir le designer d'étiquettes code-barres. Choisissez la taille
  d'étiquette, la quantité et la mise en page. Imprimez directement sur
  n'importe quelle imprimante connectée.

  AVANTAGE : L'impression d'étiquettes en interne élimine la dépendance aux
  étiquettes pré-imprimées et permet un réétiquetage immédiat lors des
  changements de prix.

================================================================================
5. ADMINISTRATION
================================================================================

5.1  GESTION DES UTILISATEURS
———————————————————————————
  Les utilisateurs admin peuvent créer, modifier et supprimer des comptes
  personnels sur /admin/users. Deux rôles sont disponibles :

    ADMIN    — Accès complet à toutes les fonctionnalités, y compris les
               rapports, les annulations, la gestion des utilisateurs et
               la configuration.
    PERSONNEL — Accès uniquement aux ventes, au panier, aux mises en attente
               et à la sélection des clients.

  AVANTAGE : La séparation des rôles empêche l'accès non autorisé aux fonctions
  sensibles telles que les rapports financiers et les annulations de vente.


5.2  PARAMÈTRES ET THÈMES
——————————————————————————
  Accès via Admin → Paramètres.

    - Nom de l'entreprise et emoji logo
    - Langue d'affichage (8 options)
    - Thème visuel (13 options)
    - Symbole de devise
    - Seuil d'alerte de stock faible
    - Nom de client par défaut
    - Gestion des codes de type

  AVANTAGE : La personnalisation complète garantit que l'interface reflète
  votre marque et semble familière à votre équipe dès le premier jour.

================================================================================
6. RACCOURCIS CLAVIER
================================================================================

  TOUCHE      ACTION
  ——————————  ————————————————————————————————————————
  F1          Ouvrir la référence des raccourcis clavier
  F2          Modifier le produit sélectionné (la ligne du panier doit être
              sélectionnée)
  F3          Ouvrir la recherche de produit par nom
  F4          Focus sur le champ de saisie du code-barres (tout sélectionner)
  F5          Recharger la page
  F6          Traiter une vente à crédit
  F7          Mettre en attente la commande actuelle
  F8          Traiter une vente en espèces
  F9          Traiter un paiement par carte
  F11         Basculer en mode plein écran
  Ctrl+↓      Déplacer la sélection vers la ligne suivante du panier
  Ctrl+↑      Déplacer la sélection vers la ligne précédente du panier
  Entrée      Confirmer le code-barres / confirmer la modification de cellule
  Échap       Annuler la modification en ligne / fermer le modal
  ↑ / ↓       Naviguer dans une cellule modifiable

================================================================================
7. SÉCURITÉ DES DONNÉES ET SAUVEGARDE
================================================================================

  Toutes les données sont stockées localement à :
    %LOCALAPPDATA%\Selgorithm_Web\

  Les secrets de session sont générés automatiquement au premier lancement et
  stockés localement. Aucune donnée n'est transmise à des serveurs externes.

  CALENDRIER DE SAUVEGARDE RECOMMANDÉ :
    - Quotidien : Exporter la sauvegarde de la base de données via Données →
      Sauvegarde
    - Hebdomadaire : Copier le dossier Selgorithm_Web sur un lecteur externe
      ou un service de stockage cloud de votre choix

  RESTAURATION : Utilisez Données → Restaurer la base de données pour charger
  un fichier de sauvegarde précédent.

================================================================================
8. NOTES TECHNIQUES
================================================================================

  - Fonctionne sur Python 3.10+ avec le framework web Flask
  - Base de données : SQLite (fichier .db unique, portable)
  - Interface : WebView2 (intégré Windows) rendant un serveur web local
  - Système d'exploitation minimum : Windows 10 (64 bits)
  - Aucune connexion Internet requise pour le fonctionnement
  - Fonctionnement multi-appareils possible sur un réseau local
    (contactez votre revendeur)

================================================================================
  © 2026 Selgorithm. Tous droits réservés.
================================================================================