# cryde/musicall architecture

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

- Interactive diagram: https://gitdiagram.com/cryde/musicall
- Repository: https://github.com/cryde/musicall

## Overview

MusicAll is a Symfony platform for publishing music-related content, finding musicians and bands, and communicating with them. Its principal user workflow spans account access, content and profile discovery, collaboration in Band Spaces, and direct messaging. The tree also shows substantial Band Space planning and administration capabilities. The graph groups these product areas and highlights a few source-confirmed internal calls. Most API resources and their persistence wiring were not sampled, so their internal relationships are not inferred.

Main entry points: [`src/State/Provider/BandSpace/Task/TaskStatsProvider.php`](https://github.com/cryde/musicall/blob/master/src/State/Provider/BandSpace/Task/TaskStatsProvider.php) (Tasks and stats), [`src/Controller/OAuth/AbstractOAuthController.php`](https://github.com/cryde/musicall/blob/master/src/Controller/OAuth/AbstractOAuthController.php) (OAuth sign-in), [`src/Service/OAuth/OAuthUserService.php`](https://github.com/cryde/musicall/blob/master/src/Service/OAuth/OAuthUserService.php) (OAuth accounts), [`src/Controller/HomeController.php`](https://github.com/cryde/musicall/blob/master/src/Controller/HomeController.php) (Web entry and redirects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and profiles"]
  node_oauth["OAuth sign-in"]
  node_oauth_service["OAuth accounts"]
  node_user_domain[("User profiles<br/>[User.php]")]
end

subgraph group_content["Publishing and learning"]
  node_publication["Publications and courses"]
  node_gallery["Galleries and video"]
  node_forum["Forums<br/>[ForumTopic.php]"]
  node_comments["Comments and votes"]
  node_home["Web entry and redirects<br/>[HomeController.php]"]
end

subgraph group_discovery["Search and discovery"]
  node_musician["Musician search"]
  node_teacher[("Teacher profiles<br/>[TeacherProfile.php]")]
  node_search_logs["Search insights"]
end

subgraph group_collaboration["Band collaboration"]
  node_band_space[("Band Spaces<br/>[BandSpace.php]")]
  node_band_members[("Membership and roles")]
  node_band_planning["Planning and finance"]
  node_band_files["Files and setlists"]
  node_band_tasks["Tasks and stats"]
  node_task_stats_resource["Task statistics<br/>[TaskStats.php]"]
  node_task_repository["Task queries<br/>[TaskRepository.php]"]
end

subgraph group_communication["Communication and operations"]
  node_messages[("Direct messaging<br/>[Message.php]")]
  node_message_queries["Message queries"]
  node_notifications["Notifications"]
  node_admin["Moderation and admin<br/>[AdminReport.php]"]
end

node_member(("Member"))

node_member -->|"signs in"| node_oauth
node_oauth -->|"resolves account"| node_oauth_service
node_oauth_service -->|"creates or links"| node_user_domain
node_member -->|"shares content"| node_publication
node_member -->|"shares videos"| node_gallery
node_member -->|"finds collaborators"| node_musician
node_member -->|"views teaching profiles"| node_teacher
node_member -->|"joins discussions"| node_forum
node_member -->|"participates"| node_comments
node_member -->|"collaborates"| node_band_space
node_band_space -->|"has members"| node_band_members
node_member -->|"plans together"| node_band_planning
node_member -->|"manages band files"| node_band_files
node_member -->|"tracks tasks"| node_band_tasks
node_band_tasks -->|"queries counts"| node_task_repository
node_band_tasks -->|"returns statistics"| node_task_stats_resource
node_member -->|"chats directly"| node_messages
node_messages -->|"repository supports"| node_message_queries
node_member -.->|"receives updates"| node_notifications
node_member -.->|"reports issues"| node_admin
node_home -->|"looks up legacy course"| node_publication
node_member -.->|"opens platform"| node_home

click node_oauth "https://github.com/cryde/musicall/blob/master/src/Controller/OAuth/AbstractOAuthController.php"
click node_oauth_service "https://github.com/cryde/musicall/blob/master/src/Service/OAuth/OAuthUserService.php"
click node_user_domain "https://github.com/cryde/musicall/blob/master/src/Entity/User.php"
click node_musician "https://github.com/cryde/musicall/blob/master/src/Repository/Musician/MusicianAnnounceRepository.php"
click node_teacher "https://github.com/cryde/musicall/blob/master/src/Entity/Teacher/TeacherProfile.php"
click node_search_logs "https://github.com/cryde/musicall/blob/master/src/Repository/Search/MusicianSearchLogRepository.php"
click node_publication "https://github.com/cryde/musicall/blob/master/src/Repository/PublicationRepository.php"
click node_gallery "https://github.com/cryde/musicall/blob/master/src/ApiResource/Publication/GalleryResource.php"
click node_forum "https://github.com/cryde/musicall/blob/master/src/ApiResource/Forum/ForumTopic.php"
click node_comments "https://github.com/cryde/musicall/blob/master/src/ApiResource/Comment/CommentCreation.php"
click node_band_space "https://github.com/cryde/musicall/blob/master/src/Entity/BandSpace/BandSpace.php"
click node_band_members "https://github.com/cryde/musicall/blob/master/src/Entity/BandSpace/BandSpaceMembership.php"
click node_band_planning "https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/AgendaEntryCreate.php"
click node_band_files "https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/File/BandSpaceFileUpload.php"
click node_band_tasks "https://github.com/cryde/musicall/blob/master/src/State/Provider/BandSpace/Task/TaskStatsProvider.php"
click node_task_stats_resource "https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/Task/TaskStats.php"
click node_task_repository "https://github.com/cryde/musicall/blob/master/src/Repository/BandSpace/TaskRepository.php"
click node_messages "https://github.com/cryde/musicall/blob/master/src/Entity/Message/Message.php"
click node_message_queries "https://github.com/cryde/musicall/blob/master/src/Repository/Message/MessageRepository.php"
click node_notifications "https://github.com/cryde/musicall/blob/master/src/Messenger/SendPushNotificationHandler.php"
click node_admin "https://github.com/cryde/musicall/blob/master/src/ApiResource/Admin/Report/AdminReport.php"
click node_home "https://github.com/cryde/musicall/blob/master/src/Controller/HomeController.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_oauth,node_oauth_service,node_user_domain toneBlue
class node_publication,node_gallery,node_forum,node_comments,node_home toneAmber
class node_musician,node_teacher,node_search_logs toneMint
class node_band_space,node_band_members,node_band_planning,node_band_files,node_band_tasks,node_task_stats_resource,node_task_repository toneRose
class node_messages,node_message_queries,node_notifications,node_admin,node_member toneIndigo
```

## Components

### Identity and profiles

- [OAuth sign-in](https://github.com/cryde/musicall/blob/master/src/Controller/OAuth/AbstractOAuthController.php): `src/Controller/OAuth/AbstractOAuthController.php`
- [OAuth accounts](https://github.com/cryde/musicall/blob/master/src/Service/OAuth/OAuthUserService.php): `src/Service/OAuth/OAuthUserService.php`
- [User profiles](https://github.com/cryde/musicall/blob/master/src/Entity/User.php): `src/Entity/User.php`

### Publishing and learning

- [Publications and courses](https://github.com/cryde/musicall/blob/master/src/Repository/PublicationRepository.php): `src/Repository/PublicationRepository.php`
- [Galleries and video](https://github.com/cryde/musicall/blob/master/src/ApiResource/Publication/GalleryResource.php): `src/ApiResource/Publication/GalleryResource.php`
- [Forums](https://github.com/cryde/musicall/blob/master/src/ApiResource/Forum/ForumTopic.php): `src/ApiResource/Forum/ForumTopic.php`
- [Comments and votes](https://github.com/cryde/musicall/blob/master/src/ApiResource/Comment/CommentCreation.php): `src/ApiResource/Comment/CommentCreation.php`
- [Web entry and redirects](https://github.com/cryde/musicall/blob/master/src/Controller/HomeController.php): `src/Controller/HomeController.php`

### Search and discovery

- [Musician search](https://github.com/cryde/musicall/blob/master/src/Repository/Musician/MusicianAnnounceRepository.php): `src/Repository/Musician/MusicianAnnounceRepository.php`
- [Teacher profiles](https://github.com/cryde/musicall/blob/master/src/Entity/Teacher/TeacherProfile.php): `src/Entity/Teacher/TeacherProfile.php`
- [Search insights](https://github.com/cryde/musicall/blob/master/src/Repository/Search/MusicianSearchLogRepository.php): `src/Repository/Search/MusicianSearchLogRepository.php`

### Band collaboration

- [Band Spaces](https://github.com/cryde/musicall/blob/master/src/Entity/BandSpace/BandSpace.php): `src/Entity/BandSpace/BandSpace.php`
- [Membership and roles](https://github.com/cryde/musicall/blob/master/src/Entity/BandSpace/BandSpaceMembership.php): `src/Entity/BandSpace/BandSpaceMembership.php`
- [Planning and finance](https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/AgendaEntryCreate.php): `src/ApiResource/BandSpace/AgendaEntryCreate.php`
- [Files and setlists](https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/File/BandSpaceFileUpload.php): `src/ApiResource/BandSpace/File/BandSpaceFileUpload.php`
- [Tasks and stats](https://github.com/cryde/musicall/blob/master/src/State/Provider/BandSpace/Task/TaskStatsProvider.php): `src/State/Provider/BandSpace/Task/TaskStatsProvider.php`
- [Task statistics](https://github.com/cryde/musicall/blob/master/src/ApiResource/BandSpace/Task/TaskStats.php): `src/ApiResource/BandSpace/Task/TaskStats.php`
- [Task queries](https://github.com/cryde/musicall/blob/master/src/Repository/BandSpace/TaskRepository.php): `src/Repository/BandSpace/TaskRepository.php`

### Communication and operations

- [Direct messaging](https://github.com/cryde/musicall/blob/master/src/Entity/Message/Message.php): `src/Entity/Message/Message.php`
- [Message queries](https://github.com/cryde/musicall/blob/master/src/Repository/Message/MessageRepository.php): `src/Repository/Message/MessageRepository.php`
- [Notifications](https://github.com/cryde/musicall/blob/master/src/Messenger/SendPushNotificationHandler.php): `src/Messenger/SendPushNotificationHandler.php`
- [Moderation and admin](https://github.com/cryde/musicall/blob/master/src/ApiResource/Admin/Report/AdminReport.php): `src/ApiResource/Admin/Report/AdminReport.php`

### Other components

- **Member**

## Connections

- Member → OAuth sign-in: signs in (evidence: `README.md`)
- OAuth sign-in → OAuth accounts: resolves account (evidence: `src/Controller/OAuth/AbstractOAuthController.php`)
- OAuth accounts → User profiles: creates or links (evidence: `src/Service/OAuth/OAuthUserService.php`)
- Member → Publications and courses: shares content (evidence: `README.md`)
- Member → Galleries and video: shares videos (evidence: `README.md`)
- Member → Musician search: finds collaborators (evidence: `README.md`)
- Member → Teacher profiles: views teaching profiles (evidence: `README.md`)
- Member → Forums: joins discussions (evidence: `README.md`)
- Member → Comments and votes: participates (evidence: `README.md`)
- Member → Band Spaces: collaborates (evidence: `README.md`)
- Band Spaces → Membership and roles: has members (evidence: `src/Entity/BandSpace/BandSpace.php`)
- Member → Planning and finance: plans together (evidence: `README.md`)
- Member → Files and setlists: manages band files (evidence: `README.md`)
- Member → Tasks and stats: tracks tasks (evidence: `README.md`)
- Tasks and stats → Task queries: queries counts (evidence: `src/State/Provider/BandSpace/Task/TaskStatsProvider.php`)
- Tasks and stats → Task statistics: returns statistics (evidence: `src/State/Provider/BandSpace/Task/TaskStatsProvider.php`)
- Member → Direct messaging: chats directly (evidence: `README.md`)
- Direct messaging → Message queries: repository supports (evidence: `src/Entity/Message/Message.php`)
- Member → Notifications: receives updates
- Member → Moderation and admin: reports issues
- Web entry and redirects → Publications and courses: looks up legacy course (evidence: `src/Controller/HomeController.php`)
- Member → Web entry and redirects: opens platform
