pomysloweprezenty.pl/.planning/PROJECT.md

PomyslowePrezenty.pl

What This Is

Autorski sklep internetowy zbudowany od zera na własnym CMS/frameworku w PHP z vanilla JavaScript. Działa produkcyjnie, obsługuje klientów i zamówienia. Platforma obejmuje panel administracyjny, system zarządzania produktami, koszyk, zamówienia, płatności, transport, promocje, kupony oraz integracje z zewnętrznymi serwisami (Apilo, ShopPro).

Core Value

Sklep musi działać stabilnie i bezbłędnie — klienci mogą bez problemów przeglądać produkty, składać zamówienia i płacić.

Requirements

Validated

• ✓ System zarządzania produktami (katalog, warianty, kombinacje) — existing
• ✓ Koszyk zakupowy i proces składania zamówień — existing
• ✓ Panel administracyjny z zarządzaniem produktami, kategoriami, zamówieniami — existing
• ✓ System płatności — existing
• ✓ System transportu/dostawy — existing
• ✓ System promocji i kuponów — existing
• ✓ System kont klientów (rejestracja, logowanie, odzyskiwanie hasła) — existing
• ✓ System artykułów/newsów — existing
• ✓ Newsletter — existing
• ✓ Integracje z Apilo i ShopPro — existing
• ✓ File manager w panelu admina — existing
• ✓ System kategorii sklepowych — existing
• ✓ Wyszukiwarka produktów — existing
• ✓ System producentów — existing

Active

• Naprawa znanych bugów w logice sklepu (koszyk, zamówienia, płatności)
• Stabilizacja i poprawa niezawodności istniejących funkcji

Out of Scope

• Nowe funkcje — zostaną zaplanowane w osobnym milestone po stabilizacji
• Redesign frontend — obecny wygląd jest akceptowalny
• Migracja na framework — projekt zostaje na autorskim rozwiązaniu

Context

• Stack: PHP (autorski CMS/framework) + vanilla JavaScript + SCSS
• Baza danych: MySQL (domniemanie na podstawie typowego stacku PHP)
• Struktura: autoload/ (Domain, Shared, admin, api), templates/, admin/
• Projekt ma integracje z zewnętrznymi platformami: Apilo, ShopPro
• API: własny router API z kontrolerami (Products, Categories)
• Sklep działa produkcyjnie z prawdziwymi klientami
• Znane bugi dotyczą głównie logiki sklepowej (koszyk, zamówienia, płatności)

Constraints

• Stack: PHP + vanilla JS — bez frameworków, autorskie rozwiązanie
• Produkcja: Sklep działa live — zmiany muszą być bezpieczne i backwards-compatible
• Stabilność: Priorytet to naprawa bugów, nie dodawanie nowych funkcji

Key Decisions

Decision	Rationale	Outcome
Bugfix-first approach	Sklep działa produkcyjnie, bugi wpływają na klientów	— Pending
Nowe funkcje odłożone	Najpierw stabilizacja, potem rozwój	— Pending

---

Last updated: 2026-03-10 after initialization