# johnmichaelanadon7-cmd/fymfony architecture

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

- Interactive diagram: https://gitdiagram.com/johnmichaelanadon7-cmd/fymfony
- Repository: https://github.com/johnmichaelanadon7-cmd/fymfony

## Overview

This Symfony application combines a public product catalog with an inventory-management back office. The main workflow is staff or admins entering product data, optionally uploading an image, and saving product records; the store then presents available products to visitors. Separate capabilities cover categories, user accounts and role-based access, dashboard reporting, and order/customer administration. The sampled code supports the product, account, and catalog flows; order/customer internals are represented from the tree only, so their links are marked unverified.

Main entry points: [`src/Controller/Staff/ProductController.php`](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Staff/ProductController.php) (Staff products), [`src/Controller/Admin/ProductController.php`](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/ProductController.php) (Admin products), [`src/Controller/Store/HomeController.php`](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Store/HomeController.php) (Storefront), [`src/Controller/Admin/CategoryController.php`](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/CategoryController.php) (Category management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Public Catalog"]
  node_store_home["Storefront<br/>[HomeController.php]"]
  node_catalog_templates["Store views<br/>[home.html.twig]"]
end

subgraph group_inventory["Inventory Management"]
  node_staff_products["Staff products"]
  node_admin_products["Admin products"]
  node_product_form["Product form<br/>[ProductType.php]"]
  node_image_storage["Image storage"]
  node_product_repo["Product queries"]
  node_category_admin["Category management"]
  node_category_form["Category form<br/>[CategoryType.php]"]
  node_category_repo["Category queries"]
  node_product_entity["Product records<br/>[Product.php]"]
  node_category_entity["Category records<br/>[Category.php]"]
  node_db[("Application database")]
end

subgraph group_identity["Accounts and Access"]
  node_registration["Registration"]
  node_security["Login and security"]
  node_accounts["Account settings"]
  node_user_admin["User administration<br/>[UserController.php]"]
  node_user_form["User form<br/>[UserType.php]"]
  node_user_repo["User queries<br/>[UserRepository.php]"]
  node_user_entity["User records<br/>[User.php]"]
  node_product_voter["Product permissions<br/>[ProductVoter.php]"]
end

subgraph group_operations["Operations"]
  node_dashboard["Admin dashboard"]
  node_orders["Order administration"]
  node_customers["Customer administration"]
end

node_visitor(("Store visitor"))
node_staff(("Staff member"))
node_admin(("Administrator"))

node_visitor -->|"requests catalog"| node_store_home
node_store_home -->|"queries products"| node_product_repo
node_store_home -->|"loads categories"| node_category_repo
node_store_home -->|"renders"| node_catalog_templates
node_staff -->|"manages products"| node_staff_products
node_admin -->|"manages products"| node_admin_products
node_staff_products -->|"builds forms"| node_product_form
node_admin_products -->|"builds forms"| node_product_form
node_staff_products -->|"stores images"| node_image_storage
node_admin_products -->|"stores images"| node_image_storage
node_staff_products -->|"searches products"| node_product_repo
node_admin_products -->|"searches products"| node_product_repo
node_staff_products -->|"loads categories"| node_category_repo
node_admin_products -->|"loads categories"| node_category_repo
node_admin_products -->|"loads creators"| node_user_repo
node_product_form -->|"maps fields"| node_product_entity
node_product_form -->|"selects category"| node_category_entity
node_staff_products -->|"persists products"| node_db
node_admin_products -->|"persists products"| node_db
node_category_admin -->|"builds forms"| node_category_form
node_category_admin -->|"queries categories"| node_category_repo
node_category_form -->|"maps fields"| node_category_entity
node_category_admin -.->|"persists categories"| node_db
node_registration -->|"creates accounts"| node_user_entity
node_registration -.->|"persists accounts"| node_db
node_accounts -->|"updates account"| node_user_entity
node_user_admin -->|"builds forms"| node_user_form
node_user_admin -->|"searches users"| node_user_repo
node_user_admin -->|"persists accounts"| node_db
node_user_form -->|"maps fields"| node_user_entity
node_dashboard -->|"reads product data"| node_product_repo
node_dashboard -->|"reads user data"| node_user_repo
node_staff_products -->|"checks permissions"| node_product_voter
node_admin -.->|"manages categories"| node_category_admin
node_admin -->|"manages users"| node_user_admin
node_visitor -->|"creates account"| node_registration
node_visitor -->|"signs in"| node_security
node_admin -.->|"views metrics"| node_dashboard
node_admin -.->|"manages orders"| node_orders
node_admin -.->|"manages customers"| node_customers

click node_store_home "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Store/HomeController.php"
click node_catalog_templates "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/templates/store/home.html.twig"
click node_staff_products "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Staff/ProductController.php"
click node_admin_products "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/ProductController.php"
click node_product_form "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/ProductType.php"
click node_image_storage "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Service/ProductImageStorage.php"
click node_product_repo "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/ProductRepository.php"
click node_category_admin "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/CategoryController.php"
click node_category_form "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/CategoryType.php"
click node_category_repo "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/CategoryRepository.php"
click node_product_entity "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/Product.php"
click node_category_entity "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/Category.php"
click node_registration "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/RegistrationController.php"
click node_security "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/SecurityController.php"
click node_accounts "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/AccountController.php"
click node_user_admin "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/UserController.php"
click node_user_form "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/UserType.php"
click node_user_repo "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/UserRepository.php"
click node_user_entity "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/User.php"
click node_product_voter "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Security/ProductVoter.php"
click node_dashboard "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/DashboardController.php"
click node_orders "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/OrderController.php"
click node_customers "https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/CustomerController.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_store_home,node_catalog_templates toneBlue
class node_staff_products,node_admin_products,node_product_form,node_image_storage,node_product_repo,node_category_admin,node_category_form,node_category_repo,node_product_entity,node_category_entity,node_db toneAmber
class node_registration,node_security,node_accounts,node_user_admin,node_user_form,node_user_repo,node_user_entity,node_product_voter toneMint
class node_dashboard,node_orders,node_customers toneRose
class node_visitor,node_staff,node_admin toneIndigo
```

## Components

### Public Catalog

- [Storefront](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Store/HomeController.php): `src/Controller/Store/HomeController.php`
- [Store views](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/templates/store/home.html.twig): `templates/store/home.html.twig`

### Inventory Management

- [Staff products](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Staff/ProductController.php): `src/Controller/Staff/ProductController.php`
- [Admin products](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/ProductController.php): `src/Controller/Admin/ProductController.php`
- [Product form](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/ProductType.php): `src/Form/ProductType.php`
- [Image storage](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Service/ProductImageStorage.php): `src/Service/ProductImageStorage.php`
- [Product queries](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/ProductRepository.php): `src/Repository/ProductRepository.php`
- [Category management](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/CategoryController.php): `src/Controller/Admin/CategoryController.php`
- [Category form](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/CategoryType.php): `src/Form/CategoryType.php`
- [Category queries](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/CategoryRepository.php): `src/Repository/CategoryRepository.php`
- [Product records](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/Product.php): `src/Entity/Product.php`
- [Category records](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/Category.php): `src/Entity/Category.php`
- **Application database**

### Accounts and Access

- [Registration](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/RegistrationController.php): `src/Controller/RegistrationController.php`
- [Login and security](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/SecurityController.php): `src/Controller/SecurityController.php`
- [Account settings](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/AccountController.php): `src/Controller/AccountController.php`
- [User administration](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/UserController.php): `src/Controller/Admin/UserController.php`
- [User form](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Form/UserType.php): `src/Form/UserType.php`
- [User queries](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Repository/UserRepository.php): `src/Repository/UserRepository.php`
- [User records](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Entity/User.php): `src/Entity/User.php`
- [Product permissions](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Security/ProductVoter.php): `src/Security/ProductVoter.php`

### Operations

- [Admin dashboard](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/DashboardController.php): `src/Controller/Admin/DashboardController.php`
- [Order administration](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/OrderController.php): `src/Controller/Admin/OrderController.php`
- [Customer administration](https://github.com/johnmichaelanadon7-cmd/fymfony/blob/main/src/Controller/Admin/CustomerController.php): `src/Controller/Admin/CustomerController.php`

### Other components

- **Store visitor**
- **Staff member**
- **Administrator**

## Connections

- Store visitor → Storefront: requests catalog (evidence: `src/Controller/Store/HomeController.php`)
- Storefront → Product queries: queries products (evidence: `src/Controller/Store/HomeController.php`)
- Storefront → Category queries: loads categories (evidence: `src/Controller/Store/HomeController.php`)
- Storefront → Store views: renders (evidence: `src/Controller/Store/HomeController.php`)
- Staff member → Staff products: manages products (evidence: `src/Controller/Staff/ProductController.php`)
- Administrator → Admin products: manages products (evidence: `src/Controller/Admin/ProductController.php`)
- Staff products → Product form: builds forms (evidence: `src/Controller/Staff/ProductController.php`)
- Admin products → Product form: builds forms (evidence: `src/Controller/Admin/ProductController.php`)
- Staff products → Image storage: stores images (evidence: `src/Controller/Staff/ProductController.php`)
- Admin products → Image storage: stores images (evidence: `src/Controller/Admin/ProductController.php`)
- Staff products → Product queries: searches products (evidence: `src/Controller/Staff/ProductController.php`)
- Admin products → Product queries: searches products (evidence: `src/Controller/Admin/ProductController.php`)
- Staff products → Category queries: loads categories (evidence: `src/Controller/Staff/ProductController.php`)
- Admin products → Category queries: loads categories (evidence: `src/Controller/Admin/ProductController.php`)
- Admin products → User queries: loads creators (evidence: `src/Controller/Admin/ProductController.php`)
- Product form → Product records: maps fields (evidence: `src/Form/ProductType.php`)
- Product form → Category records: selects category (evidence: `src/Form/ProductType.php`)
- Staff products → Application database: persists products (evidence: `src/Controller/Staff/ProductController.php`)
- Admin products → Application database: persists products (evidence: `src/Controller/Admin/ProductController.php`)
- Category management → Category form: builds forms (evidence: `src/Controller/Admin/CategoryController.php`)
- Category management → Category queries: queries categories (evidence: `src/Controller/Admin/CategoryController.php`)
- Category form → Category records: maps fields (evidence: `src/Form/CategoryType.php`)
- Category management → Application database: persists categories
- Registration → User records: creates accounts (evidence: `src/Controller/RegistrationController.php`)
- Registration → Application database: persists accounts
- Account settings → User records: updates account (evidence: `src/Controller/AccountController.php`)
- User administration → User form: builds forms (evidence: `src/Controller/Admin/UserController.php`)
- User administration → User queries: searches users (evidence: `src/Controller/Admin/UserController.php`)
- User administration → Application database: persists accounts (evidence: `src/Controller/Admin/UserController.php`)
- User form → User records: maps fields (evidence: `src/Form/UserType.php`)
- Admin dashboard → Product queries: reads product data (evidence: `src/Controller/Admin/DashboardController.php`)
- Admin dashboard → User queries: reads user data (evidence: `src/Controller/Admin/DashboardController.php`)
- Staff products → Product permissions: checks permissions (evidence: `src/Controller/Staff/ProductController.php`)
- Administrator → Category management: manages categories
- Administrator → User administration: manages users (evidence: `src/Controller/Admin/UserController.php`)
- Store visitor → Registration: creates account (evidence: `src/Controller/RegistrationController.php`)
- Store visitor → Login and security: signs in (evidence: `src/Controller/SecurityController.php`)
- Administrator → Admin dashboard: views metrics
- Administrator → Order administration: manages orders
- Administrator → Customer administration: manages customers
