Produits

La page Produits gere le catalogue des articles que votre cybercafe ou centre de jeux vend. Cela inclut la nourriture, les boissons, les snacks, les accessoires et tout autre bien physique propose aux clients. Chaque produit possede un prix defini, une categorie, un taux de taxe et un niveau de stock. Les produits s'integrent au systeme de commandes, permettant aux caissiers de creer des commandes, suivre les ventes et gerer l'inventaire.

Champs du produit

Chaque enregistrement de produit contient les informations suivantes :

Champ	Description
`name`	Le nom du produit affiche dans l'interface de commande. Doit etre unique (insensible a la casse).
`category`	Un libelle de texte regroupant les produits apparentes (par exemple "Boissons", "Snacks", "Accessoires"). Utilise pour le filtrage et les rapports.
`unit`	L'unite de mesure pour le suivi des stocks (par exemple "piece", "kg", "litre", "canette", "bouteille").
`barcode`	Un code-barres facultatif pour l'integration avec un scanner. Les caissiers peuvent scanner le code-barres d'un produit pour l'ajouter rapidement a une commande.
`sale_price`	Le prix de vente en unites monetaires mineures (par exemple les centimes). C'est le montant facture au client par unite.
`vat_rate`	Le taux de TVA (Taxe sur la Valeur Ajoutee) applique a ce produit (par exemple 18 pour 18 % de TVA). Utilise pour calculer la composante fiscale de chaque vente.
`stock`	Le niveau de stock actuel sous forme de quantite decimale. Mis a jour automatiquement lors du passage de commandes et lors de l'enregistrement d'achats d'inventaire.
`active`	Un interrupteur qui controle si le produit apparait dans l'interface de commande. Les produits inactifs sont masques pour les caissiers mais conserves dans la base de donnees pour les rapports historiques.
`description`	Une description textuelle facultative pour des details supplementaires sur le produit.

Basculement actif / inactif

Les produits peuvent etre bascules entre les etats actif et inactif :

Les produits actifs apparaissent dans l'interface de commande et peuvent etre ajoutes a de nouvelles commandes.
Les produits inactifs sont masques de l'interface de commande mais restent dans la base de donnees. Les commandes passees qui incluaient le produit conservent leurs references, de sorte que les donnees historiques de ventes sont preservees.

Cette fonction est utile pour les articles saisonniers, les produits discontinues ou les articles temporairement en rupture de stock qui ne doivent pas etre proposes aux clients.

Suivi des stocks

HandyCafe maintient un decompte de stock en continu pour chaque produit. Cette valeur est mise a jour automatiquement par le systeme en reponse a :

Ventes : lorsqu'un produit est vendu via une commande, le stock diminue de la quantite commandee.
Achats d'inventaire : lorsque du nouveau stock est recu et enregistre dans la page Inventaire, le stock augmente en consequence.
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 ecarts.

Journal de stock produit

Chaque modification du niveau de stock d'un produit est enregistree dans le journal de stock produit, creant une piste d'audit complete :

Raison	Description
`sale`	Stock diminue suite a une commande client. Lie a l'enregistrement de commande specifique.
`purchase`	Stock augmente suite a un achat d'inventaire. Lie a l'entree d'inventaire specifique.
`adjustment`	Stock ajuste manuellement par un caissier ou un administrateur.
`waste`	Stock diminue suite a une perte, de la casse ou une radiation.
`return`	Stock augmente suite a un retour client ou a l'annulation d'une commande.

Chaque entree du journal enregistre le changement de quantite (positif pour les augmentations, negatif pour les diminutions), le nouveau niveau de stock apres le changement, qui a effectue le changement et une note facultative expliquant la raison.

Categories de produits

Les produits sont regroupes par categorie a l'aide d'un champ texte libre. Les categories courantes incluent :

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

Les categories sont utilisees pour le filtrage dans l'interface de commande. Les caissiers peuvent rapidement passer d'une categorie a l'autre pour trouver le bon produit. Les categories servent egalement au regroupement dans les rapports de ventes.

Il n'y a pas d'interface de gestion de categories separee. Les categories sont creees implicitement lorsque vous assignez un nom de categorie a un produit. Pour renommer une categorie, mettez a jour le champ categorie de tous les produits utilisant l'ancien nom.

Creer un produit

Pour ajouter un nouveau produit au catalogue :

Rendez-vous sur la page Produits depuis la barre laterale.
Cliquez sur le bouton Ajouter un produit dans la barre d'outils.
Saisissez le nom (doit etre unique).
Selectionnez ou saisissez une categorie.
Choisissez l'unite de mesure.
Definissez le prix de vente (le montant facture aux clients, en unites monetaires mineures).
Definissez le taux de TVA (sous forme decimale, par exemple 0,08 pour 8 %).
Saisissez eventuellement un code-barres pour la prise en charge du scanner.
Definissez le niveau de stock initial si applicable.
Cliquez sur Enregistrer.

Modifier un produit

Selectionnez un produit dans la liste pour ouvrir sa vue de detail. Vous pouvez mettre a jour n'importe quel champ, y compris le nom, le prix, la categorie, le taux de TVA, le niveau de stock et le statut actif. Les modifications prennent effet immediatement. Si vous mettez a jour le prix, le nouveau prix s'applique a toutes les commandes futures.

Les commandes passees ne sont pas affectees par les changements de prix. Chaque article de commande stocke le unit_price au moment de la vente sous forme d'instantane.

Integration avec les commandes

Lorsqu'un caissier cree une commande et ajoute un produit :

Le prix de vente actuel du produit et le taux de TVA sont copies dans l'article de commande sous forme d'instantanes.
Le total de la ligne est calcule comme prix_unitaire * quantite.
Lorsque la commande est completee, le niveau de stock du produit est decremente de la quantite commandee.
Une entree de journal de stock est creee avec raison = 'sale' liee a la commande.

Si la commande est ulterieurement annulee ou remboursee, le stock peut etre restaure via une entree de journal de stock de retour.