Skip to main content

Production

The Production module is the heart of Qrema -- where green beans are transformed into roasted coffee. Manage work orders, roast profiles, machines, roasters, and sync data from Artisan roasting software.


Work Orders

Open in Qrema

A Work Order represents a single roasting batch. It tracks what green beans go in, what roasted coffee comes out, and all the parameters in between.

Work order list showing batches with status and details

Work Order Fields

FieldDescription
Work Order NumberUnique identifier
Green Bean / LotThe input material being roasted
Roast ProfileThe master profile (recipe) to follow
MachineWhich roasting machine is used
RoasterThe operator (roast master) performing the roast
Input WeightWeight of green beans going into the roaster (kg)
Output WeightWeight of roasted coffee produced (kg)
Roast Loss %Percentage of weight lost during roasting (auto-calculated)
StatusDraft, In Progress, Completed, Cancelled

Creating a Work Order

Click "+ Create Work Order" to schedule a new roasting batch.

Create work order form

  1. Select the green bean (and optionally the specific lot)
  2. Choose a roast profile (master profile)
  3. Assign the roasting machine and roast master
  4. Enter the input weight
  5. Save as Draft or start immediately

Work Order Lifecycle

DraftIn ProgressCompleted

When completed, the work order:

  • Deducts the input weight from green bean inventory
  • Adds the output weight to roasted coffee inventory
  • Records the roast loss percentage
  • Generates a roast profile visualization with time/temperature curves
warning

Important: Always record the actual output weight after roasting. The roast loss percentage is a key quality metric and affects COGS calculations.

Roast Profile Visualization

Completed work orders include a roast profile chart showing the time/temperature curve for the batch. This visualization displays BT (Bean Temperature), ET (Environment Temperature), and key event markers.

PDF Download

Completed work orders can be downloaded as a PDF report containing all batch details, the roast profile chart, input/output weights, and roast loss data. Click the "Download PDF" button on any completed work order.

tip

Tip: Use PDF reports for quality documentation, customer transparency, or archival purposes.

Floating Stopwatch

During roasting, a draggable floating stopwatch is available on screen. Use it to time your roast phases without leaving the work order page. The stopwatch can be repositioned anywhere on the screen by dragging.


Master Profile (Roast Recipes)

Open in Qrema

Master Profiles define your roast recipes -- the target parameters for roasting a specific coffee. Think of them as your roasting playbook.

Master profile list with roast parameters

Profile Fields

  • Profile Name -- Descriptive name (e.g., "Ethiopia Yirgacheffe - Light Roast")
  • Roast Level -- Light, Medium-Light, Medium, Medium-Dark, Dark
  • Target Temperature -- End temperature for the roast
  • Development Time -- Time after first crack
  • Notes -- Additional roasting notes and instructions
tip

Tip: Create profiles for each origin and roast level combination. Consistent profiles lead to consistent quality.


Artisan Sync

Open in Qrema

If you use Artisan (the open-source roast logging software), Qrema can import roast data directly from .alog files — bringing the full time/temperature curve, event markers, and weight data into your production records.

Artisan Sync page showing imported roast profiles

What Gets Imported

When you upload an .alog file, Qrema extracts:

FieldDescription
Roast TitleBatch name as set in Artisan
Roast Date & TimeWhen the roast was performed
MachineRoaster machine type (from Artisan machine config)
OperatorRoast master name (from Artisan operator field)
Drum SpeedDrum RPM recorded during the roast
Input / Output WeightCharge and drop weights (kg)
Roast Loss %Weight loss percentage (auto-calculated)
BT CurveFull Bean Temperature curve sampled every 30 seconds
ET CurveEnvironment Temperature readings
RoRRate of Rise calculated from the BT curve
Key EventsCharge, Turning Point, Yellow/Dry, First Crack, Drop timestamps and temperatures
Fire & Airflow EventsPower and airflow changes recorded during the roast

Uploading an .alog File Manually

  1. In Artisan, finish your roast and save it as an .alog file (File → Save As)
  2. In Qrema, go to Production → Artisan Sync
  3. Click "Upload .alog File"
  4. Select the .alog file from your computer
  5. Qrema parses the file and displays a preview of the roast data
  6. Confirm the import — the profile appears in your Artisan Sync list
info

Duplicate detection: Qrema uses the unique roastUUID embedded in each .alog file to prevent duplicate uploads. Re-uploading the same file will show a "duplicate" warning instead of creating a second record.

Linking a Profile to a Work Order

An imported Artisan profile can be attached to a Work Order to complete the production record:

  1. Open the imported profile from the Artisan Sync list
  2. Click "Link to Work Order"
  3. Select the matching Work Order from the dropdown
  4. Save — the work order now shows the full roast curve visualization
tip

Best practice: Create the Work Order before starting the roast. After roasting, upload the .alog and link it to the existing Work Order. This keeps your batch tracking complete from start to finish.

Auto-Sync via Artisan API Key

For roasters who want to skip the manual upload step, Qrema supports automated sync using a dedicated API key that connects directly with Artisan's export scripts.

Setting Up Auto-Sync

  1. Go to Settings → Integrations → Artisan API Keys
  2. Click "Generate New Key" and give it a name (e.g., "My Roasting PC")
  3. Copy the key — it is only shown once
  4. Configure Artisan's Roast Logger or the artisan_exporter script to POST to:
    POST https://roaster.qrema.site/api/v1/artisan-sync
    X-API-Key: <your-key>
    Content-Type: application/json
  5. After each roast, Artisan automatically sends the data to Qrema
warning

Keep your API key secret. Anyone with this key can push roast data into your company account. If a key is compromised, revoke it immediately from Settings → Integrations → Artisan API Keys.


Roasting Machines

Open in Qrema

Manage your roasting equipment inventory.

Roasting machine list

Machine Fields

  • Machine Name -- Identifier for the roaster (e.g., "Probat P25 #1")
  • Capacity -- Maximum batch size (kg)
  • Type -- Drum, fluid bed, hybrid, etc.
  • Status -- Active / Inactive
  • Notes -- Maintenance notes, serial number, etc.

Roast Masters

Open in Qrema

Track your roaster operators -- the people who run the machines.

Roast master list

  • Name -- Roast master's name
  • Role -- Head Roaster, Apprentice, etc.
  • Notes -- Certifications, specialties

Video Walkthrough

Production workflow -- from work order creation to roast completion