Refactor code structure for improved readability and maintainability

DATABASE_STRUCTURE.md

@@ -0,0 +1,107 @@
+# Struktura bazy danych shopPRO
+
+Plik aktualizowany na bieżąco przy zmianach w kodzie.
+ORM: Medoo (`$mdb`), prefix tabel: `pp_`
+
+## pp_shop_products
+Główna tabela produktów.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| parent_id | FK do produktu nadrzędnego (kombinacje) - NULL dla produktów głównych |
+| price_brutto | Cena brutto |
+| price_brutto_promo | Cena promocyjna brutto |
+| quantity | Stan magazynowy |
+| status | Status: 1 = aktywny, 0 = nieaktywny |
+| archive | Archiwum: 1 = zarchiwizowany, 0 = aktywny |
+| promoted | Czy promowany |
+| vat | Stawka VAT |
+| ean | Kod EAN |
+| sku | Kod SKU |
+| baselinker_product_name | Nazwa produktu w Baselinker |
+| apilo_product_name | Nazwa produktu w Apilo |
+
+**Używane w:** `Domain\Product\ProductRepository`, `admin\factory\ShopProduct`
+
+## pp_shop_products_langs
+Tłumaczenia produktów (per język).
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| product_id | FK do pp_shop_products |
+| lang_id | ID języka (np. 'pl') |
+| name | Nazwa produktu |
+
+**Używane w:** `Domain\Product\ProductRepository::getName()`
+
+## pp_shop_products_images
+Zdjęcia produktów.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| product_id | FK do pp_shop_products |
+| src | Ścieżka do pliku |
+| alt | Tekst alternatywny |
+
+## pp_shop_products_categories
+Przypisanie produktów do kategorii.
+
+| Kolumna | Opis |
+|---------|------|
+| product_id | FK do pp_shop_products |
+
+**Używane w:** `admin\factory\ShopProduct::product_delete()`
+
+## pp_banners
+Banery.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| name | Nazwa banera |
+| status | 0/1 |
+| date_start | Data rozpoczęcia |
+| date_end | Data zakończenia |
+| home_page | Czy na stronie głównej 0/1 |
+
+**Używane w:** `Domain\Banner\BannerRepository`
+
+## pp_banners_langs
+Tłumaczenia banerów.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| id_banner | FK do pp_banners |
+| id_lang | ID języka |
+| src | Ścieżka do grafiki |
+| url | URL docelowy |
+| html | Kod HTML |
+| text | Tekst |
+
+**Używane w:** `Domain\Banner\BannerRepository`
+
+## pp_articles
+Artykuły.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| status | -1 = archiwum, 0 = nieaktywny, 1 = aktywny |
+
+**Używane w:** `admin\controls\ArticlesArchive`
+
+## pp_articles_pages
+Strony artykułów.
+
+## pp_articles_langs
+Tłumaczenia artykułów.
+
+## pp_articles_images
+Zdjęcia artykułów.
+
+## pp_articles_files
+Pliki artykułów.