tradon/modules/purchase_trade/docs_source/business/coffee.en.md

Coffee trading - samples and quality

Mirror page: coffee.md

BR-PT-COF-001 - Coffee sample phase 1

Status: active Source: project decision on 2026-06-29

Business rule

Coffee trading must track samples linked to purchase and sale lines.

Each sample stores:

• a sample type: offer, pre-shipment, shipment, arrival, stock, customer or retained;
• a purchase or sale direction;
• a lifecycle: requested, received, sent to lab, under review, approved, rejected, expired, archived;
• an expiry date computed from the request/receipt date and the sample shelf life;
• a simple cupping score and physical quality values.

purchase.line and sale.line store the target coffee quality specifications: origin, process, variety, crop year, screen size, maximum moisture, maximum defect count and minimum cup score.

Developer notes

• Models/fields:
  • coffee.sample
  • purchase.line.coffee_samples
  • sale.line.coffee_samples
  • coffee_* fields on purchase.line and sale.line
• Files:
  • modules/purchase_trade/coffee.py
  • modules/purchase_trade/coffee.xml
  • modules/purchase_trade/view/coffee_sample_*.xml
  • modules/purchase_trade/view/purchase_line_form.xml
  • modules/purchase_trade/view/sale_line_form.xml
• Caveats:
  • expiry is monitored through the Expired and Expiring soon domains;
  • phase 1 does not block shipment or contract validation;
  • lab delegation is a tracking field, not a complete lab workflow yet.