social.arabica.alpha.brew Documentation (EN)

main record

A coffee brewing session with parameters and notes

Record Key tid Timestamp-based ID

Properties

beanRef string at-uri Required

AT-URI reference to the bean record used

brewerRef string at-uri Optional

AT-URI reference to the brewer/device used

coffeeAmount integer Optional

Amount of coffee used in grams

minimum: 0

createdAt string datetime Required

Timestamp when the brew was made

espressoParams ref #espressoParams Optional

Espresso-specific brewing parameters (optional)

grindSize string Optional

Grind size setting (can be numeric like '18' or descriptive like 'Medium')

maxLength: 50 bytes

grinderRef string at-uri Optional

AT-URI reference to the grinder used

method string Optional

Brewing method (e.g., 'Pour Over', 'French Press', 'Espresso')

maxLength: 100 bytes

pouroverParams ref #pouroverParams Optional

Pour-over-specific brewing parameters (optional)

pours array of ref #pour Optional

Array of pour information for multi-pour methods (e.g., V60)

rating integer Optional

Rating of the brew from 1 to 10

minimum: 1maximum: 10

recipeRef string at-uri Optional

AT-URI reference to the recipe used for this brew

tastingNotes string Optional

Tasting notes and observations about the brew

maxLength: 2000 bytes

temperature integer Optional

Water temperature in tenths of a degree Celsius (e.g., 935 = 93.5°C)

minimum: 0maximum: 1000

timeSeconds integer Optional

Total brew time in seconds

minimum: 0

waterAmount integer Optional

Amount of water used in grams or milliliters

minimum: 0

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "beanRef",
      "createdAt"
    ],
    "properties": {
      "pours": {
        "type": "array",
        "items": {
          "ref": "#pour",
          "type": "ref"
        },
        "description": "Array of pour information for multi-pour methods (e.g., V60)"
      },
      "method": {
        "type": "string",
        "maxLength": 100,
        "description": "Brewing method (e.g., 'Pour Over', 'French Press', 'Espresso')"
      },
      "rating": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Rating of the brew from 1 to 10"
      },
      "beanRef": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI reference to the bean record used"
      },
      "brewerRef": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI reference to the brewer/device used"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when the brew was made"
      },
      "grindSize": {
        "type": "string",
        "maxLength": 50,
        "description": "Grind size setting (can be numeric like '18' or descriptive like 'Medium')"
      },
      "recipeRef": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI reference to the recipe used for this brew"
      },
      "grinderRef": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI reference to the grinder used"
      },
      "temperature": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 0,
        "description": "Water temperature in tenths of a degree Celsius (e.g., 935 = 93.5°C)"
      },
      "timeSeconds": {
        "type": "integer",
        "minimum": 0,
        "description": "Total brew time in seconds"
      },
      "waterAmount": {
        "type": "integer",
        "minimum": 0,
        "description": "Amount of water used in grams or milliliters"
      },
      "coffeeAmount": {
        "type": "integer",
        "minimum": 0,
        "description": "Amount of coffee used in grams"
      },
      "tastingNotes": {
        "type": "string",
        "maxLength": 2000,
        "description": "Tasting notes and observations about the brew"
      },
      "espressoParams": {
        "ref": "#espressoParams",
        "type": "ref",
        "description": "Espresso-specific brewing parameters (optional)"
      },
      "pouroverParams": {
        "ref": "#pouroverParams",
        "type": "ref",
        "description": "Pour-over-specific brewing parameters (optional)"
      }
    }
  },
  "description": "A coffee brewing session with parameters and notes"
}

espressoParams object

Parameters specific to espresso brewing

Properties

preInfusionSeconds integer Optional

Pre-infusion time in seconds

minimum: 0

pressure integer Optional

Brewing pressure in tenths of a bar (e.g., 90 = 9.0 bar)

minimum: 0

yieldWeight integer Optional

Espresso yield/output weight in tenths of a gram (e.g., 360 = 36.0g)

minimum: 0

View raw schema

{
  "type": "object",
  "properties": {
    "pressure": {
      "type": "integer",
      "minimum": 0,
      "description": "Brewing pressure in tenths of a bar (e.g., 90 = 9.0 bar)"
    },
    "yieldWeight": {
      "type": "integer",
      "minimum": 0,
      "description": "Espresso yield/output weight in tenths of a gram (e.g., 360 = 36.0g)"
    },
    "preInfusionSeconds": {
      "type": "integer",
      "minimum": 0,
      "description": "Pre-infusion time in seconds"
    }
  },
  "description": "Parameters specific to espresso brewing"
}

pour object

Information about a single pour in a multi-pour brewing method

Properties

timeSeconds integer Required

Time of this pour relative to brew start (seconds)

minimum: 0

waterAmount integer Required

Amount of water in this pour (grams or ml)

minimum: 0

View raw schema

{
  "type": "object",
  "required": [
    "waterAmount",
    "timeSeconds"
  ],
  "properties": {
    "timeSeconds": {
      "type": "integer",
      "minimum": 0,
      "description": "Time of this pour relative to brew start (seconds)"
    },
    "waterAmount": {
      "type": "integer",
      "minimum": 0,
      "description": "Amount of water in this pour (grams or ml)"
    }
  },
  "description": "Information about a single pour in a multi-pour brewing method"
}

pouroverParams object

Parameters specific to pour-over brewing

Properties

bloomSeconds integer Optional

Bloom wait time in seconds

minimum: 0

bloomWater integer Optional

Water used for bloom in grams

minimum: 0

bypassWater integer Optional

Bypass water added after brewing in grams

minimum: 0

drawdownSeconds integer Optional

Drawdown time in seconds (time after last pour until bed is dry)

minimum: 0

filter string Optional

Type of filter used (e.g. paper, metal, cloth)

maxLength: 100 bytes

View raw schema

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string",
      "maxLength": 100,
      "description": "Type of filter used (e.g. paper, metal, cloth)"
    },
    "bloomWater": {
      "type": "integer",
      "minimum": 0,
      "description": "Water used for bloom in grams"
    },
    "bypassWater": {
      "type": "integer",
      "minimum": 0,
      "description": "Bypass water added after brewing in grams"
    },
    "bloomSeconds": {
      "type": "integer",
      "minimum": 0,
      "description": "Bloom wait time in seconds"
    },
    "drawdownSeconds": {
      "type": "integer",
      "minimum": 0,
      "description": "Drawdown time in seconds (time after last pour until bed is dry)"
    }
  },
  "description": "Parameters specific to pour-over brewing"
}