# fabiojr933/ballet_flavia architecture

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

- Interactive diagram: https://gitdiagram.com/fabiojr933/ballet_flavia
- Repository: https://github.com/fabiojr933/ballet_flavia

## Overview

This is a web application for managing a ballet school: student records and waitlists, attendance and reports, scheduled messaging campaigns, WhatsApp connection, and dashboard/configuration. The main workflow is an authenticated request routed to a controller, through domain services and repositories to PostgreSQL, then rendered as a page or returned as a response. The source index supports several service/repository links; unsampled routes and integrations are omitted where their wiring is not shown.

Main entry points: [`src/routes/routes.js`](https://github.com/fabiojr933/ballet_flavia/blob/main/src/routes/routes.js) (HTTP routes), [`src/services/AlunaServices.js`](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/AlunaServices.js) (Student service), [`src/config/database.js`](https://github.com/fabiojr933/ballet_flavia/blob/main/src/config/database.js) (PostgreSQL), [`src/controllers/ChamadaController.js`](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/ChamadaController.js) (Attendance controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_routes["HTTP routes<br/>[routes.js]"]
  node_attendance["Attendance controller"]
  node_dashboard["Dashboard controller"]
  node_login["Login controller<br/>[LoginController.js]"]
  node_app["App scheduler<br/>[app.js]"]
  node_attendance_view["Attendance pages<br/>[index.ejs]"]
  node_waitlist_view["Waitlist pages<br/>[aguardando.ejs]"]
end

subgraph group_students["Student operations"]
  node_waitlist["Waitlist controller"]
  node_studentctl["Student controller<br/>[AlunaController.js]"]
  node_attendance_svc["Attendance service<br/>[ChamadaServices.js]"]
  node_student_svc["Student service<br/>[AlunaServices.js]"]
  node_waitlist_svc["Waitlist service<br/>[EsperaServices.js]"]
end

subgraph group_messaging["Messaging"]
  node_campaignctl["Campaign controller"]
  node_qrcode["WhatsApp setup"]
  node_campaign_svc["Campaign service"]
  node_processor["Campaign processor"]
  node_birthdays["Birthday checks"]
  node_whatsapp_svc["WhatsApp service"]
  node_whatsapp_repo["WhatsApp API access"]
  node_qrcode_view["QR / WhatsApp pages<br/>[index.ejs]"]
end

subgraph group_data["Data access"]
  node_student_repo["Student repository"]
  node_waitlist_repo["Waitlist repository"]
  node_attendance_repo["Attendance repository"]
  node_campaign_repo["Campaign repository"]
  node_process_repo["Processing repository"]
  node_config_repo["Configuration repository"]
  node_database[("PostgreSQL<br/>[database.js]")]
end

node_user(("School staff"))
node_external_whatsapp{{"WUZAPI service"}}

node_user -->|"sends requests"| node_routes
node_routes -->|"routes attendance"| node_attendance
node_routes -->|"routes dashboard"| node_dashboard
node_routes -->|"routes login"| node_login
node_routes -->|"routes waitlist"| node_waitlist
node_routes -->|"routes students"| node_studentctl
node_routes -->|"routes campaigns"| node_campaignctl
node_routes -->|"routes setup"| node_qrcode
node_attendance -->|"calls"| node_attendance_svc
node_attendance -->|"loads students"| node_student_svc
node_attendance -->|"renders"| node_attendance_view
node_waitlist -->|"calls"| node_waitlist_svc
node_waitlist -->|"promotes enrollee"| node_student_svc
node_waitlist -->|"renders"| node_waitlist_view
node_campaignctl -->|"calls"| node_campaign_svc
node_campaignctl -->|"loads students"| node_student_svc
node_qrcode -->|"checks connection"| node_whatsapp_svc
node_qrcode -->|"renders QR"| node_qrcode_view
node_attendance_svc -->|"persists attendance"| node_attendance_repo
node_attendance_svc -->|"loads absent student"| node_student_svc
node_attendance_svc -->|"reads message template"| node_config_repo
node_student_svc -->|"reads and writes"| node_student_repo
node_waitlist_svc -->|"reads and writes"| node_waitlist_repo
node_campaign_svc -->|"campaign operations"| node_campaign_repo
node_app -->|"schedules processing"| node_processor
node_app -->|"schedules checks"| node_birthdays
node_processor -->|"finds and updates campaigns"| node_process_repo
node_processor -->|"loads recipients"| node_student_svc
node_whatsapp_svc -->|"delegates API calls"| node_whatsapp_repo
node_whatsapp_repo -->|"calls API"| node_external_whatsapp
node_student_repo -->|"queries"| node_database
node_waitlist_repo -->|"queries"| node_database
node_attendance_repo -->|"queries"| node_database
node_campaign_repo -->|"queries"| node_database
node_process_repo -->|"queries"| node_database
node_config_repo -->|"queries"| node_database

click node_routes "https://github.com/fabiojr933/ballet_flavia/blob/main/src/routes/routes.js"
click node_attendance "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/ChamadaController.js"
click node_dashboard "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/DashboardController.js"
click node_login "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/LoginController.js"
click node_waitlist "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/EsperaController.js"
click node_studentctl "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/AlunaController.js"
click node_campaignctl "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/CampanhaController.js"
click node_qrcode "https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/QrcodeController.js"
click node_attendance_svc "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/ChamadaServices.js"
click node_student_svc "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/AlunaServices.js"
click node_waitlist_svc "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/EsperaServices.js"
click node_campaign_svc "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/CampanhaServices.js"
click node_processor "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/ProcessarServices.js"
click node_birthdays "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/AniversarioServices.js"
click node_whatsapp_svc "https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/WhatsappServices.js"
click node_whatsapp_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/WhatsappRepositories.js"
click node_student_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/AlunaRepositories.js"
click node_waitlist_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/EsperaRepositories.js"
click node_attendance_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ChamadaRepositories.js"
click node_campaign_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/CampanhaRepositories.js"
click node_process_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ProcessarRepositories.js"
click node_config_repo "https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ConfiguracaoRepositories.js"
click node_database "https://github.com/fabiojr933/ballet_flavia/blob/main/src/config/database.js"
click node_app "https://github.com/fabiojr933/ballet_flavia/blob/main/src/app.js"
click node_attendance_view "https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/chamada/index.ejs"
click node_waitlist_view "https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/aluna/aguardando.ejs"
click node_qrcode_view "https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/qrcode/index.ejs"

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_routes,node_attendance,node_dashboard,node_login,node_app,node_attendance_view,node_waitlist_view toneBlue
class node_waitlist,node_studentctl,node_attendance_svc,node_student_svc,node_waitlist_svc toneAmber
class node_campaignctl,node_qrcode,node_campaign_svc,node_processor,node_birthdays,node_whatsapp_svc,node_whatsapp_repo,node_qrcode_view,node_external_whatsapp toneMint
class node_student_repo,node_waitlist_repo,node_attendance_repo,node_campaign_repo,node_process_repo,node_config_repo,node_database toneRose
class node_user toneIndigo
```

## Components

### Web interface

- [HTTP routes](https://github.com/fabiojr933/ballet_flavia/blob/main/src/routes/routes.js): `src/routes/routes.js`
- [Attendance controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/ChamadaController.js): `src/controllers/ChamadaController.js`
- [Dashboard controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/DashboardController.js): `src/controllers/DashboardController.js`
- [Login controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/LoginController.js): `src/controllers/LoginController.js`
- [App scheduler](https://github.com/fabiojr933/ballet_flavia/blob/main/src/app.js): `src/app.js`
- [Attendance pages](https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/chamada/index.ejs): `src/views/chamada/index.ejs`
- [Waitlist pages](https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/aluna/aguardando.ejs): `src/views/aluna/aguardando.ejs`

### Student operations

- [Waitlist controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/EsperaController.js): `src/controllers/EsperaController.js`
- [Student controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/AlunaController.js): `src/controllers/AlunaController.js`
- [Attendance service](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/ChamadaServices.js): `src/services/ChamadaServices.js`
- [Student service](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/AlunaServices.js): `src/services/AlunaServices.js`
- [Waitlist service](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/EsperaServices.js): `src/services/EsperaServices.js`

### Messaging

- [Campaign controller](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/CampanhaController.js): `src/controllers/CampanhaController.js`
- [WhatsApp setup](https://github.com/fabiojr933/ballet_flavia/blob/main/src/controllers/QrcodeController.js): `src/controllers/QrcodeController.js`
- [Campaign service](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/CampanhaServices.js): `src/services/CampanhaServices.js`
- [Campaign processor](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/ProcessarServices.js): `src/services/ProcessarServices.js`
- [Birthday checks](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/AniversarioServices.js): `src/services/AniversarioServices.js`
- [WhatsApp service](https://github.com/fabiojr933/ballet_flavia/blob/main/src/services/WhatsappServices.js): `src/services/WhatsappServices.js`
- [WhatsApp API access](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/WhatsappRepositories.js): `src/repositories/WhatsappRepositories.js`
- [QR / WhatsApp pages](https://github.com/fabiojr933/ballet_flavia/blob/main/src/views/qrcode/index.ejs): `src/views/qrcode/index.ejs`

### Data access

- [Student repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/AlunaRepositories.js): `src/repositories/AlunaRepositories.js`
- [Waitlist repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/EsperaRepositories.js): `src/repositories/EsperaRepositories.js`
- [Attendance repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ChamadaRepositories.js): `src/repositories/ChamadaRepositories.js`
- [Campaign repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/CampanhaRepositories.js): `src/repositories/CampanhaRepositories.js`
- [Processing repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ProcessarRepositories.js): `src/repositories/ProcessarRepositories.js`
- [Configuration repository](https://github.com/fabiojr933/ballet_flavia/blob/main/src/repositories/ConfiguracaoRepositories.js): `src/repositories/ConfiguracaoRepositories.js`
- [PostgreSQL](https://github.com/fabiojr933/ballet_flavia/blob/main/src/config/database.js): `src/config/database.js`

### Other components

- **School staff**
- **WUZAPI service**

## Connections

- School staff → HTTP routes: sends requests (evidence: `src/routes/routes.js`)
- HTTP routes → Attendance controller: routes attendance (evidence: `src/routes/routes.js`)
- HTTP routes → Dashboard controller: routes dashboard (evidence: `src/routes/routes.js`)
- HTTP routes → Login controller: routes login (evidence: `src/routes/routes.js`)
- HTTP routes → Waitlist controller: routes waitlist (evidence: `src/routes/routes.js`)
- HTTP routes → Student controller: routes students (evidence: `src/routes/routes.js`)
- HTTP routes → Campaign controller: routes campaigns (evidence: `src/routes/routes.js`)
- HTTP routes → WhatsApp setup: routes setup (evidence: `src/routes/routes.js`)
- Attendance controller → Attendance service: calls (evidence: `src/controllers/ChamadaController.js`)
- Attendance controller → Student service: loads students (evidence: `src/controllers/ChamadaController.js`)
- Attendance controller → Attendance pages: renders (evidence: `src/controllers/ChamadaController.js`)
- Waitlist controller → Waitlist service: calls (evidence: `src/controllers/EsperaController.js`)
- Waitlist controller → Student service: promotes enrollee (evidence: `src/controllers/EsperaController.js`)
- Waitlist controller → Waitlist pages: renders (evidence: `src/controllers/EsperaController.js`)
- Campaign controller → Campaign service: calls (evidence: `src/controllers/CampanhaController.js`)
- Campaign controller → Student service: loads students (evidence: `src/controllers/CampanhaController.js`)
- WhatsApp setup → WhatsApp service: checks connection (evidence: `src/controllers/QrcodeController.js`)
- WhatsApp setup → QR / WhatsApp pages: renders QR (evidence: `src/controllers/QrcodeController.js`)
- Attendance service → Attendance repository: persists attendance (evidence: `src/services/ChamadaServices.js`)
- Attendance service → Student service: loads absent student (evidence: `src/services/ChamadaServices.js`)
- Attendance service → Configuration repository: reads message template (evidence: `src/services/ChamadaServices.js`)
- Student service → Student repository: reads and writes (evidence: `src/services/AlunaServices.js`)
- Waitlist service → Waitlist repository: reads and writes (evidence: `src/services/EsperaServices.js`)
- Campaign service → Campaign repository: campaign operations (evidence: `src/services/CampanhaServices.js`)
- App scheduler → Campaign processor: schedules processing (evidence: `src/app.js`)
- App scheduler → Birthday checks: schedules checks (evidence: `src/app.js`)
- Campaign processor → Processing repository: finds and updates campaigns (evidence: `src/services/ProcessarServices.js`)
- Campaign processor → Student service: loads recipients (evidence: `src/services/ProcessarServices.js`)
- WhatsApp service → WhatsApp API access: delegates API calls (evidence: `src/services/WhatsappServices.js`)
- WhatsApp API access → WUZAPI service: calls API (evidence: `src/repositories/WhatsappRepositories.js`)
- Student repository → PostgreSQL: queries (evidence: `src/repositories/AlunaRepositories.js`)
- Waitlist repository → PostgreSQL: queries (evidence: `src/repositories/EsperaRepositories.js`)
- Attendance repository → PostgreSQL: queries (evidence: `src/repositories/ChamadaRepositories.js`)
- Campaign repository → PostgreSQL: queries (evidence: `src/repositories/CampanhaRepositories.js`)
- Processing repository → PostgreSQL: queries (evidence: `src/repositories/ProcessarRepositories.js`)
- Configuration repository → PostgreSQL: queries (evidence: `src/repositories/ConfiguracaoRepositories.js`)
