# clarawolman/fanmeet architecture

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

- Interactive diagram: https://gitdiagram.com/clarawolman/fanmeet
- Repository: https://github.com/clarawolman/fanmeet

## Overview

FanMeet is a concert-centered social network: fans register, discover shows, join or create fan groups, and connect through chats and shared moments. The fan app and moderator backoffice call an Express API backed by Supabase; optional music and chatbot integrations support discovery and profiles. The README documents the backend layer sequence and major capabilities; sampled source confirms selected app, auth, user, and moments links. Unsampled features are represented by their exact enclosing directories, with unverified links omitted or dashed.

Main entry points: [`src/App.jsx`](https://github.com/clarawolman/fanmeet/blob/main/src/App.jsx) (Fan app shell), [`src/services/api.js`](https://github.com/clarawolman/fanmeet/blob/main/src/services/api.js) (API client services), [`backend/src/repositories`](https://github.com/clarawolman/fanmeet/tree/main/backend/src/repositories) (Data repositories), [`src/componentes/perfil`](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/perfil) (Profiles and music)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fan["Fan app"]
  node_web["Fan app shell<br/>[App.jsx]"]
  node_authui["Registration and login"]
  node_discovery["Concert discovery<br/>[Home.jsx]"]
  node_concertui["Concert pages"]
  node_groupui["Group pages"]
  node_profileui["Profiles and music"]
  node_clientservices["API client services<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_backend["Express application<br/>[app.js]"]
  node_routes["API routes"]
  node_controllers["Request controllers"]
  node_services["Domain services"]
  node_authdomain["Authentication<br/>[authService.js]"]
  node_userdomain["User profiles<br/>[usuarioService.js]"]
  node_concertdomain["Concerts and groups"]
end

subgraph group_social["Social features"]
  node_socialui["Chats and moments<br/>[Chats.jsx]"]
  node_notifsui["Notifications"]
  node_socialdomain["Social interactions<br/>[momentoService.js]"]
  node_chatbot["Fani chatbot<br/>[chatbotService.js]"]
end

subgraph group_ops["Moderator backoffice"]
  node_backoffice["Moderator panel<br/>[App.jsx]"]
  node_moderation["Moderation tools"]
end

subgraph group_infra["Data and integrations"]
  node_repositories["Data repositories"]
  node_supabase[("Supabase<br/>[supabaseClient.js]")]
  node_music["Music providers"]
  node_groq{{"Groq"}}
end

node_fan(("Fans"))

node_fan -->|"uses"| node_web
node_web -->|"shows"| node_authui
node_web -->|"shows"| node_discovery
node_web -.->|"opens"| node_concertui
node_web -.->|"opens"| node_groupui
node_web -.->|"opens"| node_profileui
node_web -.->|"opens"| node_socialui
node_web -.->|"opens"| node_notifsui
node_authui -->|"requests"| node_clientservices
node_discovery -.->|"requests"| node_clientservices
node_concertui -.->|"requests"| node_clientservices
node_groupui -.->|"requests"| node_clientservices
node_profileui -.->|"requests"| node_clientservices
node_socialui -->|"requests"| node_clientservices
node_clientservices -->|"calls REST"| node_backend
node_backoffice -->|"calls REST"| node_backend
node_backend -->|"mounts"| node_routes
node_routes -.->|"dispatches"| node_controllers
node_controllers -->|"calls"| node_services
node_authdomain -->|"reads and writes"| node_repositories
node_userdomain -.->|"uses"| node_repositories
node_concertdomain -.->|"uses"| node_repositories
node_socialdomain -.->|"uses"| node_repositories
node_moderation -.->|"uses"| node_repositories
node_repositories -->|"accesses"| node_supabase
node_chatbot -->|"queries"| node_groq
node_profileui -.->|"music data"| node_music
node_concertdomain -.->|"enriches discovery"| node_music

click node_web "https://github.com/clarawolman/fanmeet/blob/main/src/App.jsx"
click node_authui "https://github.com/clarawolman/fanmeet/tree/main/src/componentes/Login"
click node_discovery "https://github.com/clarawolman/fanmeet/blob/main/src/componentes/home/Home.jsx"
click node_concertui "https://github.com/clarawolman/fanmeet/tree/main/src/componentes/concierto"
click node_groupui "https://github.com/clarawolman/fanmeet/tree/main/src/componentes/crearGrupo"
click node_profileui "https://github.com/clarawolman/fanmeet/tree/main/src/componentes/perfil"
click node_socialui "https://github.com/clarawolman/fanmeet/blob/main/src/componentes/chats/Chats.jsx"
click node_notifsui "https://github.com/clarawolman/fanmeet/tree/main/src/componentes/notificaciones"
click node_clientservices "https://github.com/clarawolman/fanmeet/blob/main/src/services/api.js"
click node_backoffice "https://github.com/clarawolman/fanmeet/blob/main/backoffice/src/App.jsx"
click node_backend "https://github.com/clarawolman/fanmeet/blob/main/backend/src/app.js"
click node_routes "https://github.com/clarawolman/fanmeet/tree/main/backend/src/routes"
click node_controllers "https://github.com/clarawolman/fanmeet/tree/main/backend/src/controllers"
click node_services "https://github.com/clarawolman/fanmeet/tree/main/backend/src/services"
click node_authdomain "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/authService.js"
click node_userdomain "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/usuarioService.js"
click node_concertdomain "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/conciertoService.js"
click node_socialdomain "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/momentoService.js"
click node_chatbot "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/chatbotService.js"
click node_moderation "https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/backofficeService.js"
click node_repositories "https://github.com/clarawolman/fanmeet/tree/main/backend/src/repositories"
click node_supabase "https://github.com/clarawolman/fanmeet/blob/main/backend/src/config/supabaseClient.js"
click node_music "https://github.com/clarawolman/fanmeet/blob/main/backend/src/repositories/spotifyApiRepository.js"

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_authui,node_discovery,node_concertui,node_groupui,node_profileui,node_clientservices toneBlue
class node_backend,node_routes,node_controllers,node_services,node_authdomain,node_userdomain,node_concertdomain toneAmber
class node_socialui,node_notifsui,node_socialdomain,node_chatbot toneMint
class node_backoffice,node_moderation toneRose
class node_repositories,node_supabase,node_music,node_groq,node_fan toneIndigo
```

## Components

### Fan app

- [Fan app shell](https://github.com/clarawolman/fanmeet/blob/main/src/App.jsx): `src/App.jsx`
- [Registration and login](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/Login): `src/componentes/Login`
- [Concert discovery](https://github.com/clarawolman/fanmeet/blob/main/src/componentes/home/Home.jsx): `src/componentes/home/Home.jsx`
- [Concert pages](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/concierto): `src/componentes/concierto`
- [Group pages](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/crearGrupo): `src/componentes/crearGrupo`
- [Profiles and music](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/perfil): `src/componentes/perfil`
- [API client services](https://github.com/clarawolman/fanmeet/blob/main/src/services/api.js): `src/services/api.js`

### Backend API

- [Express application](https://github.com/clarawolman/fanmeet/blob/main/backend/src/app.js): `backend/src/app.js`
- [API routes](https://github.com/clarawolman/fanmeet/tree/main/backend/src/routes): `backend/src/routes`
- [Request controllers](https://github.com/clarawolman/fanmeet/tree/main/backend/src/controllers): `backend/src/controllers`
- [Domain services](https://github.com/clarawolman/fanmeet/tree/main/backend/src/services): `backend/src/services`
- [Authentication](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [User profiles](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/usuarioService.js): `backend/src/services/usuarioService.js`
- [Concerts and groups](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/conciertoService.js): `backend/src/services/conciertoService.js`

### Social features

- [Chats and moments](https://github.com/clarawolman/fanmeet/blob/main/src/componentes/chats/Chats.jsx): `src/componentes/chats/Chats.jsx`
- [Notifications](https://github.com/clarawolman/fanmeet/tree/main/src/componentes/notificaciones): `src/componentes/notificaciones`
- [Social interactions](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/momentoService.js): `backend/src/services/momentoService.js`
- [Fani chatbot](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/chatbotService.js): `backend/src/services/chatbotService.js`

### Moderator backoffice

- [Moderator panel](https://github.com/clarawolman/fanmeet/blob/main/backoffice/src/App.jsx): `backoffice/src/App.jsx`
- [Moderation tools](https://github.com/clarawolman/fanmeet/blob/main/backend/src/services/backofficeService.js): `backend/src/services/backofficeService.js`

### Data and integrations

- [Data repositories](https://github.com/clarawolman/fanmeet/tree/main/backend/src/repositories): `backend/src/repositories`
- [Supabase](https://github.com/clarawolman/fanmeet/blob/main/backend/src/config/supabaseClient.js): `backend/src/config/supabaseClient.js`
- [Music providers](https://github.com/clarawolman/fanmeet/blob/main/backend/src/repositories/spotifyApiRepository.js): `backend/src/repositories/spotifyApiRepository.js`
- **Groq**

### Other components

- **Fans**

## Connections

- Fans → Fan app shell: uses (evidence: `README.md`)
- Fan app shell → Registration and login: shows (evidence: `src/App.jsx`)
- Fan app shell → Concert discovery: shows (evidence: `src/App.jsx`)
- Fan app shell → Concert pages: opens (evidence: `src/App.jsx`)
- Fan app shell → Group pages: opens (evidence: `src/App.jsx`)
- Fan app shell → Profiles and music: opens (evidence: `src/App.jsx`)
- Fan app shell → Chats and moments: opens (evidence: `src/App.jsx`)
- Fan app shell → Notifications: opens (evidence: `src/App.jsx`)
- Registration and login → API client services: requests
- Concert discovery → API client services: requests
- Concert pages → API client services: requests
- Group pages → API client services: requests
- Profiles and music → API client services: requests
- Chats and moments → API client services: requests (evidence: `src/componentes/chats/Chats.jsx`)
- API client services → Express application: calls REST (evidence: `README.md`)
- Moderator panel → Express application: calls REST (evidence: `README.md`)
- Express application → API routes: mounts (evidence: `backend/src/app.js`)
- API routes → Request controllers: dispatches (evidence: `backend/src/routes/usuarioRoutes.js`)
- Request controllers → Domain services: calls (evidence: `backend/src/controllers/usuarioController.js`)
- Authentication → Data repositories: reads and writes (evidence: `backend/src/services/authService.js`)
- User profiles → Data repositories: uses
- Concerts and groups → Data repositories: uses
- Social interactions → Data repositories: uses
- Moderation tools → Data repositories: uses
- Data repositories → Supabase: accesses (evidence: `README.md`)
- Fani chatbot → Groq: queries (evidence: `README.md`)
- Profiles and music → Music providers: music data
- Concerts and groups → Music providers: enriches discovery
