# dodotiso/cartlify-deploy architecture

> Architecture diagram of the GitHub repository dodotiso/cartlify-deploy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dodotiso/cartlify-deploy
- Repository: https://github.com/dodotiso/cartlify-deploy

## Overview

Cartlify is a Symfony commerce application with web and mobile/API entry points for browsing products, managing carts, placing orders, and administering catalog, stock, users, and activity. The central buyer path is exposed through cart/order controllers and mobile/shop APIs; order services handle customer/admin email notifications. The README provides no capability detail, so broader branches are based on the source tree and indexed module names; unsampled integrations are represented conservatively.

Main entry points: [`src/Repository`](https://github.com/dodotiso/cartlify-deploy/tree/main/src/Repository) (Doctrine repositories), [`src/Service/OrderService.php`](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Service/OrderService.php) (Order notifications), [`src/Entity/User.php`](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/User.php) (User accounts), [`src/Entity/Product.php`](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Product.php) (Product records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Shopping workflow"]
  node_web["Web storefront"]
  node_mobileapi["Mobile shop API"]
  node_mobilecart["Mobile cart API"]
  node_mobileorders["Mobile order API"]
  node_cart["Cart handling<br/>[CartController.php]"]
  node_checkout["Checkout"]
  node_orderctrl["Order management"]
  node_ordersvc["Order notifications<br/>[OrderService.php]"]
end

subgraph group_catalog["Catalog and inventory"]
  node_products["Product management"]
  node_stockctrl["Stock management"]
  node_categories["Categories<br/>[Category.php]"]
end

subgraph group_identity["Accounts and access"]
  node_auth["Authentication"]
  node_googleauth["Google sign-in"]
  node_verification["Email verification"]
  node_users["User accounts<br/>[User.php]"]
end

subgraph group_operations["Store operations"]
  node_dashboard["Admin dashboard"]
  node_customers["Customer management"]
  node_activity["Activity logging"]
  node_mercure["Live notifications"]
end

subgraph group_persistence["Domain and persistence"]
  node_productentity["Product records<br/>[Product.php]"]
  node_stockentity["Stock records<br/>[Stock.php]"]
  node_cartentity["Cart records<br/>[Cart.php]"]
  node_orderentity["Order records<br/>[Order.php]"]
  node_repo[("Doctrine repositories")]
end

node_buyer(("Buyer"))
node_mailer["Email service"]

node_buyer -.->|"browses"| node_web
node_buyer -->|"browses"| node_mobileapi
node_mobileapi -->|"reads stock"| node_repo
node_buyer -.->|"manages cart"| node_cart
node_buyer -.->|"manages cart"| node_mobilecart
node_mobilecart -->|"reads stock"| node_repo
node_mobilecart -->|"updates cart"| node_cartentity
node_cart -->|"uses stock"| node_repo
node_cart -->|"requests order mail"| node_ordersvc
node_buyer -.->|"checks out"| node_checkout
node_checkout -.->|"notifies"| node_ordersvc
node_buyer -.->|"places orders"| node_mobileorders
node_mobileorders -->|"uses order service"| node_ordersvc
node_mobileorders -->|"reads orders"| node_repo
node_buyer -.->|"tracks orders"| node_orderctrl
node_orderctrl -->|"sends status mail"| node_ordersvc
node_ordersvc -->|"sends email"| node_mailer
node_products -->|"manages"| node_productentity
node_products -->|"uses category form"| node_categories
node_stockctrl -.->|"manages stock"| node_repo
node_dashboard -->|"reads metrics"| node_repo
node_customers -.->|"manages users"| node_repo
node_auth -.->|"authenticates"| node_users
node_googleauth -->|"resolves account"| node_users
node_verification -->|"updates verification"| node_users
node_activity -->|"records activity"| node_repo
node_web -.->|"presents products"| node_productentity
node_repo -->|"persists"| node_productentity
node_repo -->|"persists"| node_stockentity
node_repo -->|"persists"| node_orderentity
node_repo -->|"persists"| node_users
node_orderentity -->|"references stock"| node_stockentity
node_stockentity -->|"references product"| node_productentity
node_mercure -.->|"publishes updates"| node_buyer

click node_web "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/FrontProductController.php"
click node_mobileapi "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/ShopApiController.php"
click node_mobilecart "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MobileCartController.php"
click node_mobileorders "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MobileOrderController.php"
click node_cart "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CartController.php"
click node_checkout "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CheckoutController.php"
click node_orderctrl "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/OrderController.php"
click node_ordersvc "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Service/OrderService.php"
click node_products "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/ProductController.php"
click node_stockctrl "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/StockController.php"
click node_categories "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Category.php"
click node_auth "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Security/LoginAuthenticator.php"
click node_googleauth "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Security/GoogleAuthenticator.php"
click node_verification "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Service/EmailVerificationService.php"
click node_users "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/User.php"
click node_dashboard "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/DashboardController.php"
click node_customers "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CustomerManagementController.php"
click node_activity "https://github.com/dodotiso/cartlify-deploy/blob/main/src/EventSubscriber/ActivityLogSubscriber.php"
click node_mercure "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MercureController.php"
click node_productentity "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Product.php"
click node_stockentity "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Stock.php"
click node_cartentity "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Cart.php"
click node_orderentity "https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Order.php"
click node_repo "https://github.com/dodotiso/cartlify-deploy/tree/main/src/Repository"

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_web,node_mobileapi,node_mobilecart,node_mobileorders,node_cart,node_checkout,node_orderctrl,node_ordersvc toneBlue
class node_products,node_stockctrl,node_categories toneAmber
class node_auth,node_googleauth,node_verification,node_users toneMint
class node_dashboard,node_customers,node_activity,node_mercure toneRose
class node_productentity,node_stockentity,node_cartentity,node_orderentity,node_repo,node_buyer,node_mailer toneIndigo
```

## Components

### Shopping workflow

- [Web storefront](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/FrontProductController.php): `src/Controller/FrontProductController.php`
- [Mobile shop API](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/ShopApiController.php): `src/Controller/Api/ShopApiController.php`
- [Mobile cart API](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MobileCartController.php): `src/Controller/Api/MobileCartController.php`
- [Mobile order API](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MobileOrderController.php): `src/Controller/Api/MobileOrderController.php`
- [Cart handling](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CartController.php): `src/Controller/CartController.php`
- [Checkout](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CheckoutController.php): `src/Controller/CheckoutController.php`
- [Order management](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/OrderController.php): `src/Controller/OrderController.php`
- [Order notifications](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Service/OrderService.php): `src/Service/OrderService.php`

### Catalog and inventory

- [Product management](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/ProductController.php): `src/Controller/ProductController.php`
- [Stock management](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/StockController.php): `src/Controller/StockController.php`
- [Categories](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Category.php): `src/Entity/Category.php`

### Accounts and access

- [Authentication](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Security/LoginAuthenticator.php): `src/Security/LoginAuthenticator.php`
- [Google sign-in](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Security/GoogleAuthenticator.php): `src/Security/GoogleAuthenticator.php`
- [Email verification](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Service/EmailVerificationService.php): `src/Service/EmailVerificationService.php`
- [User accounts](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/User.php): `src/Entity/User.php`

### Store operations

- [Admin dashboard](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/DashboardController.php): `src/Controller/DashboardController.php`
- [Customer management](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/CustomerManagementController.php): `src/Controller/CustomerManagementController.php`
- [Activity logging](https://github.com/dodotiso/cartlify-deploy/blob/main/src/EventSubscriber/ActivityLogSubscriber.php): `src/EventSubscriber/ActivityLogSubscriber.php`
- [Live notifications](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Controller/Api/MercureController.php): `src/Controller/Api/MercureController.php`

### Domain and persistence

- [Product records](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Product.php): `src/Entity/Product.php`
- [Stock records](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Stock.php): `src/Entity/Stock.php`
- [Cart records](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Cart.php): `src/Entity/Cart.php`
- [Order records](https://github.com/dodotiso/cartlify-deploy/blob/main/src/Entity/Order.php): `src/Entity/Order.php`
- [Doctrine repositories](https://github.com/dodotiso/cartlify-deploy/tree/main/src/Repository): `src/Repository`

### Other components

- **Buyer**
- **Email service**

## Connections

- Buyer → Web storefront: browses
- Buyer → Mobile shop API: browses (evidence: `src/Controller/Api/ShopApiController.php`)
- Mobile shop API → Doctrine repositories: reads stock (evidence: `src/Controller/Api/ShopApiController.php`)
- Buyer → Cart handling: manages cart
- Buyer → Mobile cart API: manages cart
- Mobile cart API → Doctrine repositories: reads stock (evidence: `src/Controller/Api/MobileCartController.php`)
- Mobile cart API → Cart records: updates cart (evidence: `src/Controller/Api/MobileCartController.php`)
- Cart handling → Doctrine repositories: uses stock (evidence: `src/Controller/CartController.php`)
- Cart handling → Order notifications: requests order mail (evidence: `src/Controller/CartController.php`)
- Buyer → Checkout: checks out
- Checkout → Order notifications: notifies
- Buyer → Mobile order API: places orders
- Mobile order API → Order notifications: uses order service (evidence: `src/Controller/Api/MobileOrderController.php`)
- Mobile order API → Doctrine repositories: reads orders (evidence: `src/Controller/Api/MobileOrderController.php`)
- Buyer → Order management: tracks orders
- Order management → Order notifications: sends status mail (evidence: `src/Controller/OrderController.php`)
- Order notifications → Email service: sends email (evidence: `src/Service/OrderService.php`)
- Product management → Product records: manages (evidence: `src/Controller/ProductController.php`)
- Product management → Categories: uses category form (evidence: `src/Controller/ProductController.php`)
- Stock management → Doctrine repositories: manages stock
- Admin dashboard → Doctrine repositories: reads metrics (evidence: `src/Controller/DashboardController.php`)
- Customer management → Doctrine repositories: manages users
- Authentication → User accounts: authenticates
- Google sign-in → User accounts: resolves account (evidence: `src/Security/GoogleAuthenticator.php`)
- Email verification → User accounts: updates verification (evidence: `src/Service/EmailVerificationService.php`)
- Activity logging → Doctrine repositories: records activity (evidence: `src/EventSubscriber/ActivityLogSubscriber.php`)
- Web storefront → Product records: presents products
- Doctrine repositories → Product records: persists (evidence: `src/Repository/ProductRepository.php`)
- Doctrine repositories → Stock records: persists (evidence: `src/Repository/StockRepository.php`)
- Doctrine repositories → Order records: persists (evidence: `src/Repository/OrderRepository.php`)
- Doctrine repositories → User accounts: persists (evidence: `src/Repository/UserRepository.php`)
- Order records → Stock records: references stock (evidence: `src/Entity/Order.php`)
- Stock records → Product records: references product (evidence: `src/Entity/Stock.php`)
- Live notifications → Buyer: publishes updates
