newwalls.pl/.paul/STATE.md

STATE.md

Current Position

Milestone: v0.1 Naprawa nowego layoutu strony produktu Phase: 2 of 2 (Product actions fixes) — COMPLETE (02-01/02/03/04/05 closed) Plan: 02-05 (struktura materiału w POST payload) — UNIFY ✓ Status: Phase 02 COMPLETE. 5 plans shipped + verified. Ready for phase transition + milestone finalization. Last activity: 2026-04-24 — Plan 02-05 UNIFY complete. Phase transition pending.

Progress:

• Milestone: [██████████] 99% (Phase 1 ✓; Phase 2 ✓; pending transition/IP gate removal)
• Phase 1: [██████████] 100%
• Phase 2: [██████████] 100% (02-01 ✓, 02-02 PARTIAL closed, 02-03 ✓, 02-04 ✓, 02-05 ✓; 02-06 cache-buster deferred nice-to-have)

MILESTONE READINESS: Ready na transition + IP gate removal. Plan 02-06 (cache-buster) nie jest blocker.

Loop Position

Current loop state:

PLAN ──▶ APPLY ──▶ UNIFY
  ✓        ✓        ✓     [Plan 02-05 loop closed — Phase 02 COMPLETE]

Session Continuity

Last session: 2026-04-24 Stopped at: Plan 02-05 UNIFY ✓ — Phase 02 (Product actions fixes) COMPLETE. 5 plans shipped, 2 files modified (custom.js + product.tpl). Next action: Phase transition (git commit feat(02-product-actions-fixes)) → milestone completion decision (IP gate removal). Resume file: .paul/phases/02-product-actions-fixes/02-05-SUMMARY.md

Accumulated Context

Decisions (Phase 01)

Data	Decyzja	Wpływ
2026-04-23	Rozszerzenie scope Task 1 o wrapper <form id="add-to-cart-or-refresh">	Bez niego PS nie może AJAX-ować wariantu — konieczne do realizacji AC-2
2026-04-23	Ręczny AJAX w custom.js zamiast fake .product-actions	PS core handler szuka formy przez .product-actions — unikam dodawania problematycznej klasy (kolizja stylów), piszę własny flow
2026-04-23	Edytuj tylko custom.scss, nie custom.css	User ma własny watcher SCSS — manualne zmiany w CSS są nadpisywane
2026-04-23	In-place DOM update zamiast full redirect	User feedback "na starym layoucie działało bez reloadu" — history.pushState + manual replace .product-prices / .product_image_wrapper
2026-04-23	action=refresh (nie productrefresh)	Empiryczne probowanie endpointów — productrefresh zwracał pustą odpowiedź

Decisions (Phase 02 — Plan 02-01)

Data	Decyzja	Wpływ
2026-04-23	Priorytet: piece/crop przed add-to-cart	User zmienił priorytety z ROADMAP — konfigurator fragmentu krytyczny dla produktu („na wymiar")
2026-04-23	#piece reużywany z shared partial product-cover-thumbnails.tpl	Pierwotna próba dodania osobnego <div id="piece"> tworzyła duplikat ID — rozwiązanie: reuse istniejącego + inherit stylowania ze starego SCSS
2026-04-23	Override totalpriceinfospecific + prod na no-op w nowym layoucie	⚠️ WYWOŁAŁO regresję squaremeter customization flow: hook wymaga discretion=on + dimension fields ktore były synchronizowane przez tę funkcję. Plan 02-02 ujawnił że customization nie zapisuje się. Do fix'u w Plan 02-03.
2026-04-23	DOM stubs wstrzykiwane przez JS (nie template)	Smarty template cache + FTP sync delay — JS deploy'uje się niezawodniej.
2026-04-23	Piece NIE auto-init'uje się na load — pojawia się tylko po kliknięciu trigger'a popupu	User feedback w trakcie checkpoint — zmiana wymaganej behawiorystyki vs pierwotny plan
2026-04-23	Defensive .pp_stick_parent guard w fancybox handler	Element istnieje tylko w starym layoucie — bez guard'a popup aborts przed $.fancybox() w nowym

Decisions (Phase 02 — Plan 02-05)

Data	Decyzja	Wpływ
2026-04-24	Enumerate wszystkie [name^="group["] spoza formy zamiast hardcode group[5]	Future-proof — kolejne PS attribute groups automatycznie pokryte bez dalszych zmian kodu.
2026-04-24	Defensive closest('#add-to-cart-or-refresh').length check	Unika double-include gdyby przyszly refactor przesunął select do formy. Robustne.
2026-04-24	Filter radio/checkbox przez :checked	[name^="group["] łapie wszystkie radios z grupy (nie-checked też). Bez filtra payload by zawierał sprzeczne wartości.

Decisions (Phase 02 — Plan 02-04)

Data	Decyzja	Wpływ
2026-04-24	Scope pivot mid-task: label obok "Dodaj do koszyka" zamiast nadpisywania .current-price	User polecenie w trakcie Task 3 verification: "właściwą cenę jako napis obok Dodaj do koszyka. Ta cena u góry od xxx zł niech będzie stała." Gorna cena zostaje static info, konkretna suma blisko buttona.
2026-04-24	Separate __p02p04Bound guard zamiast shared __p02p02Bound (vs. pierwotny plan)	Stale-cache safety: gdy browser cache'uje stare custom.js (bez P04) + fresh product.tpl (z P04 inline), shared guard by zablokowal inline rejestracje. Separate guard = niezalezna rejestracja.
2026-04-24	Synchronous __p02p04TryInitial() zamiast jQuery(document).ready	jQuery ready w inline script wewnatrz Smarty {block name='content'} nie firuje konsekwentnie (function defined, callback nigdy nie wywolany). Synchronous call + interval early-return pokrywa DOM-not-ready case.
2026-04-24	setInterval 10×500ms (5s okno) zamiast single retry	Squaremeter init overwrituje .current-price po pierwszym recalc. Pure interval reliably pokrywa late-override + late DOM stubs injection. Po expire user ma pelna reaktywnosc na input events.
2026-04-24	Poll-retry rejestracja prestashop.on('updatedProduct')	window.prestashop moze nie istniec w momencie inline script parse (bundle loads po). Poll co 200ms az dostepny. AC-4 dziala niezawodnie.
2026-04-24	Inline style="" na labelce zamiast SCSS edit	Unika dependency na user watcher + SCSS build. MVP widocznosc. Pozniejszy plan moze przeniesc do tokenow motywu.

Decisions (Phase 02 — Plan 02-03)

Data	Decyzja	Wpływ
2026-04-24	Playwright capture z flipped IP → ground truth 26-field OLD payload	Bez tego pominęlibyśmy verbose dim format i kluczowe pola (qty_alt/qty_alth osobno od qty).
2026-04-24	Move inline script INSIDE {block name='content'}	KRYTYCZNE: Smarty {extends} renderuje TYLKO blocki. Inline script z Plan 02-02 był MIĘDZY {/block} i {/if} — dead code przez cały czas. Plan 02-02 AC-3 przechodził przez custom.js, nie przez "inline mirror".
2026-04-24	basePrice przez meta[property="product:price:amount"] fallback	#product_base_price/#product_fixed_price są w shared OLD partial, nie w NEW layout. Meta tag działa w obu.
2026-04-24	__p02p02InFlight re-entrancy guard	__p02p02Bound nie wystarczył — POST firował 2×. Guard reset przez complete: callback. Root cause doubling niepotwierdzony, ale guard skuteczny.
2026-04-24	Manual FTP upload via curl	ftp-kr VSCode extension nie łapie edycji z Claude Code Edit tool (watcher issue). curl -T ftp:// jako work-around.
2026-04-24	Używać verbose Polish dim string (nie "200x150")	Squaremeter customization display w cart oczekuje tego formatu.

Decisions (Phase 02 — Plan 02-02)

Data	Decyzja	Wpływ
2026-04-23	Plan 02-02 = submission + cart widget (bez ceny)	Cena wydzielona do Plan 02-03 dla scope 2-3 task. W trakcie APPLY odkryto że customization + modal TEŻ są w Plan 02-03.
2026-04-23	Task 1 = live diagnosis (checkpoint:human-verify)	Playwright ujawnił: button+qty są POZA formą #add-to-cart-or-refresh — PS core closest('form') zwraca 0, POST nigdy nie wychodzi.
2026-04-23	Wybór S3 (własny AJAX submit handler)	S2 (restrukturyzacja form) naruszałoby Bootstrap grid + shared partial risk. S3 bezpieczniejsze.
2026-04-23	Capture-phase native addEventListener (useCapture=true) zamiast jQuery .on()	Pierwsza iteracja dubluje POST (PS core i nasz oba firują). Capture phase fires PRZED bubble — całkowicie blokuje PS core. Verified.
2026-04-23	Manual blockcart refresh po emit('updatedCart')	Natural PS listener nie odświeżał widget w nowym layoucie. Defensive $.get fallback działał.
2026-04-23	Inline script mirror w product.tpl + idempotency guard	Browser cache serwuje old custom.js (transferSize=0). Inline HTML response zawsze fresh. Guard window.__p02p02Bound chroni przed double-register.
2026-04-23	UNIFY Plan 02-02 jako PARTIAL	Core POST działa ale: (a) customization nie zapisuje się — squaremeter hook gate'owany discretion=on z brakującymi polami, (b) success modal brak — wymaga osobny POST do /module/ps_shoppingcart/ajax. Delegowane Plan 02-03.

Open observations (do kolejnych planów Phase 02)

• Plan 02-03 (wymagany dla production) — Customization + modal + cena + cache-buster:
  • Przywrócić squaremeter dimension flow zamiast Plan 02-01 no-op override (totalpriceinfospecific / prod). Synchronizować pola: discretion=on, dim, qty, qty_alth, product_total_price_calc, extrafeevalue, wastevalue, calculated_total, grand_calculated_total, converted_ea, directinput, qty_alt, qty_altd, width_module, height_module, unittype_module.
  • Po udanym POST do /koszyk → drugi POST do /module/ps_shoppingcart/ajax?action=add-to-cart → pokazać modal (resp.modal HTML) z "Kontynuuj zakupy / Przejdź do koszyka".
  • Cena per-sqm calculation w UI (live update przy zmianie piece dimensions / qty).
  • Systemowy cache-buster ?v=<mtime> dla <script src=custom.js> tag'a — znaleźć miejsce rejestracji (theme.yml ma puste assets — rejestracja via hook/override do znalezienia). Pozwoli wycofać inline mirror z product.tpl.
• Plan 02-04+ — Puste bloki: .product-protect, .product-installation, .product-order-sample — wypełnić treścią.
• Re-verify po Plan 02-01 (przed git commit phase'a):
  • AC-5: stary layout (IP != 89.69.31.86) bez regresji
  • AC-4: zmiana wariantu kolorystycznego → AJAX refresh → #piece re-rendered → dragElement re-binds
  • Mirror button end-to-end w nowym layoucie
• Piece-size-view "50x50" placeholder po kliknieciu popup (cosmetic).
• Resize handles bezpośrednio na #piece (deferred bonus).

Skill audit

SPECIAL-FLOWS.md nadal nie skonfigurowane (rekomendacja z 02-01 niespełniona). Plan 02-02 podkreślił krytyczność Playwright MCP (diagnoza struktury DOM, event phases, customization flow — niemożliwe bez live debug).

Pattern Ustalony: Structure-first diagnosis przed implementacją — sprawdzić DOM relationships, event flow, POST payload requirements. Oszczędza iteracje.

Rekomendacja: Utworzyć SPECIAL-FLOWS.md z Playwright MCP jako required skill dla Plan 02-03+ — customization flow wymaga end-to-end testów POST → DB state → UI re-render.