# farooqkhwaja/symfonyapplications architecture

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

- Interactive diagram: https://gitdiagram.com/farooqkhwaja/symfonyapplications
- Repository: https://github.com/farooqkhwaja/symfonyapplications

## Overview

This tree contains a Symfony conference guestbook, a small reusable React Button package, and a Vite app that consumes it. The guestbook’s main workflow is conference browsing and comment submission, followed by asynchronous spam checks, moderation, and publication; admins also manage conferences and comments. Its entities expose API resources, and published-comment filtering is present. The source excerpts support these principal paths, but do not show all framework configuration or command behavior; those connections are omitted. The UI package’s export and the consuming app’s use are visible in the source index and excerpt.

Main entry points: [`guestbook/src/Controller/ConferenceController.php`](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/ConferenceController.php) (Conference Pages), [`guestbook/src/Entity/Comment.php`](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Comment.php) (Comment Entity), [`guestbook/src/MessageHandler/CommentMessageHandler.php`](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/MessageHandler/CommentMessageHandler.php) (Comment Processor), [`guestbook/src/Entity/Conference.php`](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Conference.php) (Conference Entity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Guestbook"]
  node_front["Symfony Entry<br/>[index.php]"]
  node_conference["Conference Pages"]
  node_commentform["Comment Form<br/>[CommentType.php]"]
end

subgraph group_moderation["Review Workflow"]
  node_adminsite["Admin Actions"]
  node_dashboard["Admin Dashboard"]
  node_commentadmin["Comment Admin"]
  node_conferenceadmin["Conference Admin"]
  node_message["Comment Message<br/>[CommentMessage.php]"]
  node_handler["Comment Processor"]
  node_spam["Spam Scoring<br/>[SpamChecker.php]"]
  node_notification["Review Notification"]
  node_optimizer["Image Optimizer<br/>[ImageOptimizer.php]"]
end

subgraph group_domain["Domain and API"]
  node_comment["Comment Entity<br/>[Comment.php]"]
  node_conferenceentity["Conference Entity<br/>[Conference.php]"]
  node_adminentity["Admin Entity<br/>[Admin.php]"]
  node_commentrepo["Comment Repository"]
  node_conferencerepo["Conference Repository"]
  node_adminrepo["Admin Repository"]
  node_api_filter["Published API Filter"]
  node_database[("Doctrine Database")]
end

subgraph group_ui["React UI"]
  node_button["Button Component<br/>[Button.jsx]"]
  node_ui_export["Package Export<br/>[index.js]"]
  node_app["Tailwind Demo<br/>[App.jsx]"]
end

node_visitor(("Visitor"))
node_browser(("Browser"))

node_visitor -->|"requests pages"| node_front
node_front -.->|"routes requests"| node_conference
node_conference -->|"builds form"| node_commentform
node_conference -->|"queries comments"| node_commentrepo
node_conference -->|"loads conferences"| node_conferencerepo
node_conference -->|"creates comment"| node_comment
node_conference -->|"dispatches message"| node_message
node_adminsite -->|"reviews comment"| node_comment
node_adminsite -->|"dispatches message"| node_message
node_handler -->|"loads comment"| node_commentrepo
node_handler -->|"scores comment"| node_spam
node_handler -->|"creates notification"| node_notification
node_handler -->|"resizes image"| node_optimizer
node_handler -->|"redispatches message"| node_message
node_dashboard -->|"redirects to"| node_conferenceadmin
node_dashboard -->|"links to"| node_commentadmin
node_conferenceadmin -->|"manages entity"| node_conferenceentity
node_commentadmin -->|"manages entity"| node_comment
node_api_filter -->|"filters queries"| node_comment
node_comment -->|"maps entity"| node_database
node_conferenceentity -->|"maps entity"| node_database
node_adminentity -->|"maps entity"| node_database
node_comment -->|"uses repository"| node_commentrepo
node_conferenceentity -->|"uses repository"| node_conferencerepo
node_adminentity -->|"uses repository"| node_adminrepo
node_browser -.->|"renders app"| node_app
node_app -->|"renders button"| node_button
node_ui_export -->|"exports component"| node_button

click node_front "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/public/index.php"
click node_conference "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/ConferenceController.php"
click node_commentform "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Form/CommentType.php"
click node_adminsite "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/AdminController.php"
click node_dashboard "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/DashboardController.php"
click node_commentadmin "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/CommentCrudController.php"
click node_conferenceadmin "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/ConferenceCrudController.php"
click node_message "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Message/CommentMessage.php"
click node_handler "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/MessageHandler/CommentMessageHandler.php"
click node_spam "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/SpamChecker.php"
click node_notification "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Notification/CommentReviewNotification.php"
click node_optimizer "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/ImageOptimizer.php"
click node_comment "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Comment.php"
click node_conferenceentity "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Conference.php"
click node_adminentity "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Admin.php"
click node_commentrepo "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/CommentRepository.php"
click node_conferencerepo "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/ConferenceRepository.php"
click node_adminrepo "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/AdminRepository.php"
click node_api_filter "https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Api/FilterPublishedCommentQueryExtension.php"
click node_button "https://github.com/farooqkhwaja/symfonyapplications/blob/main/farooq-ui/src/Button.jsx"
click node_ui_export "https://github.com/farooqkhwaja/symfonyapplications/blob/main/farooq-ui/src/index.js"
click node_app "https://github.com/farooqkhwaja/symfonyapplications/blob/main/TailwindBasics/src/App.jsx"

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_front,node_conference,node_commentform,node_browser toneBlue
class node_adminsite,node_dashboard,node_commentadmin,node_conferenceadmin,node_message,node_handler,node_spam,node_notification,node_optimizer toneAmber
class node_comment,node_conferenceentity,node_adminentity,node_commentrepo,node_conferencerepo,node_adminrepo,node_api_filter,node_database toneMint
class node_button,node_ui_export,node_app toneRose
class node_visitor toneIndigo
```

## Components

### Public Guestbook

- [Symfony Entry](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/public/index.php): `guestbook/public/index.php`
- [Conference Pages](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/ConferenceController.php): `guestbook/src/Controller/ConferenceController.php`
- [Comment Form](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Form/CommentType.php): `guestbook/src/Form/CommentType.php`

### Review Workflow

- [Admin Actions](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/AdminController.php): `guestbook/src/Controller/AdminController.php`
- [Admin Dashboard](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/DashboardController.php): `guestbook/src/Controller/Admin/DashboardController.php`
- [Comment Admin](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/CommentCrudController.php): `guestbook/src/Controller/Admin/CommentCrudController.php`
- [Conference Admin](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Controller/Admin/ConferenceCrudController.php): `guestbook/src/Controller/Admin/ConferenceCrudController.php`
- [Comment Message](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Message/CommentMessage.php): `guestbook/src/Message/CommentMessage.php`
- [Comment Processor](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/MessageHandler/CommentMessageHandler.php): `guestbook/src/MessageHandler/CommentMessageHandler.php`
- [Spam Scoring](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/SpamChecker.php): `guestbook/src/SpamChecker.php`
- [Review Notification](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Notification/CommentReviewNotification.php): `guestbook/src/Notification/CommentReviewNotification.php`
- [Image Optimizer](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/ImageOptimizer.php): `guestbook/src/ImageOptimizer.php`

### Domain and API

- [Comment Entity](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Comment.php): `guestbook/src/Entity/Comment.php`
- [Conference Entity](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Conference.php): `guestbook/src/Entity/Conference.php`
- [Admin Entity](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Entity/Admin.php): `guestbook/src/Entity/Admin.php`
- [Comment Repository](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/CommentRepository.php): `guestbook/src/Repository/CommentRepository.php`
- [Conference Repository](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/ConferenceRepository.php): `guestbook/src/Repository/ConferenceRepository.php`
- [Admin Repository](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Repository/AdminRepository.php): `guestbook/src/Repository/AdminRepository.php`
- [Published API Filter](https://github.com/farooqkhwaja/symfonyapplications/blob/main/guestbook/src/Api/FilterPublishedCommentQueryExtension.php): `guestbook/src/Api/FilterPublishedCommentQueryExtension.php`
- **Doctrine Database**

### React UI

- [Button Component](https://github.com/farooqkhwaja/symfonyapplications/blob/main/farooq-ui/src/Button.jsx): `farooq-ui/src/Button.jsx`
- [Package Export](https://github.com/farooqkhwaja/symfonyapplications/blob/main/farooq-ui/src/index.js): `farooq-ui/src/index.js`
- [Tailwind Demo](https://github.com/farooqkhwaja/symfonyapplications/blob/main/TailwindBasics/src/App.jsx): `TailwindBasics/src/App.jsx`

### Other components

- **Visitor**
- **Browser**

## Connections

- Visitor → Symfony Entry: requests pages (evidence: `guestbook/public/index.php`)
- Symfony Entry → Conference Pages: routes requests
- Conference Pages → Comment Form: builds form (evidence: `guestbook/src/Controller/ConferenceController.php`)
- Conference Pages → Comment Repository: queries comments (evidence: `guestbook/src/Controller/ConferenceController.php`)
- Conference Pages → Conference Repository: loads conferences (evidence: `guestbook/src/Controller/ConferenceController.php`)
- Conference Pages → Comment Entity: creates comment (evidence: `guestbook/src/Controller/ConferenceController.php`)
- Conference Pages → Comment Message: dispatches message (evidence: `guestbook/src/Controller/ConferenceController.php`)
- Admin Actions → Comment Entity: reviews comment (evidence: `guestbook/src/Controller/AdminController.php`)
- Admin Actions → Comment Message: dispatches message (evidence: `guestbook/src/Controller/AdminController.php`)
- Comment Processor → Comment Repository: loads comment (evidence: `guestbook/src/MessageHandler/CommentMessageHandler.php`)
- Comment Processor → Spam Scoring: scores comment (evidence: `guestbook/src/MessageHandler/CommentMessageHandler.php`)
- Comment Processor → Review Notification: creates notification (evidence: `guestbook/src/MessageHandler/CommentMessageHandler.php`)
- Comment Processor → Image Optimizer: resizes image (evidence: `guestbook/src/MessageHandler/CommentMessageHandler.php`)
- Comment Processor → Comment Message: redispatches message (evidence: `guestbook/src/MessageHandler/CommentMessageHandler.php`)
- Admin Dashboard → Conference Admin: redirects to (evidence: `guestbook/src/Controller/Admin/DashboardController.php`)
- Admin Dashboard → Comment Admin: links to (evidence: `guestbook/src/Controller/Admin/DashboardController.php`)
- Conference Admin → Conference Entity: manages entity (evidence: `guestbook/src/Controller/Admin/ConferenceCrudController.php`)
- Comment Admin → Comment Entity: manages entity (evidence: `guestbook/src/Controller/Admin/CommentCrudController.php`)
- Published API Filter → Comment Entity: filters queries (evidence: `guestbook/src/Api/FilterPublishedCommentQueryExtension.php`)
- Comment Entity → Doctrine Database: maps entity (evidence: `guestbook/src/Entity/Comment.php`)
- Conference Entity → Doctrine Database: maps entity (evidence: `guestbook/src/Entity/Conference.php`)
- Admin Entity → Doctrine Database: maps entity (evidence: `guestbook/src/Entity/Admin.php`)
- Comment Entity → Comment Repository: uses repository (evidence: `guestbook/src/Entity/Comment.php`)
- Conference Entity → Conference Repository: uses repository (evidence: `guestbook/src/Entity/Conference.php`)
- Admin Entity → Admin Repository: uses repository (evidence: `guestbook/src/Entity/Admin.php`)
- Browser → Tailwind Demo: renders app
- Tailwind Demo → Button Component: renders button (evidence: `TailwindBasics/src/App.jsx`)
- Package Export → Button Component: exports component (evidence: `farooq-ui/src/index.js`)
