1. Vue d'ensemble

Stock Control & POS est une application de gestion pour boutiques, dépôts et pharmacies. Elle réunit en un seul outil :

2. Comment l'application est conçue

Trois idées structurent toute l'application. Les comprendre suffit à comprendre le reste.

① Tout appartient à une « Entreprise »

L'application est multi-entreprise : chaque donnée (produit, vente, client, dépense…) appartient à une entreprise. Un utilisateur ne voit jamais les données d'une autre entreprise. Dans votre installation, l'entreprise est Hema Enterprise.

② Le stock vit dans des « Emplacements »

Le stock n'est pas global : il est rattaché à des emplacements. Typiquement un dépôt (warehouse) qui reçoit la marchandise, et une ou plusieurs boutiques qui vendent. La marchandise passe du dépôt aux boutiques via des transferts.

③ Chaque utilisateur a un « Rôle » (et souvent un emplacement)

Le rôle détermine ce que l'utilisateur peut faire (le menu visible, les pages autorisées). L'emplacement assigné détermine ce qu'il voit (un caissier ne voit que les données de sa boutique, tandis qu'un gérant voit toute l'entreprise).

Le principe central : la vente met à jour le stock automatiquement

Quand une vente est enregistrée, l'application crée automatiquement les mouvements de stock correspondants et diminue les quantités — sans intervention manuelle. C'est le cœur du système (voir §15).

3. La connexion (point de départ)

4. Les rôles & leurs sessions

L'application définit 8 rôles. Pour chacun, vous trouvez sa raison d'être, puis la liste de ses fonctionnalités.

5. L'accueil, adapté à chaque rôle

Après connexion, tous les rôles arrivent sur la même page d'accueil /, mais les informations affichées dépendent du rôle et de l'emplacement :

6. La navigation : qui voit quel menu

Le menu principal s'adapte automatiquement. Voici chaque entrée du menu et les rôles qui la voient.

7. Vendre — la Caisse (POS)

La Caisse est l'écran de vente au comptoir : on remplit un panier, on choisit le paiement, on valide, et le stock se met à jour tout seul.

L'écran de la Caisse — 2 zones

Faire une vente, étape par étape

1. Ajouter des produits : cliquez un bouton rapide, ou tapez dans la recherche (ex. « Coca ») puis cliquez le produit. Il tombe dans le panier.
2. Régler les quantités avec les boutons + / − (ou en tapant le nombre). ⚠️ On ne peut pas dépasser le stock disponible : au maximum, le message « Quantité maximale atteinte » s'affiche.
3. Retirer un article (icône corbeille) ou Vider le panier si besoin. Le sous-total se recalcule en direct.
4. Choisir le client (facultatif) : « Client Anonyme » par défaut, ou un client de la liste. Vous pouvez en créer un nouveau sur place avec le bouton +.
5. Choisir le mode de paiement (voir ci-dessous).
6. Cliquer Valider la Vente (ou la touche F12). Le reçu peut être imprimé / téléchargé en PDF.

Les 4 modes de paiement

Ce qui se passe automatiquement à la validation

• Le stock baisse tout seul dans la boutique du caissier (visible dans Stock et Emplacements).
• La vente alimente la page Mes Ventes et les Rapports.
• Les ventes en espèces sont rattachées à la session de caisse ouverte (voir §12).

« Mes Ventes » — le tableau de bord du caissier

Menu Mes Ventes : suivez votre activité commerciale.

• Totaux des ventes du jour / semaine / mois.
• Répartition par mode de paiement et meilleurs produits.
• Ventes par heure (heures d'affluence) et liste des ventes récentes.

8. Gérer le stock

Pour les rôles « stock » : gestionnaire de stock, gestionnaire dépôt/boutique, gérant, admin/propriétaire.

Entrée de stock

1. Aller dans Stock puis Entrée de Stock.
2. Rechercher et sélectionner le produit dans la liste déroulante (champ de recherche). Si le catalogue est vide, l'écran invite à créer d'abord un produit.
3. Saisir la quantité, le coût unitaire, et choisir l'emplacement.
4. Indiquer la raison (achat, retour client, correction, stock initial, transfert entrant…).
5. Enregistrer : la quantité en stock de l'emplacement augmente immédiatement.

Le tableau de bord du Stock

La page Stock donne une vue d'ensemble avec 4 indicateurs cliquables en haut, des résumés mensuels, et des graphiques. Voici les 3 notions clés à comprendre :

Comment chaque chiffre est calculé

Voir ces cas dans la démo

Dans la démo, deux exemples ont été créés à la Boutique Centre pour que vous puissiez les observer :

1. Un produit a été ramené sous son seuil → il apparaît dans Stock Faible (carte jaune + liste « Alertes Stock Faible »).
2. Un produit a été ramené à zéro → il apparaît dans Rupture de Stock (carte rouge + liste « Rupture de Stock »).
3. Toutes les opérations (entrées initiales, transferts, ventes) sont visibles dans le graphique Mouvements (14 jours) et dans Mouvements Récents.

9. Transferts entre emplacements

Permet de déplacer la marchandise, typiquement du dépôt vers une boutique. Géré par le gestionnaire dépôt/boutique, le gérant, l'admin/propriétaire.

1. Créer un transfert : emplacement source, emplacement destination, et la liste des produits + quantités.
2. Envoyer le transfert : la marchandise quitte la source (statut « envoyé »).
3. À l'arrivée, la boutique reçoit le transfert : le stock de la destination augmente.
4. Un transfert peut être annulé tant qu'il n'est pas finalisé.

10. Clients & crédits

Accessible aux rôles commerciaux et comptables.

• Fiches clients : créer, modifier, activer/désactiver ; coordonnées, plafond de crédit, historique d'achats.
• Crédits : lorsqu'une vente est payée « à crédit », une dette est créée pour le client.
• Paiements : enregistrer les règlements partiels ou totaux ; l'historique des paiements est conservé.

11. Dépenses

Pour suivre les charges (loyer, électricité, salaires, transport…). Rôles : admin, propriétaire, gérant, gestionnaire boutique, comptable.

1. Définir des catégories de dépenses (réutilisables).
2. Créer une dépense : catégorie, description, montant, date, mode de paiement.
3. Consulter, modifier ou supprimer les dépenses ; elles alimentent les rapports financiers.

12. Sessions de caisse

Pour contrôler l'argent physique du tiroir-caisse. Rôles : caissier, gestionnaire boutique, gérant, comptable, admin/propriétaire.

1. Ouvrir une session en début de journée avec le fond de caisse initial.
2. Les ventes en espèces de la journée sont rattachées à la session.
3. Clôturer en fin de journée : on saisit le montant compté ; l'app calcule l'écart avec le montant attendu.

13. Rapports & exports

Tableau de bord d'analyse pour admin, propriétaire, gérant et comptable.

• Indicateurs : ventes du jour / semaine / mois, tendances, répartition par mode de paiement, ventes par heure, meilleurs produits.
• Exports disponibles : ventes, inventaire, dépenses, clients.

14. Produits & utilisateurs (administration)

Réservé à admin, propriétaire et gérant.

• Produits : catalogue (créer/modifier/désactiver), avec catégories, prix d'achat/vente, seuil de stock minimum, unité.
• Utilisateurs : créer les comptes des employés, leur attribuer un rôle et un emplacement, activer/désactiver.

🎬 Démo guidée — Dépôt 500 → 3 boutiques

Un parcours pas à pas, simple à suivre, pour comprendre toute la logique : la marchandise arrive au dépôt, se distribue vers les boutiques, puis se vend et le stock baisse tout seul.

🗺️ Le décor de la démo

L'entreprise Hema Enterprise possède 4 emplacements :

Étape 1 — Se connecter en Patron

1. Ouvrez l'application et cliquez sur le bouton rapide « Patron » (ou tapez admin / admin123), puis Se connecter.
2. Vous arrivez sur l'accueil : ventes du jour, alertes de stock, etc. Le menu en haut donne accès à toutes les sections.

Étape 2 — Regarder les emplacements

1. Menu Emplacements. Vous voyez une section Dépôts (Dépôt Principal) et une section Boutiques (Centre, Nord, Sud).
2. Cliquez sur Dépôt Principal → bouton Voir Stock : la liste des 27 produits avec leurs quantités.
3. 👉 À retenir : le dépôt et chaque boutique ont leur propre stock, séparé.

Étape 3 — Voir le catalogue de produits

1. Menu Produits : la liste des articles (ex. Coca-Cola 50cl, Riz Thai 5kg, Savon Lux 175g, Sucre 1kg…), chacun avec un prix d'achat et un prix de vente.
2. Un produit doit exister ici avant de pouvoir entrer du stock ou le vendre.

Étape 4 — Faire entrer du stock au dépôt

C'est l'arrivée de la marchandise (achat fournisseur). Exemple complet avec un produit :

1. Menu Stock → bouton Entrée de Stock.
2. Dans Produit, tapez « Coca » dans la recherche puis cliquez sur Coca-Cola 50cl.
3. Quantité : 500 · Coût unitaire : ex. 800 · Emplacement : Dépôt Principal · Raison : Stock Initial.
4. Cliquez Enregistrer l'entrée.
5. ✅ Résultat : le stock de Coca-Cola 50cl au Dépôt Principal passe à 500. (Dans la démo, c'est déjà fait pour les 27 produits.)

Étape 5 — Créer un transfert vers la Boutique Centre

On envoie une partie du stock du dépôt vers une boutique.

1. Menu Transferts → bouton Nouveau Transfert.
2. Emplacement source : Dépôt Principal.
3. Emplacement destination : Boutique Centre.
4. Ajoutez les produits à envoyer et leur quantité (ex. 50 pour Coca-Cola 50cl, 50 pour les autres…).
5. Cliquez Créer. Le transfert est en statut Brouillon.

Étape 6 — Envoyer puis recevoir le transfert

1. Ouvrez le transfert créé. Cliquez Envoyer → statut En transit : le stock quitte le Dépôt Principal.
2. Cliquez ensuite Recevoir → statut Reçu : le stock arrive à la Boutique Centre.
3. ✅ Résultat : Boutique Centre = 50 par produit ; Dépôt Principal a diminué d'autant.

Étape 7 — Répéter pour Boutique Nord et Boutique Sud

1. Refaites les Étapes 5 et 6 avec la destination Boutique Nord, puis encore avec Boutique Sud (50 par produit à chaque fois).
2. 👉 Au total, 3 transferts de 50 = 150 unités par produit quittent le dépôt.

Étape 8 — Vérifier le stock partout

1. Menu Emplacements → Dépôt Principal → Voir Stock : 350 par produit (500 − 3×50).
2. Ouvrez Boutique Centre / Nord / Sud → Voir Stock : 50 par produit chacune.

Étape 9 — Vendre en boutique (Caisse)

1. Déconnectez-vous, puis connectez-vous en Caissier (cashier / cashier123).
2. Menu Caisse. Cliquez un produit populaire ou recherchez « Coca » pour l'ajouter au panier.
3. Réglez la quantité (ex. 5). Choisissez le paiement Espèces.
4. Cliquez Valider / Encaisser. Le reçu peut être imprimé.

Étape 10 — Constater la baisse du stock

1. Reconnectez-vous en Patron (admin).
2. Menu Emplacements → la boutique où vous avez vendu → Voir Stock.
3. ✅ Le produit vendu est passé de 50 à 45 : la vente a diminué le stock automatiquement, sans saisie manuelle.

Étape 11 — Lire les rapports

1. En Patron / Gérant / Comptable : menu Rapports → ventes du jour, tendances, meilleurs produits, état du stock par emplacement.
2. Menu Stock → vue globale. Les chiffres concordent entre Stock, Emplacements et Rapports.

15. Schéma de circulation des données

Le mécanisme automatique le plus important : la vente met à jour le stock.

En parallèle, si la vente est à crédit, la dette du client est mise à jour. Les entrées de stock (achats, transferts entrants) suivent le chemin inverse et augmentent les quantités.

16. Matrice des accès (synthèse)

Vue d'ensemble : ✓ = accès à la section.

Note : « Clients » est en lecture pour le caissier et le comptable ; la création/modification de clients est réservée aux rôles de gestion.

17. Comptes de connexion (test)

Comptes fournis pour explorer chaque session. Ils correspondent aux boutons de connexion rapide.