← The board

G7 Overall health summary

Area
G — Cross-cutting UX
Audience
operator
Kind
feature
Status
accepted
Maturity
built
Labels
verification, ux
Requires
B5
Relates to
B3C1G4

The feature in the specification · Read at

Requirements

  1. G7-R1acceptedMUST

    A single-line health summary MUST be available on every surface.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/operator/src/Internal/Screens/HowThisStackIs.phpapp-modules/operator/src/Internal/Screens/YourStacks.phpapp-modules/operator/tests/Internal/WhereTheTabsAreDrawnTest.phptests/Arch/NoArgumentThatCannotBeWrongTest.php
    cited by
    lemonfiber@c6368b3855
  2. G7-R2acceptedMUST

    The summary MUST be computed from operator-affecting findings, not from a count of running containers.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    cited by
    lemonfiber@cf4c237ceflemonfiber@c6368b3855
  3. G7-R3acceptedMUST

    The summary's severity MUST equal the highest severity present, never an average.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    cited by
    lemonfiber@c6368b3855lemonfiber@4ccc9f6bf1
  4. G7-R4acceptedMUST

    A stack with all containers running but a critical finding MUST NOT report as healthy.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    cited by
    lemonfiber@c6368b3855
  5. G7-R5acceptedMUST

    Where health cannot be determined, the summary MUST report unknown and MUST NOT report healthy.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/kernel/src/Api/HowItStands.phpapp-modules/health/src/Api/WhatWasHeardSoFar.phpapp-modules/health/tests/Api/KeepingTheLastReadingTest.phpapp-modules/health/tests/Api/WhatWasHeardSoFarTest.php
    recorded partial
    lemonfiber-websrc/routes/DashboardStanding.test.ts::shows no numeral where nothing has graded the stack
    cited by
    lemonfiber@c6368b3855lemonfiber@4ccc9f6bf1
  6. G7-R6acceptedMUST

    Findings sharing a root cause MUST be counted once.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    cited by
    lemonfiber@1fd558c7ed
  7. G7-R7acceptedMUST

    The summary MUST expand to the affected items and their remedies.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companiontests/Feature/HearingHowAStackIsTest.php
    recorded partial
    lemonfiber-websrc/routes/DashboardStanding.test.ts::expands to each thing wrong and what to do about it
    cited by
    lemonfiber@e54279d6dclemonfiber@1fd558c7ed
  8. G7-R8acceptedMUST

    The summary MUST be identical across surfaces, from one computation.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/kernel/src/Api/Standings.phpapp-modules/sdk/src/Api/Standings.phpapp-modules/sdk/tests/Api/StandingsTest.phpapp-modules/sdk/tests/Internal/ChangesTest.php
    cited by
    lemonfiber@c6368b3855
  9. G7-R9acceptedMUST

    A deliberately stopped stack MUST report stopped, not a failure state.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/kernel/src/Api/HowItStands.phpapp-modules/health/tests/Api/KeepingTheLastReadingTest.phpapp-modules/health/tests/Api/WhatWasHeardSoFarTest.php
    cited by
    lemonfiber@93e398e530lemonfiber@c6368b3855
  10. G7-R10acceptedMUST

    Failures confined to non-essential services MUST report as advisory rather than requiring attention.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/kernel/src/Api/HowItStands.phpapp-modules/health/tests/Api/KeepingTheLastReadingTest.phpapp-modules/health/tests/Api/WhatWasHeardSoFarTest.php
    cited by
    lemonfiber@c6368b3855
  11. G7-R11acceptedMUST

    The summary MUST be debounced so transient conditions do not cause it to flap.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    cited by
    lemonfiber@1fd558c7ed
  12. G7-R12acceptedMUST

    During startup the summary MUST report unknown rather than a failure state.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/operator/src/Internal/Presenters/HowTheOneLineReads.phptests/Feature/TheListSaysTheOneLineTest.php
    cited by
    lemonfiber@c6368b3855
  13. G7-R13acceptedMUST

    A healthy summary MUST be as clearly presented as an unhealthy one.

    locked by
    0.5.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health.rs
    recorded partial
    lemonfiber-companionapp-modules/operator/src/Internal/Presenters/HowTheOneLineReads.phptests/Feature/TheListSaysTheOneLineTest.php
    cited by
    lemonfiber@c6368b3855
  14. G7-R14acceptedMUST

    An affected item the operator has acknowledged MUST be shown as acknowledged, and MUST NOT be presented as resolved while it still stands.

    locked by
    0.18.0 met
    recorded done
    lemonfibercrates/lemonfiber-core/src/health/summary.rscrates/lemonfiber-core/src/condition.rscontract/web-api/defs/Affected.jsoncrates/lemonfiber-core/src/health/summary/tests.rs::an_acknowledged_item_is_shown_as_acknowledged_and_still_counted
    cited by
    lemonfiber@cc1b83cf00