bilety.brzezovka.pl/.paul/phases/02-purchase-event-prepayment/02-01-PLAN.md

---
phase: 02-purchase-event-prepayment
plan: 01
type: execute
wave: 1
depends_on: []
files_modified:
  - autoload/controls/class.Tickets.php
  - templates/tickets/przelewy24.php
  - templates/tickets/order-confirm.php
autonomous: true
delegation: off
---

<objective>
## Goal
Przenieść event purchase dataLayer z order-confirm (po płatności) na stronę przelewy24 (po złożeniu zamówienia w DB, przed przekierowaniem do bramki płatniczej).

## Purpose
Event purchase powinien rejestrować moment złożenia zamówienia, a nie powrotu z bramki. Użytkownicy, którzy nie wracają na stronę potwierdzenia po zapłacie, nie są teraz trackingowani. Przesunięcie na przelewy24 zapewnia pełne pokrycie analityczne.

GA4 + GTM używa `navigator.sendBeacon()` do wysyłania hitów — event dotrze do GA4 mimo że strona od razu przekierowuje na Przelewy24.

## Output
- `autoload/controls/class.Tickets.php` — buildPurchaseDataLayer() wywoływane w przelewy24(), nie w order_confirm()
- `templates/tickets/przelewy24.php` — dodany blok dataLayer.push z payloadem purchase
- `templates/tickets/order-confirm.php` — usunięty blok dataLayer.push purchase
</objective>

<context>
## Project Context
@.paul/PROJECT.md
@.paul/ROADMAP.md
@.paul/STATE.md

## Prior Work
@.paul/phases/01-purchase-data-layer/01-01-SUMMARY.md

## Source Files
@autoload/controls/class.Tickets.php
@templates/tickets/przelewy24.php
@templates/tickets/order-confirm.php
</context>

<acceptance_criteria>

## AC-1: Purchase Event na stronie przelewy24
```gherkin
Given użytkownik złożył zamówienie i jest przekierowywany na /tickets/przelewy24/order=HASH
When strona przelewy24 się renderuje
Then window.dataLayer otrzymuje push eventu purchase z pełnym payloadem (transaction_id, value, currency, items)
```

## AC-2: Brak Purchase Event na order-confirm
```gherkin
Given użytkownik wraca na /tickets/order_confirm/order=HASH po płatności
When strona order-confirm się renderuje
Then window.dataLayer NIE otrzymuje push eventu purchase
```

## AC-3: Payload zawiera dane zamówienia
```gherkin
Given event purchase fires na przelewy24
When inspektujemy push w dataLayer
Then payload zawiera: event='purchase', ecommerce.transaction_id (id zamówienia), ecommerce.value (cena), ecommerce.currency='PLN', ecommerce.items (tablica biletów z item_id, item_name, quantity, price)
```

</acceptance_criteria>

<tasks>

<task type="auto">
  <name>Task 1: Przenieś buildPurchaseDataLayer() z order_confirm() do przelewy24()</name>
  <files>autoload/controls/class.Tickets.php</files>
  <action>
    W metodzie `przelewy24()`:
    - Po pobraniu `$order` (linia ~571), dodaj: `$purchaseDataLayer = self::buildPurchaseDataLayer($order);`
    - W wywołaniu `Tpl::view('tickets/przelewy24', [...])` dodaj klucz: `'purchase_data_layer' => $purchaseDataLayer`

    W metodzie `order_confirm()`:
    - Usuń linię `$purchaseDataLayer = self::buildPurchaseDataLayer($order);` (obecna tylko gdy payment_status == 1)
    - W wywołaniu `Tpl::view('tickets/order-confirm', [...])` zmień `'purchase_data_layer' => $purchaseDataLayer` na `'purchase_data_layer' => null`
    - Możesz też usunąć zmienną `$purchaseDataLayer = null;` z góry metody order_confirm()

    Nie zmieniaj logiki `buildPurchaseDataLayer()` — tylko przenosimy gdzie jest wywoływana.
  </action>
  <verify>php -l "autoload/controls/class.Tickets.php"</verify>
  <done>AC-1, AC-2: Kontroler przekazuje payload purchase do przelewy24 i null do order-confirm</done>
</task>

<task type="auto">
  <name>Task 2: Dodaj purchase push do przelewy24.php, usuń z order-confirm.php</name>
  <files>templates/tickets/przelewy24.php, templates/tickets/order-confirm.php</files>
  <action>
    W `templates/tickets/przelewy24.php`:
    - Na samym początku pliku (przed istniejącym PHP i HTML), dodaj identyczny blok dataLayer push jak był w order-confirm.php:
    ```php
    <?php
    $purchaseDataLayerJson = null;
    if (is_array($this->purchase_data_layer ?? null)) {
      $purchaseDataLayerJson = json_encode(
        $this->purchase_data_layer,
        JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_INVALID_UTF8_SUBSTITUTE
      );
    }
    ?>
    <?php if($purchaseDataLayerJson) : ?>
    <script type="text/javascript">
    window.dataLayer = window.dataLayer || [];
    window.dataLayer.push({ ecommerce: null });
    window.dataLayer.push(<?= $purchaseDataLayerJson; ?>);
    </script>
    <?php endif; ?>
    ```

    W `templates/tickets/order-confirm.php`:
    - Usuń blok PHP + script na liniach 1-17 (cały blok $purchaseDataLayerJson + conditional script tag z dataLayer.push)
    - Pozostałe treści (alerty $order_successful, $order_fail, dane zamówienia) pozostaw bez zmian.
  </action>
  <verify>
    - Sprawdź czy przelewy24.php zaczyna się od bloku PHP z $purchaseDataLayerJson
    - Sprawdź czy order-confirm.php NIE zawiera "purchaseDataLayerJson" ani "dataLayer.push({ ecommerce: null })"
  </verify>
  <done>AC-1, AC-2, AC-3: Event fires na przelewy24, nie fires na order-confirm</done>
</task>

</tasks>

<boundaries>

## DO NOT CHANGE
- Logika metody `buildPurchaseDataLayer()` — tylko przeniesienie wywołania
- Logika wysyłania emaili w przelewy24() i order_confirm()
- Flaga `informed_user` i logika emaili w order_confirm()
- templates/site/layout-logged.php — to jest zakres Phase 3
- libraries/* — to jest zakres Phase 3
- Inne szablony i kontrolery poza wymienionymi

## SCOPE LIMITS
- Nie dodawaj deduplicacji eventu (np. sesja/cookie blokująca ponowne wyemitowanie)
- Nie zmieniaj struktury payloadu GA4 (pola event, ecommerce, order)
- Nie modyfikuj przelewy24_response() ani innych akcji kontrolera

</boundaries>

<verification>
Before declaring plan complete:
- [ ] php -l autoload/controls/class.Tickets.php — brak błędów składniowych
- [ ] templates/tickets/przelewy24.php zawiera blok $purchaseDataLayerJson i window.dataLayer.push
- [ ] templates/tickets/order-confirm.php NIE zawiera purchaseDataLayerJson ani dataLayer.push({ ecommerce: null })
- [ ] Wszystkie acceptance criteria spełnione
</verification>

<success_criteria>
- Oba zadania wykonane
- PHP syntax valid
- Event purchase fires na stronie przelewy24 z pełnym payloadem
- Brak eventu purchase na stronie order-confirm
</success_criteria>

<output>
After completion, create `.paul/phases/02-purchase-event-prepayment/02-01-SUMMARY.md`
</output>