# Baltique OS Core 0.29.0 — Marketing ROI Dashboard

Upgrade do obecnej instalacji. Nie jest to reinstalacja.

## Cel

Core 0.29.0 dodaje dashboard marketingowy:

```text
/marketing_dashboard.php
```

Panel analizuje pełny lejek:

```text
lead → booking → konsultacja → operacja
```

oraz pokazuje:

- koszt pozyskania pacjenta,
- koszt leadu,
- koszt bookingu,
- koszt konsultacji,
- koszt ścieżki operacyjnej,
- przychody według źródła,
- ROI kampanii,
- ROAS,
- źródła pacjentów,
- kampanie UTM,
- alerty ROI / CAC,
- snapshot dashboardu.

## Źródła danych

Panel korzysta z:

- `patient_source_attribution`,
- `public_pretriage_requests`,
- `public_booking_requests`,
- `appointments`,
- `consultation_aftercare_records`,
- `consultation_followup_queue`,
- `paycore_orders`,
- `surgery_cases`, jeśli TheatreFlow jest aktywny,
- `marketing_campaign_costs`.

## Koszty kampanii

Nowa tabela:

```text
marketing_campaign_costs
```

pozwala wpisywać koszty kampanii według:

- source_channel,
- utm_source,
- utm_medium,
- utm_campaign,
- okresu,
- kosztu brutto PLN.

Przykład:

```text
source_channel: public_booking
utm_source: google
utm_medium: cpc
utm_campaign: piersi_2026
koszt: 2500 PLN
```

## ROI i ROAS

System liczy:

```text
ROI = (przychód - koszt) / koszt * 100%
ROAS = przychód / koszt
```

Przychód jest przypisywany do źródła pierwszej konsultacji pacjenta w wybranym okresie. To jest model operacyjny do oceny marketingu, nie raport księgowy.

## Cele i alerty

Nowe tabele:

```text
marketing_roi_goals
marketing_roi_alerts
marketing_roi_snapshots
```

Pozwalają ustawić:

- minimalny ROI,
- minimalny ROAS,
- maksymalny koszt leadu,
- maksymalny koszt operacji.

Alert pojawia się, gdy kampania / źródło przekracza ustalone progi.

## 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_29_0.php
```

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

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

7. Wykonaj Ctrl+F5.