# maciejdrywa/prestashop-website architecture

> Architecture diagram of the GitHub repository maciejdrywa/prestashop-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maciejdrywa/prestashop-website
- Repository: https://github.com/maciejdrywa/prestashop-website

## Overview

To Twoje Drzwi do Sukcesu: edukacyjny sklep PrestaShop z Pythonowym scraperem i importerami katalogu. Główna ścieżka to pobranie i parsowanie danych źródłowego sklepu, przygotowanie kategorii, produktów i galerii, a następnie synchronizacja przez PrestaShop Webservice i weryfikacja/aktywacja. PHP inicjalizuje i konfiguruje sklep; jego moduły dodają funkcje storefrontu, płatności demonstracyjnych i informacji o cenach. Krawędzie odzwierciedlają README i widoczne referencje SOURCE INDEX; niesampled implementacje pozostawiono na poziomie ich istniejących katalogów.

Main entry points: [`scraper/catalog_import/runner.py`](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/catalog_import/runner.py) (Import katalogu), [`scraper/prestashop_api.py`](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/prestashop_api.py) (Klient Webservice), [`scraper/Scrapping_products/store_crawler.py`](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/store_crawler.py) (Crawler katalogu), [`scraper/Scrapping_products/parse_product.py`](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/parse_product.py) (Parser produktu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scraping["Scraping danych"]
  node_crawler["Crawler katalogu<br/>[store_crawler.py]"]
  node_discovery["Odkrywanie kategorii"]
  node_product_parser["Parser produktu<br/>[parse_product.py]"]
  node_parse_fields["Ekstraktory pól"]
  node_image_parser["Parser galerii<br/>[scrap_images.py]"]
end

subgraph group_importing["Import katalogu"]
  node_catalog_runner["Import katalogu<br/>[runner.py]"]
  node_category_mapping["Mapowanie kategorii<br/>[mapping.py]"]
  node_category_validation["Walidacja kategorii<br/>[validator.py]"]
  node_category_sync["Synchronizacja kategorii<br/>[prestashop_sync.py]"]
  node_product_planning["Planowanie produktów<br/>[planning.py]"]
  node_product_resources["Zasoby i schematy<br/>[resources.py]"]
  node_product_sync["Synchronizacja produktów<br/>[sync.py]"]
  node_image_cache["Cache zdjęć<br/>[cache.py]"]
  node_image_planning["Plan galerii<br/>[planning.py]"]
  node_image_sync["Synchronizacja galerii<br/>[sync.py]"]
  node_import_state[("Dziennik importu<br/>[import_state.py]")]
  node_api_client["Klient Webservice<br/>[prestashop_api.py]"]
end

subgraph group_store["Sklep PrestaShop"]
  node_php_bootstrap["Inicjalizacja sklepu<br/>[bootstrap.php]"]
  node_php_prestashop["Integracja PrestaShop<br/>[prestashop.php]"]
  node_php_webservice["Konfiguracja API<br/>[webservice.php]"]
  node_shop["Sklep internetowy"]
end

subgraph group_extensions["Moduły sklepu"]
  node_cookie_module["Informacja cookies<br/>[shopcookieinfo.php]"]
  node_payments_module["Płatności demo"]
  node_omnibus_module["Ceny Omnibus<br/>[shopomnibus.php]"]
  node_pagination_module["Paginacja kategorii"]
end

node_operator(("Operator"))
node_source_shop(("Sklep źródłowy"))

node_operator -->|"uruchamia scraping"| node_crawler
node_source_shop -.->|"udostępnia katalog"| node_crawler
node_crawler -->|"odkrywa kategorie"| node_discovery
node_crawler -->|"parsuje produkty"| node_product_parser
node_product_parser -->|"wykorzystuje ekstraktory"| node_parse_fields
node_product_parser -->|"wyodrębnia galerie"| node_image_parser
node_operator -->|"uruchamia import"| node_catalog_runner
node_catalog_runner -->|"waliduje kategorie"| node_category_validation
node_catalog_runner -->|"używa mapowania"| node_category_mapping
node_catalog_runner -->|"synchronizuje kategorie"| node_category_sync
node_catalog_runner -->|"planuje produkty"| node_product_planning
node_catalog_runner -->|"używa zasobów API"| node_product_resources
node_catalog_runner -->|"synchronizuje produkty"| node_product_sync
node_catalog_runner -->|"przygotowuje zdjęcia"| node_image_cache
node_catalog_runner -->|"planuje galerie"| node_image_planning
node_catalog_runner -->|"synchronizuje galerie"| node_image_sync
node_catalog_runner -->|"wznawia stan"| node_import_state
node_catalog_runner -->|"komunikuje się"| node_api_client
node_category_sync -->|"wywołuje API"| node_api_client
node_product_sync -->|"wywołuje API"| node_api_client
node_image_sync -->|"wywołuje API"| node_api_client
node_image_sync -->|"zapisuje postęp"| node_import_state
node_api_client -->|"zapisuje przez Webservice"| node_shop
node_operator -->|"inicjalizuje sklep"| node_php_bootstrap
node_php_bootstrap -->|"wykorzystuje integrację"| node_php_prestashop
node_php_bootstrap -->|"przygotowuje instalację"| node_shop
node_php_webservice -->|"konfiguruje dostęp API"| node_shop
node_shop -.->|"udostępnia moduł"| node_cookie_module
node_shop -.->|"udostępnia moduł"| node_payments_module
node_shop -.->|"udostępnia moduł"| node_omnibus_module
node_shop -.->|"udostępnia moduł"| node_pagination_module

click node_crawler "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/store_crawler.py"
click node_discovery "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/catalog_discovery.py"
click node_product_parser "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/parse_product.py"
click node_parse_fields "https://github.com/maciejdrywa/prestashop-website/tree/main/scraper/scraper_elements"
click node_image_parser "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/scraper_elements/scrap_images.py"
click node_catalog_runner "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/catalog_import/runner.py"
click node_category_mapping "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/mapping.py"
click node_category_validation "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/validator.py"
click node_category_sync "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/prestashop_sync.py"
click node_product_planning "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/planning.py"
click node_product_resources "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/resources.py"
click node_product_sync "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/sync.py"
click node_image_cache "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/cache.py"
click node_image_planning "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/planning.py"
click node_image_sync "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/sync.py"
click node_import_state "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/import_state.py"
click node_api_client "https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/prestashop_api.py"
click node_php_bootstrap "https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/bootstrap.php"
click node_php_prestashop "https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/init/lib/prestashop.php"
click node_php_webservice "https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/init/lib/webservice.php"
click node_cookie_module "https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopcookieinfo/shopcookieinfo.php"
click node_payments_module "https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopdemopayments/shopdemopayments.php"
click node_omnibus_module "https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopomnibus/shopomnibus.php"
click node_pagination_module "https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopcategorypagination/shopcategorypagination.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_crawler,node_discovery,node_product_parser,node_parse_fields,node_image_parser toneBlue
class node_catalog_runner,node_category_mapping,node_category_validation,node_category_sync,node_product_planning,node_product_resources,node_product_sync,node_image_cache,node_image_planning,node_image_sync,node_import_state,node_api_client toneAmber
class node_php_bootstrap,node_php_prestashop,node_php_webservice,node_shop toneMint
class node_cookie_module,node_payments_module,node_omnibus_module,node_pagination_module toneRose
class node_operator,node_source_shop toneIndigo
```

## Components

### Scraping danych

- [Crawler katalogu](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/store_crawler.py): `scraper/Scrapping_products/store_crawler.py`
- [Odkrywanie kategorii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/catalog_discovery.py): `scraper/Scrapping_products/catalog_discovery.py`
- [Parser produktu](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/Scrapping_products/parse_product.py): `scraper/Scrapping_products/parse_product.py`
- [Ekstraktory pól](https://github.com/maciejdrywa/prestashop-website/tree/main/scraper/scraper_elements): `scraper/scraper_elements`
- [Parser galerii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/scraper_elements/scrap_images.py): `scraper/scraper_elements/scrap_images.py`

### Import katalogu

- [Import katalogu](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/catalog_import/runner.py): `scraper/catalog_import/runner.py`
- [Mapowanie kategorii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/mapping.py): `scraper/category_import/mapping.py`
- [Walidacja kategorii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/validator.py): `scraper/category_import/validator.py`
- [Synchronizacja kategorii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/category_import/prestashop_sync.py): `scraper/category_import/prestashop_sync.py`
- [Planowanie produktów](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/planning.py): `scraper/product_import/planning.py`
- [Zasoby i schematy](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/resources.py): `scraper/product_import/resources.py`
- [Synchronizacja produktów](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/product_import/sync.py): `scraper/product_import/sync.py`
- [Cache zdjęć](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/cache.py): `scraper/image_import/cache.py`
- [Plan galerii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/planning.py): `scraper/image_import/planning.py`
- [Synchronizacja galerii](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/image_import/sync.py): `scraper/image_import/sync.py`
- [Dziennik importu](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/import_state.py): `scraper/import_state.py`
- [Klient Webservice](https://github.com/maciejdrywa/prestashop-website/blob/main/scraper/prestashop_api.py): `scraper/prestashop_api.py`

### Sklep PrestaShop

- [Inicjalizacja sklepu](https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/bootstrap.php): `deploy/bootstrap.php`
- [Integracja PrestaShop](https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/init/lib/prestashop.php): `deploy/init/lib/prestashop.php`
- [Konfiguracja API](https://github.com/maciejdrywa/prestashop-website/blob/main/deploy/init/lib/webservice.php): `deploy/init/lib/webservice.php`
- **Sklep internetowy**

### Moduły sklepu

- [Informacja cookies](https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopcookieinfo/shopcookieinfo.php): `shop/modules/shopcookieinfo/shopcookieinfo.php`
- [Płatności demo](https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopdemopayments/shopdemopayments.php): `shop/modules/shopdemopayments/shopdemopayments.php`
- [Ceny Omnibus](https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopomnibus/shopomnibus.php): `shop/modules/shopomnibus/shopomnibus.php`
- [Paginacja kategorii](https://github.com/maciejdrywa/prestashop-website/blob/main/shop/modules/shopcategorypagination/shopcategorypagination.php): `shop/modules/shopcategorypagination/shopcategorypagination.php`

### Other components

- **Operator**
- **Sklep źródłowy**

## Connections

- Operator → Crawler katalogu: uruchamia scraping
- Sklep źródłowy → Crawler katalogu: udostępnia katalog
- Crawler katalogu → Odkrywanie kategorii: odkrywa kategorie (evidence: `scraper/Scrapping_products/store_crawler.py`)
- Crawler katalogu → Parser produktu: parsuje produkty (evidence: `scraper/Scrapping_products/store_crawler.py`)
- Parser produktu → Ekstraktory pól: wykorzystuje ekstraktory (evidence: `scraper/Scrapping_products/parse_product.py`)
- Parser produktu → Parser galerii: wyodrębnia galerie (evidence: `scraper/Scrapping_products/parse_product.py`)
- Operator → Import katalogu: uruchamia import
- Import katalogu → Walidacja kategorii: waliduje kategorie (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Mapowanie kategorii: używa mapowania
- Import katalogu → Synchronizacja kategorii: synchronizuje kategorie
- Import katalogu → Planowanie produktów: planuje produkty (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Zasoby i schematy: używa zasobów API (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Synchronizacja produktów: synchronizuje produkty (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Cache zdjęć: przygotowuje zdjęcia (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Plan galerii: planuje galerie (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Synchronizacja galerii: synchronizuje galerie (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Dziennik importu: wznawia stan (evidence: `scraper/catalog_import/runner.py`)
- Import katalogu → Klient Webservice: komunikuje się (evidence: `scraper/catalog_import/runner.py`)
- Synchronizacja kategorii → Klient Webservice: wywołuje API (evidence: `scraper/category_import/prestashop_sync.py`)
- Synchronizacja produktów → Klient Webservice: wywołuje API (evidence: `scraper/product_import/sync.py`)
- Synchronizacja galerii → Klient Webservice: wywołuje API (evidence: `scraper/image_import/sync.py`)
- Synchronizacja galerii → Dziennik importu: zapisuje postęp (evidence: `scraper/image_import/sync.py`)
- Klient Webservice → Sklep internetowy: zapisuje przez Webservice
- Operator → Inicjalizacja sklepu: inicjalizuje sklep
- Inicjalizacja sklepu → Integracja PrestaShop: wykorzystuje integrację (evidence: `deploy/bootstrap.php`)
- Inicjalizacja sklepu → Sklep internetowy: przygotowuje instalację
- Konfiguracja API → Sklep internetowy: konfiguruje dostęp API
- Sklep internetowy → Informacja cookies: udostępnia moduł
- Sklep internetowy → Płatności demo: udostępnia moduł
- Sklep internetowy → Ceny Omnibus: udostępnia moduł
- Sklep internetowy → Paginacja kategorii: udostępnia moduł
