# sumocoders/frameworkcorebundle architecture

> Architecture diagram of the GitHub repository sumocoders/frameworkcorebundle, 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/sumocoders/frameworkcorebundle
- Repository: https://github.com/sumocoders/frameworkcorebundle

## Overview

FrameworkCoreBundle is a shared Symfony foundation bundle. A typical request uses its metadata and navigation facilities before application templates present the result; separate capabilities cover uploads/forms, auditing, pagination, and frontend interactions. The README documents the product capabilities, while source relationships below are limited to sampled code, SOURCE INDEX references, or explicit README statements; several unsampled subsystems therefore have no inferred internal wiring.

Main entry points: [`src/DoctrineListener/DoctrineAuditListener.php`](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/DoctrineListener/DoctrineAuditListener.php) (Doctrine audit listener), [`src/EventListener/BreadcrumbListener.php`](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/BreadcrumbListener.php) (Breadcrumb listener), [`src/Service/PageTitle.php`](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/PageTitle.php) (Page title), [`src/EventListener/TitleListener.php`](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/TitleListener.php) (Title listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request presentation"]
  node_breadcrumb_listener["Breadcrumb listener"]
  node_breadcrumb_attribute["Breadcrumb attribute<br/>[Breadcrumb.php]"]
  node_breadcrumb_trail["Breadcrumb trail"]
  node_page_title["Page title<br/>[PageTitle.php]"]
  node_title_listener["Title listener<br/>[TitleListener.php]"]
  node_fallbacks["Title fallbacks<br/>[Fallbacks.php]"]
end

subgraph group_data["Forms and data"]
  node_file_type["File form type<br/>[FileType.php]"]
  node_image_type["Image form type<br/>[ImageType.php]"]
  node_abstract_file["File value object<br/>[AbstractFile.php]"]
  node_abstract_image["Image value object<br/>[AbstractImage.php]"]
  node_encrypted_type["Encrypted fields"]
  node_postcode["Belgian postcodes"]
end

subgraph group_audit["Audit and security"]
  node_audit_listener["Doctrine audit listener"]
  node_audit_attribute["Audit annotations<br/>[AuditTrail.php]"]
  node_audit_logger["Audit logger<br/>[AuditLogger.php]"]
  node_event_action["Audit actions<br/>[EventAction.php]"]
  node_sentry_context["Sentry user context"]
end

subgraph group_render["Rendering and navigation"]
  node_menu_builder["Menu builder<br/>[MenuBuilder.php]"]
  node_menu_event["Menu configuration event"]
  node_paginator["Paginator<br/>[Paginator.php]"]
  node_twig_paginator["Paginator Twig extension"]
  node_maintenance_command["Dependency update command"]
end

subgraph group_frontend["Frontend interactions"]
  node_frontend_controllers["Stimulus controllers"]
  node_frontend_helpers["JavaScript helpers"]
end

node_app(("Symfony application"))

node_app -->|"requests metadata"| node_breadcrumb_listener
node_breadcrumb_listener -->|"reads attributes"| node_breadcrumb_attribute
node_breadcrumb_listener -->|"builds trail"| node_breadcrumb_trail
node_breadcrumb_trail -->|"stores breadcrumb values"| node_breadcrumb_attribute
node_app -->|"requests page title"| node_title_listener
node_title_listener -->|"sets title"| node_page_title
node_title_listener -->|"uses fallbacks"| node_fallbacks
node_page_title -->|"reads trail"| node_breadcrumb_trail
node_page_title -->|"uses fallbacks"| node_fallbacks
node_app -->|"requests navigation"| node_menu_builder
node_menu_builder -->|"dispatches configuration"| node_menu_event
node_app -->|"submits uploads"| node_file_type
node_app -->|"submits images"| node_image_type
node_image_type -->|"uses file type"| node_file_type
node_file_type -->|"maps uploaded file"| node_abstract_file
node_abstract_image -->|"extends file value"| node_abstract_file
node_app -->|"stores encrypted fields"| node_encrypted_type
node_app -->|"validates postcode forms"| node_postcode
node_app -->|"persists audited changes"| node_audit_listener
node_audit_listener -->|"reads audit metadata"| node_audit_attribute
node_audit_listener -->|"records changes"| node_audit_logger
node_audit_listener -->|"uses action values"| node_event_action
node_audit_logger -->|"uses action values"| node_event_action
node_app -->|"adds error context"| node_sentry_context
node_app -->|"paginates results"| node_paginator
node_twig_paginator -->|"renders pagination"| node_paginator
node_app -->|"uses design interactions"| node_frontend_controllers
node_app -->|"uses frontend helpers"| node_frontend_helpers

click node_breadcrumb_listener "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/BreadcrumbListener.php"
click node_breadcrumb_attribute "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Attribute/Breadcrumb.php"
click node_breadcrumb_trail "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/BreadcrumbTrail.php"
click node_page_title "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/PageTitle.php"
click node_title_listener "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/TitleListener.php"
click node_fallbacks "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/Fallbacks.php"
click node_menu_builder "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Menu/MenuBuilder.php"
click node_menu_event "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Event/ConfigureMenuEvent.php"
click node_file_type "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/FileType.php"
click node_image_type "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/ImageType.php"
click node_abstract_file "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/ValueObject/AbstractFile.php"
click node_abstract_image "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/ValueObject/AbstractImage.php"
click node_encrypted_type "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/DBALType/EncryptedDBALType.php"
click node_postcode "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/BelgiumPostCodeType.php"
click node_audit_listener "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/DoctrineListener/DoctrineAuditListener.php"
click node_audit_attribute "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Attribute/AuditTrail/AuditTrail.php"
click node_audit_logger "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Logger/AuditLogger.php"
click node_event_action "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Enum/EventAction.php"
click node_sentry_context "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/SentryUserContextListener.php"
click node_paginator "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Pagination/Paginator.php"
click node_twig_paginator "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Twig/PaginatorExtension.php"
click node_frontend_controllers "https://github.com/sumocoders/frameworkcorebundle/tree/master/assets-public/controllers"
click node_frontend_helpers "https://github.com/sumocoders/frameworkcorebundle/tree/master/assets-public/js"
click node_maintenance_command "https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Command/Maintenance/CreatePrForOutdatedDependenciesCommand.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_breadcrumb_listener,node_breadcrumb_attribute,node_breadcrumb_trail,node_page_title,node_title_listener,node_fallbacks toneBlue
class node_file_type,node_image_type,node_abstract_file,node_abstract_image,node_encrypted_type,node_postcode toneAmber
class node_audit_listener,node_audit_attribute,node_audit_logger,node_event_action,node_sentry_context toneMint
class node_menu_builder,node_menu_event,node_paginator,node_twig_paginator,node_maintenance_command toneRose
class node_frontend_controllers,node_frontend_helpers,node_app toneIndigo
```

## Components

### Request presentation

- [Breadcrumb listener](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/BreadcrumbListener.php): `src/EventListener/BreadcrumbListener.php`
- [Breadcrumb attribute](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Attribute/Breadcrumb.php): `src/Attribute/Breadcrumb.php`
- [Breadcrumb trail](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/BreadcrumbTrail.php): `src/Service/BreadcrumbTrail.php`
- [Page title](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/PageTitle.php): `src/Service/PageTitle.php`
- [Title listener](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/TitleListener.php): `src/EventListener/TitleListener.php`
- [Title fallbacks](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Service/Fallbacks.php): `src/Service/Fallbacks.php`

### Forms and data

- [File form type](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/FileType.php): `src/Form/Type/FileType.php`
- [Image form type](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/ImageType.php): `src/Form/Type/ImageType.php`
- [File value object](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/ValueObject/AbstractFile.php): `src/ValueObject/AbstractFile.php`
- [Image value object](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/ValueObject/AbstractImage.php): `src/ValueObject/AbstractImage.php`
- [Encrypted fields](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/DBALType/EncryptedDBALType.php): `src/DBALType/EncryptedDBALType.php`
- [Belgian postcodes](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Form/Type/BelgiumPostCodeType.php): `src/Form/Type/BelgiumPostCodeType.php`

### Audit and security

- [Doctrine audit listener](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/DoctrineListener/DoctrineAuditListener.php): `src/DoctrineListener/DoctrineAuditListener.php`
- [Audit annotations](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Attribute/AuditTrail/AuditTrail.php): `src/Attribute/AuditTrail/AuditTrail.php`
- [Audit logger](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Logger/AuditLogger.php): `src/Logger/AuditLogger.php`
- [Audit actions](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Enum/EventAction.php): `src/Enum/EventAction.php`
- [Sentry user context](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/EventListener/SentryUserContextListener.php): `src/EventListener/SentryUserContextListener.php`

### Rendering and navigation

- [Menu builder](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Menu/MenuBuilder.php): `src/Menu/MenuBuilder.php`
- [Menu configuration event](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Event/ConfigureMenuEvent.php): `src/Event/ConfigureMenuEvent.php`
- [Paginator](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Pagination/Paginator.php): `src/Pagination/Paginator.php`
- [Paginator Twig extension](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Twig/PaginatorExtension.php): `src/Twig/PaginatorExtension.php`
- [Dependency update command](https://github.com/sumocoders/frameworkcorebundle/blob/master/src/Command/Maintenance/CreatePrForOutdatedDependenciesCommand.php): `src/Command/Maintenance/CreatePrForOutdatedDependenciesCommand.php`

### Frontend interactions

- [Stimulus controllers](https://github.com/sumocoders/frameworkcorebundle/tree/master/assets-public/controllers): `assets-public/controllers`
- [JavaScript helpers](https://github.com/sumocoders/frameworkcorebundle/tree/master/assets-public/js): `assets-public/js`

### Other components

- **Symfony application**

## Connections

- Symfony application → Breadcrumb listener: requests metadata (evidence: `README.md`)
- Breadcrumb listener → Breadcrumb attribute: reads attributes (evidence: `src/EventListener/BreadcrumbListener.php`)
- Breadcrumb listener → Breadcrumb trail: builds trail (evidence: `src/EventListener/BreadcrumbListener.php`)
- Breadcrumb trail → Breadcrumb attribute: stores breadcrumb values (evidence: `src/Service/BreadcrumbTrail.php`)
- Symfony application → Title listener: requests page title (evidence: `README.md`)
- Title listener → Page title: sets title (evidence: `src/EventListener/TitleListener.php`)
- Title listener → Title fallbacks: uses fallbacks (evidence: `src/EventListener/TitleListener.php`)
- Page title → Breadcrumb trail: reads trail (evidence: `src/Service/PageTitle.php`)
- Page title → Title fallbacks: uses fallbacks (evidence: `src/Service/PageTitle.php`)
- Symfony application → Menu builder: requests navigation (evidence: `README.md`)
- Menu builder → Menu configuration event: dispatches configuration (evidence: `src/Menu/MenuBuilder.php`)
- Symfony application → File form type: submits uploads (evidence: `README.md`)
- Symfony application → Image form type: submits images (evidence: `README.md`)
- Image form type → File form type: uses file type (evidence: `src/Form/Type/ImageType.php`)
- File form type → File value object: maps uploaded file (evidence: `src/Form/Type/FileType.php`)
- Image value object → File value object: extends file value (evidence: `src/ValueObject/AbstractImage.php`)
- Symfony application → Encrypted fields: stores encrypted fields (evidence: `README.md`)
- Symfony application → Belgian postcodes: validates postcode forms (evidence: `README.md`)
- Symfony application → Doctrine audit listener: persists audited changes (evidence: `README.md`)
- Doctrine audit listener → Audit annotations: reads audit metadata (evidence: `src/DoctrineListener/DoctrineAuditListener.php`)
- Doctrine audit listener → Audit logger: records changes (evidence: `src/DoctrineListener/DoctrineAuditListener.php`)
- Doctrine audit listener → Audit actions: uses action values (evidence: `src/DoctrineListener/DoctrineAuditListener.php`)
- Audit logger → Audit actions: uses action values (evidence: `src/Logger/AuditLogger.php`)
- Symfony application → Sentry user context: adds error context (evidence: `README.md`)
- Symfony application → Paginator: paginates results (evidence: `README.md`)
- Paginator Twig extension → Paginator: renders pagination (evidence: `src/Twig/PaginatorExtension.php`)
- Symfony application → Stimulus controllers: uses design interactions (evidence: `README.md`)
- Symfony application → JavaScript helpers: uses frontend helpers (evidence: `README.md`)
