Guide d'utilisation — Maquis Manager

Gestion multi-maquis : ventes, point du jour, stock, achats, casiers, recouvrement, avoirs clients, charges et paramètres. Menu Guide dans l'app → liens vers les ancres ci-dessous.

1. Première connexion

1. Ouvrez l'application (URL de production ou http://127.0.0.1:8001 en local).
2. Identifiant et mot de passe.
3. 2FA si activée : code OTP (6 chiffres) ou code WhatsApp.
4. Renouvellement mensuel : au 1^er du mois, changez votre mot de passe si l'écran « Renouvellement mensuel » s'affiche. Un changement dans le mois en cours vous couvre jusqu'à la fin de ce mois.

Déconnexion : barre latérale (bureau) ou menu Plus / Paramètres (mobile).

2. Navigation générale

Le menu Guide dans l'application ouvre ce sommaire pour lecture ou PDF (Ctrl+P).

Zone	Contenu
Tableau de bord	CA, charges, bénéfice, alertes, casiers, export
Point du jour	Synthèse · Clôture · Ventes
Ventes	Commandes · Caisse & Paiement · Consignes · QR
Stock	Catalogue · Inventaire · Mouvements · Achats · Créanciers · Casiers
Charges	Dépenses du mois
Planning	Mes horaires · Équipe
Historique ventes	Ventes du jour (serveuse)
Paramètres	Profil · Accès · Sauvegarde · Correction · Admin

Sélecteur de maquis en haut. Rôles : serveuse, gérant, manager, admin, super admin — menus masqués = droits insuffisants.

3. Tableau de bord

• CA, charges, bénéfice estimé, nombre de ventes ; graphiques catégorie / paiement.
• Imprimer le point : récap période.
• Casiers physiques et suggestions réappro.
• Plus / moins vendues (bouteilles).
• Alertes stock → proposer commande / brouillon achats.
• Export Excel ventes + charges : Paramètres → Profil (période).

4. Point du jour

Onglets Synthèse, Clôture, Ventes pour la journée comptable (date PDJ en haut).

Synthèse : CA, remises, paiements, boissons vendues, détail ventes. Impression selon profil.

Clôture et vérification stock

1. Ouverture caisse (si activée) + snapshot stock.
2. Vérification stock : théorique = ouverture + achats du jour − ventes − pertes ; comparer au physique (frigo/réserve).
3. Caisse clôture vs théorique (ventes espèces, recouvrements, avoirs émis…).
4. Clôturer (gérant/admin) ou Fin de service (serveuse).
5. Imprimer le rapport de clôture.

Admin : réouverture journée clôturée (stock physique non recalculé auto). Super admin : date « journée à traiter » pour corriger une date passée.

5. Ventes

Commandes

Lignes article, format, quantité, Intérieur/Extérieur. Bouton + = nouvelle commande.

Caisse & Paiement

Historique ventes (Du/Au, impression). Volets Recouvrement, Avoirs clients, bloc Remplacer un article.

Avoirs clients & recouvrement

Recouvrement : encaisser un crédit client (versement tracé). Espèces → théorique caisse du jour.

Avoirs : monnaie gardée chez vous → solde client ; paiement futur en mode Avoir client.

Remplacer un article encaissé

Factures de la journée comptable : choisir facture, Remplacer sur une ligne, confirmer. Stock et montant realignés ; supplément à encaisser si prix supérieur.

Consignes

Reliquat payé ou consigne bouteille (décocher « Reliquat payé… »). Indicateurs et actions : rendu, servi, remboursé, suppr.

QR Codes

Impression Intérieur / Extérieur ; commandes scan.

6. Stock — catalogue & achats

Catalogue

Frigo, réserve, seuils, formats. Perte (confirmation), Excel import/export, Imprimer, filtres.

Achats fournisseurs

Commande → En attente → Réceptionner (quantités livrées, ranger casiers). Une charge Approvisionnement par réception. Créer casiers vides… si besoin.

Créanciers

Dettes fournisseurs ; crédit fournisseur.

Inventaire (période)

Onglet Inventaire (gérant/manager) : Du/Au, Afficher, Imprimer. Colonnes : stock début, achats, ventes, pertes, écarts inexpliqués, stk fin (th.), stk réconcilié, stk actuel (ligne jaune si écart).

Mouvements

Journal + filtre Type (Entrées/Sorties). Imprimer par article : synthèse selon le filtre.

Gestion casiers

Parc physique, statuts, mouvements, export CSV. Lié au tableau de bord et aux réceptions fournisseur.

7. Charges

Saisie manuelle (+) ou automatique à la réception fournisseur. Suppr. : admin avec confirmation.

8. Planning

Mes horaires ; Équipe (gérant) : créneaux, rotation automatique. Jour de repos = ventes bloquées ce jour.

9. Historique ventes (serveuse)

Ventes du jour pour le compte connecté ; impression période.

10. Paramètres

• Profil : maquis, objectif CA, export Excel, mot de passe
• Catégories · Accès (utilisateurs, 2FA, WhatsApp)
• Sauvegarde · Administration (audit, secours)

Correction de facture

Onglet Correction : n° facture → corriger paiement ou quantités (motif obligatoire, sans annuler la facture). Historique des corrections en bas de page. Recalcule fiche PDJ clôturée si besoin.

11. Téléphone

• Barre du bas + menu Plus.
• Tableaux : défilement horizontal.
• Modales plein écran défilables.

12. Bonnes pratiques

1. Catalogue stock à jour avant ventes et achats.
2. Réceptionner avec quantités réelles (une charge par réception).
3. Clôturer chaque journée (stock + caisse).
4. Vérifier le maquis actif en multi-sites.
5. Correction de facture plutôt que retouches manuelles après clôture.
6. Exporter / sauvegarder régulièrement.
7. Ctrl+F5 après mise à jour.

13. En cas de problème

• Session expirée : reconnectez-vous.
• Renouvellement mensuel : changez le mot de passe (1^er du mois).
• 2FA obligatoire : Paramètres → Accès.
• Charge doublon fournisseur : supprimer le doublon (admin) ; nouvelles réceptions protégées.
• Écart stock : Inventaire + clôture (achats du jour inclus).
• Import Excel : en-têtes identiques à l'export.
• Casiers vides : création rapide depuis l'achat.
• Scripts obsolètes : Ctrl+F5 ; redémarrer le serveur si server.py a changé.