Files
hassio-component-perfectdra…/openspec/specs/beer-label/spec.md
T
rickandCursor d43f1d675d Archive scoped-beer-override and sync its specs
Applies the change's delta specs to the main specs and files the change
under openspec/changes/archive/2026-09-16-scoped-beer-override.

keg-auto-detection gains the scoped-override and override-visibility
requirements, and its detection precedence is rewritten so no config
value can precede detection except by matching the reported product ID.
card-config drops the beer_name override requirement in favour of the
beer_overrides map, and records beer_name alongside beer_entity as an
ignored legacy key.

Also corrects three stale beer_name references in beer-catalog and
beer-label. The proposal's capability list missed those two specs; the
substance of their requirements is unchanged, only the key name they
name, so this is a naming correction rather than a requirement change.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-16 14:23:58 +02:00

3.1 KiB

beer-label Specification

Purpose

TBD - created by archiving change perfectdraft-card. Update Purpose after archive.

Requirements

Requirement: Beer logo display

The card SHALL display the selected beer's logo image in the upper portion of the left zone.

Scenario: Beer with logo image

  • WHEN the selected beer has a logo image available (built-in or custom via image_url)
  • THEN the card SHALL render the image in the label zone, sized to fit without distortion
  • THEN the image SHALL be loaded as a static asset (no lazy loading or progressive enhancement needed)

Scenario: Beer without logo image

  • WHEN the selected beer has no logo image (e.g., custom beer without image_url)
  • THEN the card SHALL display the beer name in large text against the beer's brand color palette background

Requirement: Temperature display

The card SHALL display the current beer temperature prominently in the left zone below the beer logo.

Scenario: Temperature available

  • WHEN the temperature sensor reports a numeric value
  • THEN the card SHALL display the temperature with a cold/frost icon (e.g., ❄) and the value followed by °C
  • THEN the temperature SHALL be displayed in a large, easily readable font size

Scenario: Temperature unavailable

  • WHEN the temperature sensor is unavailable or unknown
  • THEN the card SHALL display a placeholder (e.g., "-- °C") instead of the temperature value

Requirement: Beer name display

The card SHALL display the detected beer's name in the label zone below the temperature, using the card's own curated name where it has one.

Scenario: Beer detected

  • WHEN a beer has been determined by detection or by a beer_overrides entry
  • THEN the card SHALL display that beer's full name as text in the label zone

Scenario: Detected by product ID

  • WHEN the beer was matched by product ID
  • THEN the displayed name SHALL be the card catalog entry's curated name, not the name reported by the integration

Scenario: No beer detected

  • WHEN no beer could be determined
  • THEN the label zone SHALL indicate that no keg is detected
  • THEN the label zone SHALL NOT display the name of any catalog beer

Requirement: Label zone reflects detection state

The label zone's styling SHALL follow the detection state so a user can tell a detected beer from an undetected one at a glance.

Scenario: Beer detected

  • WHEN a beer has been determined
  • THEN the label zone SHALL use that beer's brand color palette as its background gradient

Scenario: No beer detected

  • WHEN no beer could be determined
  • THEN the label zone SHALL use a neutral palette rather than any brand palette
  • THEN the card SHALL NOT render a keg photograph or brewery logo

Requirement: Label zone is not a beer picker

The label zone SHALL NOT act as a control for choosing a beer, since the beer is detected rather than chosen.

Scenario: Tapping the label zone

  • WHEN the user taps the label zone in any layout
  • THEN no beer selection dialog SHALL open