Modèle métier
Les mots de Mon Chai, et ce qu'un développeur doit savoir pour construire sa brique à côté.
Mon Chai suit le vin de la vigne à la facture, et la douane au passage. Votre brique n'a pas besoin de tout connaître ; elle a besoin de parler la même langue que Mon Chai sur ce qu'elle touche. Le tableau final dit où chaque notion apparaît dans le connecteur et dans les imports.
Exploitation (domaine, structure)
L'entreprise viticole : un domaine, un château, une cave. Toutes les données de Mon Chai appartiennent à une exploitation et à une seule ; deux exploitations ne voient jamais les données l'une de l'autre. Une personne peut être membre de plusieurs exploitations, avec un rôle dans chacune (propriétaire, administrateur, éditeur, lecture seule) et des droits détaillés par module. Un accès du connecteur vaut pour une exploitation, au nom d'une personne, et ne voit que ce que cette personne voit.
Parcelle
Une pièce de vigne : nom, surface en hectares, commune, lieu-dit, référence cadastrale, encépagement. Les cépages et les appellations sont des référentiels propres à chaque exploitation.
Vendange
La récolte d'une parcelle (ou d'une partie) à une date, reçue au chai — en kilos ou en litres — et dirigée vers un ou plusieurs lots techniques. C'est le point de départ de la traçabilité.
Lot technique
Le vin en vrac, en cours d'élaboration : un volume en litres, dans un ou plusieurs contenants (cuves, fûts), qui vise une cuvée. Il naît des vendanges, change par les opérations de chai (assemblage, soutirage, pertes…) et finit en bouteilles à la mise. Chaque mouvement est tracé. Dans le connecteur : le stock « vrac ».
Cuvée
Le vin tel que vous le nommez et le vendez (« Les Silex ») : couleur, appellation, encépagement, éléments de dégustation. Un lot technique vise une cuvée ; un lot commercial en porte une, avec son millésime.
Référence (produit)
L'article du catalogue que l'on vend ou achète : une référence unique dans
l'exploitation (VOU-BLC-75), un libellé, un prix hors taxe, un taux
de TVA, une unité, une contenance. Les grilles tarifaires donnent des prix par
référence, éventuellement à partir d'une quantité.
Lot commercial
Des bouteilles prêtes à vendre, issues d'une mise : une cuvée, un millésime, un format (en millilitres : 375, 750, 1500…), une quantité. Le stock en bouteilles de Mon Chai est fait des lots commerciaux (plus l'inventaire de négoce).
Document commercial
Devis, commande, bon de livraison, facture, avoir — côté vente ou côté achat, avec un statut (brouillon, envoyé, validé, émis, payé, annulé). Une facture émise est définitive : elle reçoit un numéro et ne se modifie plus ; on la corrige par un avoir. Le « reste dû » d'une facture est son total TTC moins les règlements et les avoirs imputés.
DRM
La déclaration récapitulative mensuelle des mouvements de vin, due à la douane par les entrepositaires agréés. Mon Chai la calcule à partir des mouvements enregistrés (entrées, sorties, mises, pertes) et produit les fichiers de dépôt. Elle n'est pas exposée au connecteur : ne la recalculez pas de votre côté, laissez Mon Chai la tenir.
Où chaque notion apparaît
| Notion | Connecteur (lecture) | Import CSV (écriture) |
|---|---|---|
| Exploitation | contexte_connexion | — |
| Parcelle, cépage, appellation | — | parcelle, cépage, appellation |
| Lot technique (vrac) | stock_vrac, stock_resume | — |
| Cuvée | stock_par_cuvee | cuvée |
| Référence (produit), tarif | — | produit, tarif |
| Lot commercial | stock_par_cuvee, stock_par_format | — |
| Client | nom du client dans les factures | client |
| Document commercial | factures_lister, facture_detail, factures_impayees, chiffre_affaires | — |
| DRM | — | — (voir exports) |
Cinq règles pour votre brique
- Mon Chai reste la source de vérité pour les stocks, les factures et la DRM : lisez-les, ne les recalculez pas.
- Désignez les choses par leurs clés métier (référence produit, numéro de facture, nom de cuvée) : les identifiants internes ne sont pas exposés et peuvent changer.
- Unités : volumes en litres, formats de bouteille en
millilitres, surfaces en hectares, montants en euros sous forme de chaînes
décimales (
"125.50"). - Dates au format
AAAA-MM-JJ, en heure de Paris (« aujourd'hui » et « échue » se jugent à l'heure française). - Une facture émise ne bouge plus : si votre application garde une copie, elle n'a pas à la resynchroniser, seulement à suivre ses règlements et ses avoirs.