Knowledge Graph
Thirty-three canonical concepts and the causal relations between them. Every edition draws from here.
Café OS has exactly one body of knowledge. Every concept has a stable id; chapters, 3D scenes and real labs reference that id instead of restating it.
Concepts relate in six ways: causes, affects, depends on, measured by, contrasts with and precedes. The table lists each concept's direct upstream and downstream.
Origin
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-ORIGIN-COFFEE-PLANT-001 | Coffee Plant Coffee is an evergreen flowering plant; what ends up in the cup comes from its seed. | Climate | — |
| CAF-ORIGIN-SPECIES-001 | Species Arabica and Canephora (Robusta) are different species; genetics shape both flavor and growing needs. | — | Coffee Cherry |
| CAF-ORIGIN-VARIETY-001 | Variety Varieties and cultivars are genetic distinctions within a species. | — | Coffee Cherry |
| CAF-ORIGIN-ORIGIN-001 | Origin Country, region, farm and microclimate, together with human farming decisions. | — | Climate |
| CAF-ORIGIN-CLIMATE-001 | Climate Temperature, rainfall and seasons decide whether coffee grows, and when it flowers and ripens. | Elevation、Origin | Coffee Plant、Coffee Cherry |
| CAF-ORIGIN-ELEVATION-001 | Elevation Elevation acts mainly through temperature, changing how fast the fruit ripens. | — | Climate |
| CAF-ORIGIN-CHERRY-001 | Coffee Cherry The fruit of the coffee plant: skin, pulp and mucilage around (usually) two seeds. | Species、Variety、Climate | — |
| CAF-ORIGIN-HARVEST-001 | Harvest Selective picking versus mechanical harvest is ultimately about how well ripeness is controlled. | — | Green Coffee |
Processing
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-PROC-PROCESSING-001 | Processing The steps that separate the seed from the fruit and dry it: washed, natural, honey and hybrids. | — | Fermentation |
| CAF-PROC-FERMENTATION-001 | Fermentation Microbial activity during processing; it can be controlled, or it can go wrong. | Processing | Green Coffee |
| CAF-PROC-DRYING-001 | Drying Bringing moisture down to a storable level; speed and evenness both matter. | — | Green Coffee |
| CAF-PROC-GREEN-COFFEE-001 | Green Coffee Dried, hulled and sorted seed awaiting roast; moisture, defects and storage decide its stability. | Harvest、Fermentation、Drying | — |
Roasting
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-ROAST-ROASTING-001 | Roasting A heat-driven transformation — drying, browning, gas, first crack, development — that changes flavor and solubility. | Heat Input | Extraction、Sensory Perception |
| CAF-ROAST-HEAT-001 | Heat Input How fast and how much heat reaches the beans during roasting, which sets when each stage arrives. | — | Roasting |
| CAF-ROAST-FRESHNESS-001 | Freshness Roast date, CO₂ degassing, resting and staling, and how air, heat, light and moisture affect storage. | — | Flow & Resistance |
Grinding
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-GRIND-GRINDING-001 | Grinding Turning beans into particles to expose surface area to water. | — | Particle Size Distribution |
| CAF-GRIND-PARTICLE-SIZE-001 | Particle Size Distribution "Grind size" is not one particle size but a distribution: fines, a main peak and boulders. | Grinding | Flow & Resistance、Extraction |
Water
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-WATER-WATER-001 | Brewing Water Water is not neutral: minerals, hardness and alkalinity change extraction and taste. | — | Extraction |
Brewing
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-BREW-DOSE-001 | Dose How many grams of coffee you use. It sets the ratio and also how deep the bed (or puck) is. | — | Flow & Resistance |
| CAF-BREW-RATIO-001 | Brew Ratio Coffee dose relative to water; it mainly sets the strength of the cup. | — | Strength、Extraction |
| CAF-BREW-TEMPERATURE-001 | Temperature Hotter water dissolves coffee faster. | — | Extraction |
| CAF-BREW-TIME-001 | Time How long water and coffee are in contact. In percolation, time is often a result of grind and flow rather than an independent dial. | Flow & Resistance | Extraction |
| CAF-BREW-AGITATION-001 | Agitation Stirring, pour impact and swirling that bring water and particles into fuller contact. | — | Flow & Resistance、Extraction |
| CAF-BREW-FLOW-001 | Flow & Resistance How fast water moves through the bed, set by particle size, bed structure and pressure; method-dependent. | Freshness、Particle Size Distribution、Agitation、Dose、Pressure | Time、Extraction |
| CAF-BREW-EXTRACTION-001 | Extraction How much — and which — soluble material water takes from coffee: under-, over- and uneven extraction. | Roasting、Particle Size Distribution、Flow & Resistance、Brewing Water、Temperature、Time、Agitation、Brew Ratio | Strength、Sensory Perception |
| CAF-BREW-STRENGTH-001 | Strength The concentration of dissolved coffee in the cup — not the same thing as extraction. | Brew Ratio、Extraction | Sensory Perception |
| CAF-BREW-IMMERSION-001 | Immersion Coffee steeps in all of the water for a time, then is separated. | — | — |
| CAF-BREW-PERCOLATION-001 | Percolation Water flows through a bed of coffee, fresh water continually carrying solubles away. | — | — |
Espresso & Milk
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-ESPR-ESPRESSO-001 | Espresso High-concentration percolation under pressure through a compact puck: dose, yield, pressure, time. | — | — |
| CAF-ESPR-PRESSURE-001 | Pressure An espresso machine pumps water through a compact puck; pressure drives the flow and the puck resists it. | — | Flow & Resistance |
| CAF-ESPR-MILK-001 | Milk & Texture Protein, fat, steam and temperature together decide the texture of microfoam. | — | Sensory Perception |
Sensory
| ID | Concept | Affected by | Affects |
|---|---|---|---|
| CAF-SENS-SENSORY-001 | Sensory Perception Aroma, acidity, sweetness, bitterness, body and aftertaste — perception first, vocabulary second. | Roasting、Extraction、Strength、Milk & Texture | — |
| CAF-SENS-PREFERENCE-001 | Preference Liking a cup and judging its quality are two different questions. | — | — |
The graph records direction, not magnitude. "Finer grind → faster extraction" is a direction; "how much finer, how much faster" belongs to the simulation models and is labelled as an approximation.