# Baltique OS Core 0.57.0 — Provider Normalization Center

Upgrade do obecnej instalacji. Nie jest to reinstalacja.

## Cel

Core 0.57.0 dodaje Provider Normalization Center:

- mapowanie webhooków konkretnych providerów SMTP/API na jeden standard OS,
- panel testów eventów delivered / bounce / open / click,
- webhook normalizujący eventy providerów,
- uczenie, który provider daje najlepszą dostarczalność dla pacjentów,
- opcjonalne automatyczne ustawianie priorytetów providerów.

## Nowe moduły

```text
/provider_normalization_center.php
/provider_normalization_webhook.php
```

## Profile providerów

Startowo dodane są profile:

```text
generic
sendgrid
mailgun
postmark
brevo
aws_ses
```

Każdy profil ma:

- event map JSON,
- field map JSON,
- przykładowy payload,
- aktywność,
- opcjonalny inbound secret.

## Standard OS eventów

Normalizowane eventy:

```text
sent
delivered
open
click
bounce
hard_bounce
soft_bounce
complaint
failed
deferred
unsubscribe
```

## Webhook

Nowy endpoint:

```text
/provider_normalization_webhook.php?provider=sendgrid
```

Webhook może przyjmować pojedynczy event albo paczkę eventów.

Jeżeli ustawiono `provider_normalization_webhook_secret` albo sekret profilu, wymagany jest sekret w:

```text
?secret=...
```

albo nagłówku:

```text
X-BALT-PROVIDER-SECRET
```

## Uczenie providerów

System analizuje eventy z Deliverability Center i liczy:

- delivery rate,
- failure rate,
- engagement rate,
- learning score,
- rekomendację dla providera.

Opcjonalnie może ustawić priorytety providerów w Mail Transport Center, ale domyślnie auto-rank jest wyłączony.

## Instalacja

1. Zrób backup plików i bazy.
2. Wgraj zawartość paczki do głównego katalogu Baltique OS.
3. Zaloguj się jako administrator.
4. Otwórz:

```text
https://baltique.pl/upgrade_0_57_0.php
```

5. Kliknij „Uruchom upgrade 0.57.0”.
6. Otwórz:

```text
https://baltique.pl/provider_normalization_center.php
```

7. Wykonaj Ctrl+F5.