# catamc90/auto-parts-catalog architecture

> Architecture diagram of the GitHub repository catamc90/auto-parts-catalog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/catamc90/auto-parts-catalog
- Repository: https://github.com/catamc90/auto-parts-catalog

## Overview

##### Project Type and Purpose
- This is a full-stack web application built on Symfony 7.1.
- It consumes an external Auto Parts Catalog API (via RapidAPI) to display part identification, cross-referencing, compatibility, and ordering data.
- It follows the MVC (Model-View-Controller) pattern with Twig templates for views and Doctrine ORM for persistence.

##### Main Components
A. Client (Browser)
– HTML/CSS/JS delivered by Symfony’s AssetMapper & Importmap.
– Interactive UI controllers under assets/controllers/*.js.
– Twig templates under templates/ generate UI markup.
B. Web Server / Entry Point
– public/index.php → Bootstraps Symfony Kernel.
– Symfony HTTP kernel handles routing & middleware.
C. Controllers (src/Controller)
– HomeController, ManufacturersController, ModelsController, TypesController, CategoryController, ArticlesController.
– Each maps routes (config/routes.yaml) to actions that orchestrate data flows.
D. Services / API Clients (src/Api)
– CatalogApi.php: encapsulates HTTP calls to the external RapidAPI Auto Parts Catalog.
– RapidBaseApi.php: base client for handling authentication, request/response logic.
E. Domain Layer
– Entities (src/Entity): Doctrine entities for local persistence of catalogs, caching or any domain objects you choose to store.
– Repositories (src/Repository): data access layer for Entities.
– Form Types (src/Form/Type): define form schema for search, language selection, quick-search.
F. Persistence & Caching
– Database (configured under config/packages/doctrine.yaml).
– Doctrine Migrations (migrations/) for schema evolution.
G. Infrastructure & Cross-Cutting Concerns
– Security (config/packages/security.yaml) if user auth is needed.
– Messenger (config/packages/messenger.yaml) for async tasks (e.g., batch imports).
– Monolog (logging), Mailer, Notifier, Web Profiler, etc.
H. External Dependencies
– RapidAPI Auto Parts Catalog API.
– Any third-party services configured in .env (RAPIDAPI_KEY).

##### Relationships & Data Flow
1. User → Browser UI (Twig + JS)
2. Browser → HTTP Request → public/index.php → Symfony Kernel
3. Kernel → Router → Appropriate Controller
4. Controller
a. Validates input (Forms, Validators).
b. Invokes CatalogApi service or local Repository.
c. Persists or caches results if needed.
d. Passes data to Twig template.
5. Twig → Renders HTML → Response → Browser
6. Browser → Displays UI; optional AJAX calls to controllers (via asset JS controllers).
7. Service calls → External API → API responses → Service layer → Controller.

##### Architectural Patterns & Principles
- MVC: clear separation of Models (Entities), Views (Twig), Controllers.
- Service Layer: CatalogApi encapsulates all external API logic.
- Dependency Injection: Symfony services defined in config/services.yaml.
- Layered Architecture: Presentation → Application → Domain → Infrastructure.
- Config-First: YAML config for routing, services, packages.
- Asset Management: Importmap + AssetMapper decouples JS/CSS delivery.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        Assets["Assets (JS/CSS)"]:::frontend
        Templates["Twig Templates"]:::frontend
        Browser["Browser"]:::frontend
    end

    %% Web Server Entry
    subgraph "Web Server & Routing"
        Index["public/index.php"]:::backend
        Kernel["src/Kernel.php"]:::backend
        Router["config/routes.yaml"]:::backend
    end

    %% Controllers
    subgraph "Controllers (src/Controller)"
        HomeCtrl["HomeController.php"]:::backend
        MfrCtrl["ManufacturersController.php"]:::backend
        ModelCtrl["ModelsController.php"]:::backend
        TypeCtrl["TypesController.php"]:::backend
        CatCtrl["CategoryController.php"]:::backend
        ArtCtrl["ArticlesController.php"]:::backend
    end

    %% Service Layer
    subgraph "API Clients (src/Api)"
        CatalogApi["CatalogApi.php"]:::backend
        RapidBaseApi["RapidBaseApi.php"]:::backend
    end

    %% Domain Layer
    subgraph "Domain Layer"
        Entities["Entities"]:::domain
        Repos["Repositories"]:::domain
        Forms["Form Types"]:::domain
    end

    %% Persistence & Cache
    subgraph "Persistence & Caching"
        DB["Database"]:::persistence
        Migrations["migrations/"]:::persistence
        Cache["Cache (config/packages/cache.yaml)"]:::persistence
    end

    %% Infrastructure & Config
    subgraph "Infrastructure & Config"
        ServicesCfg["config/services.yaml"]:::infra
        DoctrineCfg["config/packages/doctrine.yaml"]:::infra
        MessengerCfg["config/packages/messenger.yaml"]:::infra
        SecurityCfg["config/packages/security.yaml"]:::infra
        MonologCfg["config/packages/monolog.yaml"]:::infra
        MailerCfg["config/packages/mailer.yaml"]:::infra
        AssetMapperCfg["config/packages/asset_mapper.yaml"]:::infra
        EnvFile[".env"]:::infra
    end

    %% External API
    External["RapidAPI Auto Parts Catalog"]:::external

    %% Flows
    Assets -->|served to| Browser
    Browser -->|HTTP Request| Index
    Index --> Kernel
    Kernel -->|loads routes| Router
    Router -->|dispatch to| HomeCtrl
    Router --> ManufacturersController["ManufacturersController.php"]
    Router --> ModelsController["ModelsController.php"]
    Router --> TypesController["TypesController.php"]
    Router --> CategoryController["CategoryController.php"]
    Router --> ArticlesController["ArticlesController.php"]

    HomeCtrl -->|renders| Templates
    MfrCtrl --> Templates
    ModelCtrl --> Templates
    TypeCtrl --> Templates
    CatCtrl --> Templates
    ArtCtrl --> Templates
    Templates -->|HTML Response| Browser

    HomeCtrl -->|uses| CatalogApi
    MfrCtrl --> CatalogApi
    ModelCtrl --> CatalogApi
    TypeCtrl --> CatalogApi
    CatCtrl --> CatalogApi
    ArtCtrl --> CatalogApi

    CatalogApi --> RapidBaseApi
    RapidBaseApi -->|API Call| External
    CatalogApi -->|cache results| Cache

    HomeCtrl -->|db ops| Repos
    MfrCtrl --> Repos
    ModelCtrl --> Repos
    TypeCtrl --> Repos
    CatCtrl --> Repos
    ArtCtrl --> Repos

    Repos --> Entities
    Entities --> DB
    Migrations --> DB

    HomeCtrl -.->|async tasks| MessengerCfg

    %% Config dependencies
    Kernel --> ServicesCfg
    Kernel --> DoctrineCfg
    Kernel --> SecurityCfg
    Kernel --> MessengerCfg
    Kernel --> MonologCfg
    Kernel --> MailerCfg
    Kernel --> AssetMapperCfg
    EnvFile -.-> RapidBaseApi

    %% Click Events
    click Assets "https://github.com/catamc90/auto-parts-catalog/tree/master/assets/"
    click Templates "https://github.com/catamc90/auto-parts-catalog/tree/master/templates/"
    click Index "https://github.com/catamc90/auto-parts-catalog/blob/master/public/index.php"
    click Kernel "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Kernel.php"
    click Router "https://github.com/catamc90/auto-parts-catalog/blob/master/config/routes.yaml"
    click HomeCtrl "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/HomeController.php"
    click ManufacturersController "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/ManufacturersController.php"
    click ModelsController "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/ModelsController.php"
    click TypesController "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/TypesController.php"
    click CategoryController "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/CategoryController.php"
    click ArticlesController "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Controller/ArticlesController.php"
    click CatalogApi "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Api/CatalogApi.php"
    click RapidBaseApi "https://github.com/catamc90/auto-parts-catalog/blob/master/src/Api/RapidBaseApi.php"
    click Entities "https://github.com/catamc90/auto-parts-catalog/tree/master/src/Entity/"
    click Repos "https://github.com/catamc90/auto-parts-catalog/tree/master/src/Repository/"
    click Forms "https://github.com/catamc90/auto-parts-catalog/tree/master/src/Form/Type/"
    click Migrations "https://github.com/catamc90/auto-parts-catalog/tree/master/migrations/"
    click Cache "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/cache.yaml"
    click ServicesCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/services.yaml"
    click DoctrineCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/doctrine.yaml"
    click MessengerCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/messenger.yaml"
    click SecurityCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/security.yaml"
    click MonologCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/monolog.yaml"
    click MailerCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/mailer.yaml"
    click AssetMapperCfg "https://github.com/catamc90/auto-parts-catalog/blob/master/config/packages/asset_mapper.yaml"
    click EnvFile "https://github.com/catamc90/auto-parts-catalog/blob/master/.env"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#D8F3DC,stroke:#2E7D32,color:#2E7D32;
    classDef domain fill:#FFF3CD,stroke:#D48806,color:#D48806;
    classDef persistence fill:#FEE2E2,stroke:#B91C1C,color:#B91C1C;
    classDef infra fill:#E5E7EB,stroke:#6B7280,color:#6B7280;
    classDef external fill:#F3F4F6,stroke:#374151,color:#374151;
```
