The Roast Production Module is a comprehensive coffee roasting production management system designed for coffee roasteries. This module integrates the entire business process, from production planning and roasting execution to quality control (cupping), documentation, and reporting.
Core Functions of the Roast Production Module
This module is designed to support the following functions:
- Production Planning Management – Plan roasting batches with detailed configurations, including beans, profiles, machines, and operators.
- Profile Management – Store and manage roasting profiles (temperature curves and time data) to ensure consistent quality.
- Quality Control – Conduct cupping sessions based on COE/SCA standards to evaluate roast quality.
- Equipment Tracking – Monitor roasting machine usage and maintain maintenance logbooks.
- Data Analytics – Provide insights into popular beans, roast levels, and machine utilization.
- Multi-device Integration – Synchronize data with the Flutter-based Clorofile App for on-site operators.
- Inventory Integration – Automatically deduct green bean stock from the warehouse once roasting is completed.
1. 🗓️ Production Plan (Main Menu)
Primary Functions
-
Roasting Batch Planning – Create roasting schedules with automatically generated batch numbers (format: CL001, CL002, etc.).
Planning Details Include
- Batch Number – Auto-generated unique ID (format: CL###)
- Profile Reference – Reference an existing roasting profile
- Custom Profile Name – Define a new profile name if no reference is used
- Bean Selection – Select up to four types of green beans (from master items)
- Bean Weight – Weight per bean (supports Kg/Lb units)
- Origin – Coffee origin (Ethiopia, Colombia, Brazil, etc.)
- Roast Level – Roast level (Light, Medium, Dark, etc.)
- Machine – Select the roasting machine
- Operator – Assign the operator
- Planned Date & Time – Roasting schedule
Business Workflow
- Created – Production plan created by staff/admin
- Assigned – Operator assigned
- In Progress – Operator starts roasting via the Flutter app
- Completed – Roasting completed; curve data saved to the Profile Library
- Declined – Batch rejected with a recorded reason
- Cancelled – Batch cancelled
Key Features
- Row-level Security – Non-admin users can only view batches they created or operate
- Status Tracking – Visual status badges (Planned / In Progress / Completed / Cancelled / Declined)
- Auto Synchronization – Status automatically synced from the Profile Library (completed date)
- Bean Inventory Sync – Green bean stock automatically reduced upon batch completion
2. 📚 Profile Library
Primary Functions
- Central repository for all historical roasting profiles
- Storage of temperature curve data in CSV format (time, temperature, power, fan speed, drum speed, air pressure)
- Profile visualization through temperature curve charts
- Profile comparison for consistency analysis
- Export and import profiles in CSV format
Stored Data
- Basic Information – Batch number (reference to roast_production ID), profile name, operator
- Bean Data – Up to four bean slots with name, weight, and unit
- Machine Data – Machine name and capacity
Roasting Metrics
- CHARGE – Start time of roasting
- DRY – End of drying phase
- FC (First Crack) – First audible crack
- SC (Second Crack) – Second crack (optional)
- DROP – End of roasting
- COOL – End of cooling
- Temperature Curve – CSV data (time, temperature, power, fan, drum, air)
- Actual Roast Level – Final roast level
- Origin – Coffee origin
Timestamps
Created date, planned date/time, start date/time, and completed date/time.
Business Value
- Consistency – Operators can reuse proven profiles
- Quality Control – Compare planned versus actual results
- Learning Tool – Junior staff can learn from senior profiles
- Troubleshooting – Analyze failed batches by comparing curves
Statistics Dashboard
- Total profiles
- Most frequently roasted beans (by frequency and total weight)
- Most common roast levels
- Total roasting time
3. ☕ Cupping Session
Primary Functions
-
Create cupping events for quality evaluation of roasted coffee
Participant Management
- Internal Participants – Clorofile staff
- External Participants – Guest evaluators (non-Clorofile users)
- Auto-generated Credentials – External participants receive login credentials via email
Cupping Forms
- SCA (Specialty Coffee Association) – 100-point scale
- COE (Cup of Excellence) – Competition-grade form
Session Workflow
-
Open → In Progress → Done → Cancelled
Session Details
- Session ID – Format LOT### (LOT001, LOT002, etc.)
- Date & Time – Cupping schedule
- Participants – Invited staff list
- Evaluators – Assigned scorers
- Samples – One or multiple roasting batches
- Sheet Type – SCA or COE
Business Process
- Admin creates session and assigns participants
- System sends email invitations (including credentials for external users)
- Participants log in and accept invitations
- Evaluators submit scoring forms
- Results stored in the Cupping Library
- Admin analyzes and compares results
Special Features
- Dedicated cupping user roles
- Automatic external user account creation
- Session duplication for repeat cupping
- Participant status tracking (Accepted / Declined / Pending)
4. 📖 Cupping Library
Primary Functions
- Repository for all historical cupping results
- Quality trend analysis
- Descriptor frequency analysis (e.g., chocolate, fruity, floral)
- Quality benchmarking by batch, origin, and roast level
Stored Data
- Session Information – LOT ID, date, time, evaluator
- Sample Information – Roasted batch details
SCA / COE Scoring
Fragrance/Aroma, Flavor, Aftertaste, Acidity, Body, Uniformity, Clean Cup, Sweetness, Balance, Overall, Total Score (0–100)
Additional Data
- Descriptor notes
- Defect notes (if any)
Statistics Dashboard
- Total cupping sessions
- Most common descriptors
- Average score by origin
- Average score by roast level
- Best-performing batches
Business Value
- Quality Assurance – Track production consistency
- Product Development – Identify optimal beans and profiles
- Marketing Support – Use cupping scores for product descriptions
- Customer Trust – Transparent quality data shareable with customers
5. 📔 Machine Logbook
Primary Functions
- Track roasting machine usage
- Schedule maintenance based on usage hours
- Monitor production capacity per machine
- Analyze machine performance (batches per day, uptime, downtime)
Displayed Data
- Date range filter
- Machine name filter (multi-select)
- Processed batches
- Roasted beans
- Operators
- Used profiles
- Total processed weight
Reporting Features
- Usage summary (total roasting hours per machine)
- Batch count per machine
- Total processed weight (Kg/Lb)
- Pagination (50 records per page for performance optimization)
Business Value
- Preventive Maintenance – Schedule servicing before failures occur
- ROI Analysis – Evaluate machine productivity versus maintenance costs
- Capacity Planning – Identify underutilized or overutilized machines
- Equipment Lifecycle Management – Support upgrade and replacement decisions
6. ⚙️ Settings
Primary Functions
System configuration and master data management for the Roast Production Module.
Settings Categories
A. Unit Settings
- Weight Unit – Kg or Lb (applies system-wide)
- Temperature Unit – °C or °F (for roasting curves)
B. Machine Management
- Machine registration
- Auto-generated machine number (RM0001, RM0002, etc.)
- Machine name, brand, type, capacity, serial number
- Production year, location, status (Active/Inactive)
- Full CRUD operations (Create, Read, Update, Delete)
C. Bean Master Data
- Bean varieties (Arabica, Robusta, Liberica, Excelsa)
- Processing methods (Washed, Natural, Honey, Anaerobic, etc.)
- Origins (Ethiopia, Colombia, Brazil, Kenya, etc.)
- Roast levels (Light, Medium, Medium Dark, Dark, etc.)
Key Features
- Dynamic master data management
- Automatic unit conversion (Kg ↔ Lb)
- Automatic machine name synchronization across modules
Business Value
- Flexibility – Adaptable to different roastery operations
- Standardization – Consistent terminology across teams
- Scalability – Easy machine expansion without code changes
🔌 Integration Points
- Warehouse Module – Automatic green bean stock deduction
- Email System – Cupping invitations and notifications
- Staff Management – Operator assignment and access control
- Items Master – Bean catalog
- Clorofile Roasting Software – Roasting control, quality review, and analysis