drmaterac.pl/.paul/phases/02-cross-sell-pro-w-zamowieniu/02-01-PLAN.md

phase, plan, type, wave, depends_on, files_modified, autonomous

phase	plan	type	wave	depends_on	files_modified	autonomous
02-cross-sell-pro-w-zamowieniu	01	execute	1	01-01	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	false

## 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.

## 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

<acceptance_criteria>

AC-1: Render sekcji w checkout summary przed obecna zawartoscia

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"

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

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

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

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>

Task 1: Rozszerzyc modul o hook checkout summary top modules/crosssellpro/crosssellpro.php 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. Na checkout hook zwraca HTML sekcji, a w przypadku pustej listy zwraca pusty output bez bledow. AC-1 i AC-2 przygotowane po stronie backend. Task 2: Dodac widok checkout i dopasowac frontend karuzeli 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 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. Manualny test na /zamowienie i /koszyk?action=show potwierdza poprawny render, dodawanie i brak regresji. AC-1, AC-3, AC-4, AC-5 satisfied. Cross Sell PRO w checkout summary (`#js-checkout-summary`) oraz utrzymana kompatybilnosc dotychczasowej sekcji koszyka. 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. Type "approved" to continue, or describe issues to fix

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

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.

<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>

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