---
phase: 02-cross-sell-pro-w-zamowieniu
plan: 01
type: execute
wave: 1
depends_on: ["01-01"]
files_modified:
  - modules/crosssellpro/crosssellpro.php
  - modules/crosssellpro/views/templates/hook/checkoutCrossSell.tpl
  - modules/crosssellpro/views/templates/hook/cartCrossSell.tpl
  - modules/crosssellpro/views/js/cartCrossSell.js
  - modules/crosssellpro/views/css/cartCrossSell.css
autonomous: false
---

<objective>
## Goal
Rozszerzyc modul Cross Sell PRO o wyswietlanie karuzeli na stronie zamowienia (`/zamowienie`) po prawej stronie checkoutu, wewnatrz `#js-checkout-summary`, przed obecna zawartoscia podsumowania.

## Purpose
Zwikszyc szanse dosprzedazy takze na etapie checkoutu, gdy klient finalizuje zamowienie i widzi podsumowanie koszyka.

## Output
Dzialajaca sekcja cross-sell w checkout summary, z danymi z relacji "Powiazany produkt" i zgodnym zachowaniem CTA (wariant/prosty), bez regresji sekcji koszyka.
</objective>

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

## Prior Work
@.paul/phases/01-cross-sell-pro-koszyk/01-01-PLAN.md

## Source Files
@modules/crosssellpro/crosssellpro.php
@modules/crosssellpro/views/templates/hook/cartCrossSell.tpl
@modules/crosssellpro/views/js/cartCrossSell.js
@modules/crosssellpro/views/css/cartCrossSell.css
@themes/leo_gstore/templates/checkout/_partials/cart-summary.tpl
</context>

<acceptance_criteria>

## AC-1: Render sekcji w checkout summary przed obecna zawartoscia
```gherkin
Given Uzytkownik otwiera strone zamowienia /zamowienie
When Renderuje sie blok #js-checkout-summary
Then Sekcja Cross Sell PRO jest wyswietlona wewnatrz tego bloku przed aktualna zawartoscia podsumowania
```

## AC-2: Checkout korzysta z danych "Powiazany produkt"
```gherkin
Given W koszyku sa produkty z uzupelnionymi relacjami "Powiazany produkt"
When Modul buduje sekcje cross-sell na checkout
Then Wyswietlone pozycje pochodza z tych relacji i pomijaja produkty juz obecne w koszyku
```

## AC-3: CTA dziala poprawnie na checkout
```gherkin
Given Klient klika CTA w sekcji Cross Sell PRO na checkout
When Produkt jest prosty
Then Produkt jest dodawany do koszyka bez utraty mozliwosci usuwania pozycji
```

## AC-4: Produkty z wariantami kieruja do strony produktu
```gherkin
Given Produkt cross-sell wymaga wyboru wariantu
When Klient kliknie CTA
Then Nastapi przekierowanie do karty produktu
```

## AC-5: Brak regresji karuzeli na stronie koszyka
```gherkin
Given Sekcja Cross Sell PRO istnieje juz na stronie koszyka
When Wdrozenie checkoutowej wersji zostanie zakonczone
Then Karuzela na /koszyk?action=show nadal dziala jak przed zmianami
```

</acceptance_criteria>

<tasks>

<task type="auto">
  <name>Task 1: Rozszerzyc modul o hook checkout summary top</name>
  <files>modules/crosssellpro/crosssellpro.php</files>
  <action>
    Dodac rejestracje i obsluge hooka `displayCheckoutSummaryTop` w module.
    W metodzie hooka przygotowac dane produktowe cross-sell analogicznie do koszyka, ale zoptymalizowane pod checkout.
    Zapewnic, ze render checkoutowy nie modyfikuje core ani szablonow motywu, tylko korzysta z hooka obecnego w `cart-summary.tpl`.
    Utrzymac kompatybilnosc z Prestashop 1.7.8.11 i PHP 7.4.
  </action>
  <verify>Na checkout hook zwraca HTML sekcji, a w przypadku pustej listy zwraca pusty output bez bledow.</verify>
  <done>AC-1 i AC-2 przygotowane po stronie backend.</done>
</task>

<task type="auto">
  <name>Task 2: Dodac widok checkout i dopasowac frontend karuzeli</name>
  <files>modules/crosssellpro/views/templates/hook/checkoutCrossSell.tpl, modules/crosssellpro/views/templates/hook/cartCrossSell.tpl, modules/crosssellpro/views/js/cartCrossSell.js, modules/crosssellpro/views/css/cartCrossSell.css</files>
  <action>
    Utworzyc dedykowany szablon checkoutowy osadzany przez `displayCheckoutSummaryTop` tak, aby sekcja byla renderowana przed aktualna zawartoscia `#js-checkout-summary`.
    Zrefaktoryzowac wspolne elementy karuzeli, aby dzialaly i w koszyku, i w checkout, bez konfliktow selektorow.
    Zachowac poprawne CTA: produkty proste dodaja sie do koszyka, produkty wariantowe przechodza na karte produktu.
    Upewnic sie, ze dzialanie checkoutowej sekcji nie psuje usuwania pozycji i aktualizacji podsumowania.
  </action>
  <verify>Manualny test na /zamowienie i /koszyk?action=show potwierdza poprawny render, dodawanie i brak regresji.</verify>
  <done>AC-1, AC-3, AC-4, AC-5 satisfied.</done>
</task>

<task type="checkpoint:human-verify" gate="blocking">
  <what-built>Cross Sell PRO w checkout summary (`#js-checkout-summary`) oraz utrzymana kompatybilnosc dotychczasowej sekcji koszyka.</what-built>
  <how-to-verify>
    1. Otworz: https://drmaterac.pl/zamowienie
    2. Sprawdz, czy sekcja Cross Sell jest po prawej, w `#js-checkout-summary`, przed aktualnym summary.
    3. Kliknij CTA produktu prostego i potwierdz dodanie do koszyka.
    4. Usun dodany produkt z koszyka i potwierdz, ze nie wraca automatycznie.
    5. Kliknij CTA produktu wariantowego i potwierdz przejscie na strone produktu.
    6. Wejdz na https://drmaterac.pl/koszyk?action=show i potwierdz, ze karuzela koszykowa nadal dziala.
  </how-to-verify>
  <resume-signal>Type "approved" to continue, or describe issues to fix</resume-signal>
</task>

</tasks>

<boundaries>

## DO NOT CHANGE
- Pliki core Prestashop poza modulem `modules/crosssellpro/*`
- Szablony motywu poza wykorzystaniem istniejacego hooka `displayCheckoutSummaryTop`

## SCOPE LIMITS
- Brak zmian w logice platnosci, dostawy i finalizacji zamowienia
- Brak przebudowy calego checkout layoutu
- Brak dodatkowego panelu konfiguracji na tym etapie

</boundaries>

<verification>
Before declaring plan complete:
- [ ] Sekcja wyswietla sie na /zamowienie wewnatrz `#js-checkout-summary` przed summary content.
- [ ] Produkty pochodza z relacji "Powiazany produkt".
- [ ] CTA produktow prostych dodaje do koszyka bez regresji usuwania.
- [ ] CTA produktow wariantowych kieruje na strone produktu.
- [ ] Dotychczasowa sekcja cross-sell na koszyku nadal dziala.
</verification>

<success_criteria>
- All tasks completed
- All verification checks pass
- No errors or warnings introduced
- Cross Sell PRO dziala w koszyku i checkout bez konfliktow
</success_criteria>

<output>
After completion, create `.paul/phases/02-cross-sell-pro-w-zamowieniu/02-01-SUMMARY.md`
</output>