Files

Jacek 5b66720f7c fix: scontainers edit saves existing record instead of creating new

Fixes static container admin edit flow by preserving id in hiddenFields and adding route-id fallback during save.
Adds regression tests for edit/create id behavior, updates release docs (changelog/testing/CLAUDE), and appends SonarQube open issues to docs/TODO.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-18 22:56:14 +02:00

4.0 KiB

Raw Blame History

shopPRO

What This Is

Autorski silnik sklepu internetowego pisany od podstaw â€” odpowiednik WooCommerce lub PrestaShop, ale bez zaleĹĽnoĹ›ci od zewnÄ™trznych platform. SkĹ‚ada siÄ™ z panelu administratora (zarzÄ…dzanie zamĂłwieniami, produktami, klientami) oraz czÄ™Ĺ›ci frontowej dla klienta koĹ„cowego.

Core Value

WĹ‚aĹ›ciciel sklepu internetowego ma peĹ‚nÄ… kontrolÄ™ nad sprzedaĹĽÄ… online â€” produktami, zamĂłwieniami i klientami â€” w jednym spĂłjnym systemie pisanym od podstaw, bez narzutĂłw zewnÄ™trznych platform.

Current State

Attribute	Value
Version	0.333
Status	Production
Last Updated	2026-04-18

Requirements

Validated (Shipped)

Panel administratora â€” zarzÄ…dzanie produktami, kategoriami, atrybutami
Panel administratora â€” zarzÄ…dzanie zamĂłwieniami
Panel administratora â€” zarzÄ…dzanie klientami
CzÄ™Ĺ›Ä‡ frontowa â€” przeglÄ…danie i kupowanie produktĂłw
Koszyk i skĹ‚adanie zamĂłwieĹ„
Integracje pĹ‚atnoĹ›ci i dostaw
REST API (ordersPRO + Ekomi)
Redis caching
Ochrona przed podwĂłjnym skĹ‚adaniem zamĂłwienia
Domain-Driven Architecture (migracja z legacy zakoĹ„czona)

Active (In Progress)

[Do zdefiniowania podczas planowania]

Planned (Next)

[Do zdefiniowania podczas planowania]

Out of Scope

Multitenancy (wiele sklepĂłw w jednej instancji) â€” nie planowane

Target Users

Primary: WĹ‚aĹ›ciciel/administrator sklepu internetowego

ZarzÄ…dza produktami, zamĂłwieniami, klientami przez panel admina
Potrzebuje niezawodnego, szybkiego narzÄ™dzia bez zbÄ™dnych zaleĹĽnoĹ›ci

Secondary: Klient koĹ„cowy sklepu

PrzeglÄ…da produkty, dodaje do koszyka, skĹ‚ada zamĂłwienia

Context

Technical Context:

PHP 7.4+ (produkcja: PHP < 8.0)
Medoo ORM ($mdb), Redis caching
Domain-Driven Design z Dependency Injection
PHPUnit 9.6, 810+ testĂłw
Namespace: \Domain\, \admin\, \front\, \api\, \Shared\

Constraints

Technical Constraints

PHP < 8.0 na produkcji (brak match, named arguments, union types)
Medoo ORM â€” prepared statements bez wyjÄ…tkĂłw
Redis wymagany dla cache

Business Constraints

System wdraĹĽany u klientĂłw jako update package (ZIP)

Key Decisions

Decision	Rationale	Date	Status
DDD + DI zamiast legacy architektury	TestowalnoĹ›Ä‡, separacja odpowiedzialnoĹ›ci	2025	Active
PHP < 8.0 kompatybilnoĹ›Ä‡	Klienci na starszych serwerach	2025	Active
WĹ‚asny silnik zamiast frameworka	PeĹ‚na kontrola, brak narzutĂłw	-	Active
`id` w tabbed FormEdit przez `hiddenFields`	Zapobiega insert zamiast update przy edycji encji	2026-04-18	Active

Success Metrics

Metric	Target	Current	Status
Testy	>800	821	On track
Pokrycie architektury DDD	100%	100%	Achieved

Tech Stack

Layer	Technology	Notes
Backend	PHP 7.4+	< 8.0 na produkcji
ORM	Medoo	`$mdb` global
Cache	Redis	CacheHandler singleton
Frontend	HTML/CSS/JS	WĹ‚asny silnik szablonĂłw (Tpl)
Auth	Sesje PHP	CSRF, XSS protection
Testy	PHPUnit 9.6	phpunit.phar

Specialized Flows

See: .paul/SPECIAL-FLOWS.md

Quick Reference:

/feature-dev â†’ Nowe funkcje, wiÄ™ksze zmiany (required)
/koniec-pracy â†’ Release, update package (required)
/frontend-design â†’ Komponenty UI, szablony widokĂłw
/code-review â†’ PrzeglÄ…d kodu przed release
/simplify â†’ Upraszczanie po implementacji
/claude-md-improver â†’ Utrzymanie CLAUDE.md
/zapisz + /wznow â†’ Zapis i wznowienie sesji

PROJECT.md â€” Updated when requirements or context change Last updated: 2026-04-18 after Phase 15

4.0 KiB Raw Blame History Unescape Escape