Интеграции погоды

Интеграции погоды#

Документ фиксирует рабочий baseline интеграции двух источников осадков для D-008.

1. Источники и приоритет#

  • primary: локальная метеостанция (station)

  • fallback: внешний погодный сервис (external_weather_service)

  • anomaly control: сравнение station_precip_mm vs service_precip_mm с флагом anomaly_flag

2. Adapter profiles#

2.1 Локальная метеостанция#

  • adapter_profile_id: melioration-weather-station-v1

  • ingress endpoint: POST /api/v1/melioration-weather/commands/ingest

  • обязательные поля:

    • field_id

    • station_precip_mm

    • service_precip_mm (для anomaly-control)

    • observed_at (RFC3339)

2.2 Внешний weather service#

  • adapter_profile_id: melioration-weather-service-v1

  • режим: fallback при telemetry_healthy=false

  • ingress endpoint: POST /api/v1/melioration-weather/commands/ingest

  • обязательные поля:

    • field_id

    • service_precip_mm

    • observed_at (RFC3339)

3. Runtime policy#

  • Контур health: POST /api/v1/melioration-weather/commands/telemetry

  • При healthy=true:

    • source_mode=station_primary

    • used_precip_mm=station_precip_mm

  • При healthy=false:

    • source_mode=external_fallback

    • used_precip_mm=service_precip_mm

  • Для режима управления C: автоматическая деградация в fallback_mode (B по умолчанию).

4. Контрольный прогон#

  1. Выполнить POST /api/v1/melioration-weather/commands/telemetry с healthy=false.

  2. Выполнить POST /api/v1/melioration-weather/commands/ingest.

  3. Проверить GET /api/v1/melioration-weather/list:

    • source_mode=external_fallback

    • used_precip_mm=service_precip_mm

  4. Проверить GET /api/v1/melioration-field/list:

    • rain_mm и volume_mm пересчитаны с учетом fallback-осадков.

Содержание