Produits

Le catalogue produits répertorie les articles que votre cybercafé ou centre de jeux vend. Cela inclut la nourriture, les boissons, les snacks, les accessoires et tout autre bien physique proposé aux clients. Chaque produit possède un prix défini, une catégorie, un taux de taxe et un niveau de stock. Les produits s'intègrent au système de commandes, permettant aux caissiers de créer des commandes, suivre les ventes et gérer le stock.

Les produits sont gérés dans l'onglet Produits de la page Stock de la navigation principale. L'onglet propose une vue tableau et une vue grille. Les cartes de la grille affichent la photo du produit, le prix et un badge En stock ou En rupture.

Champs du produit

Chaque enregistrement de produit contient les informations suivantes :

Champ	Description
`name`	Le nom du produit affiché dans l'interface de commande. Doit être unique (insensible à la casse).
`category`	Un libellé de texte regroupant les produits apparentés (par exemple "Boissons", "Snacks", "Accessoires"). Utilisé pour le filtrage et les rapports.
`unit`	L'unité de mesure pour le suivi des stocks (par exemple "pièce", "kg", "litre", "canette", "bouteille").
`barcode`	Un code-barres facultatif pour l'intégration avec un scanner. Les caissiers peuvent scanner le code-barres d'un produit pour l'ajouter rapidement à une commande.
`sale_price`	Le prix de vente en unités monétaires mineures (par exemple les centimes). C'est le montant facturé au client par unité.
`vat_rate`	Le taux de TVA (Taxe sur la Valeur Ajoutée) appliqué à ce produit (par exemple 18 pour 18 % de TVA). Utilisé pour calculer la composante fiscale de chaque vente.
`stock`	Le niveau de stock actuel sous forme de quantité décimale. Mis à jour automatiquement lors du passage de commandes et lors de l'enregistrement de réceptions de stock. Le stock ne se modifie pas sur le produit lui-même. Utilisez l'onglet Statut du Stock de la page Stock.
`min_stock`	Le seuil de réapprovisionnement. Lorsque le niveau de stock atteint cette valeur ou passe en dessous, le produit est signalé comme critique dans l'onglet Statut du Stock. Zéro signifie aucun seuil.
`description`	Une description textuelle facultative pour des détails supplémentaires sur le produit.
`photo`	Une photo de produit facultative affichée dans la vue grille et dans le menu de la cafétéria.

Retirer un produit de la vente

Un produit qui ne doit plus être proposé se retire avec l'action Retirer de la vente de l'onglet Produits. Une confirmation explique que cela supprime le produit du catalogue et ne peut pas être annulé. Les commandes passées qui incluaient le produit conservent leurs instantanés de ligne, de sorte que les données historiques de ventes sont préservées.

Suivi des stocks

HandyCafe maintient un décompte de stock en continu pour chaque produit. Cette valeur est mise à jour automatiquement par le système en réponse à :

Ventes : lorsqu'un produit est vendu via une commande, le stock diminue de la quantité commandée.
Réceptions de stock : lorsque du nouveau stock est reçu et enregistré dans l'onglet Réception de Stock de la page Stock, le stock augmente en conséquence.
Ajustements manuels : l'onglet Statut du Stock propose les actions Corriger le stock, Perte et Inventaire pour tenir compte des pertes, de la casse, des erreurs de comptage ou d'autres écarts.

Le stock ne peut pas être modifié dans l'éditeur de produit. Tous les changements de stock passent par l'onglet Statut du Stock, afin que chaque changement soit consigné dans l'historique des mouvements.

Journal de stock produit

Chaque modification du niveau de stock d'un produit est enregistrée dans le journal de stock produit, créant une piste d'audit complète :

Raison	Description
`sale`	Stock diminué suite à une commande client. Lié à l'enregistrement de commande spécifique.
`purchase`	Stock augmenté suite à un achat d'inventaire. Lié à l'entrée d'inventaire spécifique.
`adjustment`	Stock ajusté manuellement par un caissier ou un administrateur.
`waste`	Stock diminué suite à une perte, de la casse ou une radiation.
`return`	Stock augmenté suite à un retour client ou à l'annulation d'une commande.

Chaque entrée du journal enregistre le changement de quantité (positif pour les augmentations, négatif pour les diminutions), le nouveau niveau de stock après le changement, qui a effectué le changement et une note facultative expliquant la raison.

Catégories de produits

Les produits sont regroupés par catégorie à l'aide d'un champ texte libre. Les catégories courantes incluent :

Boissons (boissons gazeuses, eau, boissons énergisantes)
Boissons chaudes (café, chocolat chaud)
Snacks (chips, bonbons, barres chocolatées)
Nourriture (sandwichs, wraps, plats chauds)
Accessoires (casques, clés USB, tapis de souris)

Les catégories sont utilisées pour le filtrage dans l'interface de commande. Les caissiers peuvent rapidement passer d'une catégorie à l'autre pour trouver le bon produit. Les catégories servent également au regroupement dans les rapports de ventes.

Il n'y a pas d'interface de gestion de catégories séparée. Les catégories sont créées implicitement lorsque vous assignez un nom de catégorie à un produit. Pour renommer une catégorie, mettez à jour le champ catégorie de tous les produits utilisant l'ancien nom.

Créer un produit

Pour ajouter un nouveau produit au catalogue :

Ouvrez la page Stock depuis la barre latérale et passez à l'onglet Produits.
Cliquez sur le bouton Nouveau produit.
Saisissez le nom (doit être unique).
Sélectionnez ou saisissez une catégorie.
Choisissez l'unité de mesure.
Définissez le prix de vente (le montant facturé aux clients).
Définissez le taux de TVA.
Saisissez éventuellement un code-barres pour la prise en charge du scanner et ajoutez une photo.
Cliquez sur Enregistrer.

Le stock initial ne se définit pas ici. Enregistrez la quantité de départ avec une réception de stock ou l'action Inventaire de l'onglet Statut du Stock. Un produit peut également être créé directement depuis une ligne de réception lorsqu'une livraison contient un article qui ne figure pas encore au catalogue.

Modifier un produit

Sélectionnez un produit dans la liste pour ouvrir son éditeur. Vous pouvez mettre à jour n'importe quel champ, y compris le nom, le prix, la catégorie, le taux de TVA, le code-barres et la photo. Les modifications prennent effet immédiatement. Si vous mettez à jour le prix, le nouveau prix s'applique à toutes les commandes futures. L'action Retirer de la vente supprime le produit du catalogue après une confirmation.

Les commandes passées ne sont pas affectées par les changements de prix. Chaque article de commande stocke le unit_price au moment de la vente sous forme d'instantané.

Intégration avec les commandes

Lorsqu'un caissier crée une commande et ajoute un produit :

Le prix de vente actuel du produit et le taux de TVA sont copiés dans l'article de commande sous forme d'instantanés.
Le total de la ligne est calculé comme prix_unitaire * quantité.
Lorsque la commande est complétée, le niveau de stock du produit est décrémenté de la quantité commandée.
Une entrée de journal de stock est créée avec raison = 'sale' liée à la commande.

Si la commande est ultérieurement annulée ou remboursée, le stock peut être restauré via une entrée de journal de stock de retour.