update
This commit is contained in:
157
.paul/phases/02-cross-sell-pro-w-zamowieniu/02-01-PLAN.md
Normal file
157
.paul/phases/02-cross-sell-pro-w-zamowieniu/02-01-PLAN.md
Normal file
@@ -0,0 +1,157 @@
|
||||
---
|
||||
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>
|
||||
Reference in New Issue
Block a user