quantity_theorical
        |
        v
  lot virtuel P1  --->  lot.qt forecast  --->  lot physique
        ^                    |
        |                    v
        +------ recalcul après consommation

• Ligne achat : purchase.line
• Ligne vente : sale.line
• Lot : lot.lot
• Forecast : lot.qt
• Historique : lot.qt.hist
• Quantité métier achat : purchase.line.quantity_theorical
• Quantité métier vente : sale.line.quantity_theorical
• Compteur technique : quantity
• Ligne finie : purchase.line.finished, sale.line.finished
• Lot virtuel / physique : lot.lot.lot_type = virtual / physic
• Lien achat : lot.lot.line
• Lien vente : lot.lot.sale_line
• Forecast achat : lot.qt.lot_p
• Forecast vente : lot.qt.lot_s
• Quantité forecast : lot.qt.lot_quantity
• Weight basis : purchase.purchase.wb, sale.sale.wb
• État Weight basis : purchase.weight.basis.qt_type
• Packing : lot.lot.lot_qt, lot.lot.lot_unit
• Tolerances : tol_min, tol_max, tol_min_qt, tol_max_qt, tol_min_v, tol_max_v

• Achat : purchase.py, Line.validate
• Vente : sale.py, SaleLine.validate
• Si quantity_theorical est saisi et que quantity est vide ou zéro :
  • quantity est initialisée depuis quantity_theorical ;
  • seulement si aucun lot physique n'existe.
• Si la ligne est éligible :
  • pas created_by_code ;
  • pas encore de lot ;
  • produit non service ;
  • quantity_theorical != 0 ;
  • création d'un lot virtual.
• Le lot virtuel reçoit une première entrée lot.qt.hist.
• Lot.validate crée le lot.qt ouvert via createVirtualPart.

• Achat : purchase.py, Line.write
• Vente : sale.py, SaleLine.write
• Cible lot virtuel :

target_quantity = quantity_theorical - somme(lots physiques convertis)

• Si target_quantity < 0 :
  • blocage : Please unlink or unmatch lot.
• Cible lot.qt libre :

free_quantity = target_quantity - somme(lot.qt déjà matchés ou shippés)

• Si free_quantity < 0 :
  • blocage : Please unlink or unmatch lot.
• Si un lot.qt libre existe :
  • sa quantité est remplacée.
• Si aucun lot.qt libre n'existe et free_quantity > 0 :
  • création d'un nouveau lot.qt.
• Les fees de ligne sont resynchronisés.

• Wizard : lot.add
• Méthodes :
  • LotQt.add_physical_lots
  • LotQt.add_physical_lot
• Source obligatoire : une ligne lot.qt.
• Ajout direct depuis un lot physique refusé.
• Ajout physique côté vente par ce wizard refusé : utiliser Apply matching.
• Le lot physique reprend :
  • ligne achat ;
  • vente matchée si présente ;
  • shipment ;
  • produit ;
  • unité ;
  • quantités ;
  • premium ;
  • chunk key.
• Après création :
  • réduction de la ligne lot.qt source ;
  • pas de quantité lot.qt négative ;
  • recalcul du lot virtuel ;
  • recalcul de quantity ;
  • mise à jour moves et fees si nécessaire.

• Wizard : lot.remove
• Lot ouvert : retrait interdit.
• Lot avec stock.move :
  • move obligatoire en draft.
• Lot matché ou shippé :
  • warning confirmable.
• Effets :
  • suppression du move draft ;
  • restauration de la quantité dans lot.qt ;
  • contexte restauré via shipment, getVlot_p(), getVlot_s() ;
  • recalcul lot virtuel, quantity, fees.

• Wizard : lot.weighing
• Action UI : Do weighing
• Écrit ou met à jour lot.qt.hist.
• Peut mettre à jour lot_state.
• Synchronise :
  • lot ;
  • quantités ouvertes ;
  • fees.
• Les vues lot.qt.hist sont consultatives.

• Méthode : Lot._recalc_line_quantity
• Sans physique :
  • quantity suit le lot virtuel.
• Avec physiques :
  • quantity somme uniquement les lots physiques.
• quantity est readonly côté ligne trade.

• Achat : purchase.line.on_change_with_amount()
• Vente : sale.line.on_change_with_amount()
• Helper :
  • _get_amount_quantity()
  • _get_weight_basis_quantity()
• Priorités :
  • finished = False : quantity_theorical
  • finished = True + Weight basis disponible : somme physique dans cet état
  • finished = True sans Weight basis exploitable : quantity
  • fallback legacy : quantity si quantity_theorical vide

• Check central :
  • lot.lot.assert_lines_quantity_consistency()
• Blocage lot.qt orphelin non zéro :
  • lot.qt.validate
• Appels après :
  • modification quantity_theorical ;
  • création / suppression de lots physiques ;
  • matching / unmatching ;
  • shipping / unshipping ;
  • weighing.

• Script :
  • sql/quantity_consistency_checks.sql
• Usage :
  • audit des bases de test ;
  • audit des données historiques ;
  • qualification avant correction.
• Le script ignore totalement les lot.qt = 0.

• modules/purchase_trade/tests/test_module.py
• Couverture existante :
  • quantity readonly ;
  • initialisation depuis quantity_theorical ;
  • protection si lots physiques ;
  • amount sur théorique / physique / Weight basis ;
  • resynchronisation des lots virtuels ;
  • blocages quand l'open ne suffit plus.
• Tests à ajouter :
  • lot_hist readonly ;
  • Do weighing crée ou met à jour un état ;
  • lot virtuel sans saisie directe lot_qt / lot_unit ;
  • contrôles SQL rejoués sur jeux de données incohérents.