Produits

La page Produits gère le catalogue des 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 l'inventaire.

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 d'achats d'inventaire.
`active`	Un interrupteur qui contrôle si le produit apparaît dans l'interface de commande. Les produits inactifs sont masqués pour les caissiers mais conservés dans la base de données pour les rapports historiques.
`description`	Une description textuelle facultative pour des détails supplémentaires sur le produit.

Basculement actif / inactif

Les produits peuvent être basculés entre les états actif et inactif :

Les produits actifs apparaissent dans l'interface de commande et peuvent être ajoutés à de nouvelles commandes.
Les produits inactifs sont masqués de l'interface de commande mais restent dans la base de données. Les commandes passées qui incluaient le produit conservent leurs références, de sorte que les données historiques de ventes sont préservées.

Cette fonction est utile pour les articles saisonniers, les produits discontinués ou les articles temporairement en rupture de stock qui ne doivent pas être proposés aux clients.

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.
Achats d'inventaire : lorsque du nouveau stock est reçu et enregistré dans la page Inventaire, le stock augmente en conséquence.
Ajustements manuels : les caissiers ou administrateurs peuvent ajuster manuellement le niveau de stock pour tenir compte des pertes, de la casse, des erreurs de comptage ou d'autres écarts.

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 :

Rendez-vous sur la page Produits depuis la barre latérale.
Cliquez sur le bouton Ajouter un produit dans la barre d'outils.
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, en unités monétaires mineures).
Définissez le taux de TVA (sous forme décimale, par exemple 0,08 pour 8 %).
Saisissez éventuellement un code-barres pour la prise en charge du scanner.
Définissez le niveau de stock initial si applicable.
Cliquez sur Enregistrer.

Modifier un produit

Sélectionnez un produit dans la liste pour ouvrir sa vue de détail. Vous pouvez mettre à jour n'importe quel champ, y compris le nom, le prix, la catégorie, le taux de TVA, le niveau de stock et le statut actif. Les modifications prennent effet immédiatement. Si vous mettez à jour le prix, le nouveau prix s'applique à toutes les commandes futures.

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.