newwalls.pl/.paul/STATE.md

STATE.md

Current Position

Milestone: v0.1 Naprawa nowego layoutu strony produktu Phase: 2 of 2 (Product actions fixes) — Planning Plan: 02-03 (customization save + success modal) created, awaiting approval Status: PLAN created. Plan 02-02 zamknięty PARTIAL, Plan 02-03 fokus na end-to-end UX. Last activity: 2026-04-23 — Created .paul/phases/02-product-actions-fixes/02-03-PLAN.md — scope: customization + modal (cena + cache-buster wydzielone do 02-04/02-05)

Progress:

• Milestone: [█████████░] 85% (Phase 1 zamknięty; Phase 2 plan 02-01 zamknięty, plan 02-02 PARTIAL, plan 02-03 w PLAN)
• Phase 1: [██████████] 100%
• Phase 2: [██████████░] 70% (plan 02-01 closed, plan 02-02 PARTIAL, plan 02-03 w PLAN stage; 02-04/02-05 do zaplanowania)

UWAGA: Milestone NIE jest ready na usunięcie IP gate (REMOTE_ADDR == '89.69.31.86'). Plan 02-03 jest kluczowy dla production readiness.

Loop Position

Current loop state:

PLAN ──▶ APPLY ──▶ UNIFY
  ✓        ○        ○     [Plan 02-03 created, awaiting approval]

Session Continuity

Last session: 2026-04-23 Stopped at: Plan 02-03 PLAN.md created Next action: Review plan .paul/phases/02-product-actions-fixes/02-03-PLAN.md, potwierdzić scope (customization + modal, bez ceny i cache-busta), następnie /paul:apply .paul/phases/02-product-actions-fixes/02-03-PLAN.md Resume file: .paul/phases/02-product-actions-fixes/02-03-PLAN.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-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.