From 8ca953646b271adf5a97f02f6a34e75add966d52 Mon Sep 17 00:00:00 2001
From: Jacek Pyziak <jacek.pyziak@project-pro.pl>
Date: Tue, 10 Mar 2026 21:22:26 +0100
Subject: [PATCH] docs: initialize project

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .planning/PROJECT.md | 69 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 .planning/PROJECT.md

diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md
new file mode 100644
index 0000000..8eb4cdd
--- /dev/null
+++ b/.planning/PROJECT.md
@@ -0,0 +1,69 @@
+# 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
+
+<!-- Shipped and confirmed valuable. -->
+
+- ✓ 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
+
+<!-- Current scope. Building toward these. -->
+
+- [ ] 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*