PLBA2-1. Спецификация
This commit is contained in:
@@ -0,0 +1,58 @@
|
||||
# Spec Delta
|
||||
|
||||
## Purpose
|
||||
|
||||
Агрегировать текущий health приложения из runtime, workers и health contributors.
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Агрегация health-состояния
|
||||
|
||||
**ID:** `HL.AG-01`
|
||||
|
||||
Health aggregator SHALL формировать единый отчёт по lifecycle приложения и текущему состоянию компонентов.
|
||||
|
||||
#### Scenario: Получение health-отчёта
|
||||
|
||||
##### Участники
|
||||
|
||||
- Приложение, runtime, workers и health contributors.
|
||||
|
||||
##### Предусловия
|
||||
|
||||
- Каждый worker и contributor предоставляет состояние по health-контракту.
|
||||
|
||||
##### Основной поток
|
||||
|
||||
1. Собираем состояния runtime и компонентов — aggregator формирует отчёт по [HL.AG-01.FR-01](#hlag-01fr-01-состав-и-приоритет-статусов).
|
||||
2. Рассчитываем общий статус и завершаем с `HEALTH_REPORT_CREATED` по [HL.AG-01.FR-02](#hlag-01fr-02-результат-агрегации).
|
||||
|
||||
##### Альтернативы и ошибки
|
||||
|
||||
- Входной статус не соответствует контракту — возвращаем `HEALTH_INPUT_INVALID` по [HL.AG-01.FR-02](#hlag-01fr-02-результат-агрегации).
|
||||
|
||||
##### Результат
|
||||
|
||||
Приложение получает единый статус и детализацию состояния каждого запущенного worker.
|
||||
|
||||
##### Коды завершения
|
||||
|
||||
| Код | Смысл | Связанные FR |
|
||||
| --- | --- | --- |
|
||||
| `HEALTH_REPORT_CREATED` | Отчёт сформирован из валидных состояний | [HL.AG-01.FR-02](#hlag-01fr-02-результат-агрегации) |
|
||||
| `HEALTH_INPUT_INVALID` | Состояние не соответствует health-контракту | [HL.AG-01.FR-02](#hlag-01fr-02-результат-агрегации) |
|
||||
|
||||
#### Функциональные требования
|
||||
|
||||
##### HL.AG-01.FR-01: Состав и приоритет статусов
|
||||
|
||||
Worker сообщает status, critical, detail и meta через health-контракт. Отчёт содержит application_id, lifecycle приложения и состояния каждого запущенного worker/contributor. Worker с `disabled: true` исключён из набора ожидаемых компонентов и не ухудшает health. Статусы упорядочены как `ok < degraded < unhealthy`; применяется худший итоговый статус. Для критичного компонента учитывается переданный status. Для некритичного компонента `unhealthy` ограничивается до `degraded`; отсутствие некритичного worker также даёт не ниже `degraded`. Отсутствующий критичный worker даёт `unhealthy`. Lifecycle `new` и `failed` даёт `unhealthy`, `starting` и `stopping` — не ниже `degraded`. Когда lifecycle приложения `stopped`, общий health status — `stopped` независимо от прежних статусов компонентов.
|
||||
|
||||
##### HL.AG-01.FR-02: Результат агрегации
|
||||
|
||||
Health-статус является данными. Валидные агрегированные `ok`, `degraded`, `unhealthy` и `stopped` возвращаются в отчёте; `stopped` обозначает lifecycle приложения, а статусы запущенных worker/contributor остаются `ok`, `degraded` или `unhealthy`. Ошибка появляется только при нарушении контракта входного состояния.
|
||||
|
||||
| Код | Текст сообщения | Дальнейшее поведение |
|
||||
| --- | --- | --- |
|
||||
| `HEALTH_REPORT_CREATED` | Сообщение отсутствует | Отчёт возвращается вызывающему коду для представления клиенту |
|
||||
| `HEALTH_INPUT_INVALID` | Сообщение отсутствует; ошибка контракта передаётся вызывающему коду | Отчёт не формируется; приложение исправляет contributor |
|
||||
Reference in New Issue
Block a user