158 lines
6.2 KiB
Markdown
158 lines
6.2 KiB
Markdown
---
|
|
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>
|