Changelog — bzp-monitor-pl
[Unreleased] — Faza 3 (state + watermark)
Monitoring między uruchomieniami: nazwany KV store bzp-monitor-state-{stateKey} z hashem pól zmiennych.
Klasyfikacja zdarzeń: new / changed / unchanged / awarded / cancelled . W trybie new_only unchanged są pomijane.
Watermark: awansuje tylko po w pełni udanym przebiegu (błąd zapytania = brak awansu, następny run powtarza okno).
Cache PDF: TTL zależny od typu (rozstrzygnięcia/unieważnienia 30 dni, postępowania/plany 24 h) + wymuszony refetch przy zmianie pól zmiennych.
Adaptacyjny limiter (3 req/s, spadek do 1 req/s po 429/timeout, powrót po 60 s).
Naliczanie (pay-per-event) podpięte dla 6 zdarzeń.
organizationNationalId / contractorNationalId — DEPRECATED
Od pierwszego wydania identyfikatory są rozdzielone na osobne pola, bo instytucje publiczne często mają wyłącznie REGON (bez NIP):
Używaj: organizationNip (10 cyfr), organizationRegon (9 lub 14 cyfr), organizationRawIds (audyt).
To samo dla wykonawców: contractorNip , contractorRegon , contractorRawIds .
organizationNationalId / contractorNationalId są deprecated (wypełnione jako nip ?? regon dla zgodności wstecznej).
Timeline:
v1.0 — dual field: nowe pola + deprecated *NationalId .
v1.1–v1.9 — *NationalId nadal dostępne, oznaczone jako deprecated.
v2.0 — *NationalId usunięte (breaking change, bump major).