# gastonroberti12/get_notas architecture

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

- Interactive diagram: https://gitdiagram.com/gastonroberti12/get_notas
- Repository: https://github.com/gastonroberti12/get_notas

## Overview

Cine Paradiso is a cinema-booking application: customers browse films and showtimes, select seats, create a reservation, pay, and receive ticket/QR confirmation; administrators manage cinema operations and view statistics. The Flask frontend calls a separate Flask API, whose routes delegate domain work to services and repositories backed by MySQL. The README also documents reviews, concessions, entry validation, and OMDb lookup. Some subsystems are represented by their exact directories because their implementation was not sampled; those relationships are omitted unless documented or visible.

Main entry points: [`backend/cine_fuente/db.py`](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/db.py) (Database access), [`backend/app.py`](https://github.com/gastonroberti12/get_notas/blob/main/backend/app.py) (API application), [`backend/cine_fuente/routes/reservas.py`](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/reservas.py) (Booking routes), [`frontend/app.py`](https://github.com/gastonroberti12/get_notas/blob/main/frontend/app.py) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer and admin web"]
  node_webapp["Web app<br/>[app.py]"]
  node_catalog["Film catalog<br/>[products.py]"]
  node_purchases["Booking checkout<br/>[purchases.py]"]
  node_backoffice["Backoffice<br/>[backoffice.py]"]
  node_roles["Session roles<br/>[roles.py]"]
  node_profiledata["Profile formatting<br/>[datos_perfil.py]"]
  node_branches["Branch context<br/>[sucursales.py]"]
  node_api_client["API client<br/>[api_cliente.py]"]
end

subgraph group_api["Backend API"]
  node_backendapp["API application<br/>[app.py]"]
  node_film_routes["Film routes<br/>[peliculas.py]"]
  node_booking_routes["Booking routes<br/>[reservas.py]"]
  node_functions_routes["Showtime routes<br/>[funciones.py]"]
  node_other_routes["Other API routes"]
end

subgraph group_domain["Cinema operations"]
  node_booking_service["Reservation service<br/>[reservas.py]"]
  node_security["Security service<br/>[seguridad.py]"]
  node_validators["Request validators"]
  node_notifications["Notifications"]
  node_qr["QR generation<br/>[qr_service.py]"]
  node_scheduler["Reservation expiry<br/>[scheduler.py]"]
  node_omdb_service["OMDb integration<br/>[omdb_service.py]"]
end

subgraph group_data["Persistence and integrations"]
  node_repositories["Repositories"]
  node_db_access["Database access<br/>[db.py]"]
  node_mysql[("MySQL database")]
  node_omdb["OMDb"]
  node_mail["SMTP email"]
  node_movie_repo["Film repository<br/>[peliculas.py]"]
  node_booking_repo["Reservation repository<br/>[reservas.py]"]
  node_seat_repo["Seat repository<br/>[butacas.py]"]
  node_user_repo["User repository<br/>[usuarios.py]"]
  node_metrics_repo["Statistics repository<br/>[estadisticas.py]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"registers"| node_catalog
node_webapp -->|"registers"| node_purchases
node_webapp -->|"registers"| node_backoffice
node_catalog -->|"calls"| node_api_client
node_purchases -->|"calls"| node_api_client
node_catalog -->|"reads context"| node_branches
node_backoffice -->|"calls"| node_api_client
node_backoffice -->|"checks role"| node_roles
node_purchases -->|"checks login"| node_roles
node_purchases -->|"formats values"| node_profiledata
node_api_client -->|"HTTP requests"| node_backendapp
node_backendapp -->|"registers"| node_film_routes
node_backendapp -->|"registers"| node_booking_routes
node_backendapp -->|"registers"| node_functions_routes
node_backendapp -->|"registers"| node_other_routes
node_film_routes -->|"reads and writes"| node_movie_repo
node_film_routes -->|"queries"| node_omdb_service
node_film_routes -->|"validates with"| node_validators
node_booking_routes -->|"delegates"| node_booking_service
node_booking_routes -->|"requests notices"| node_notifications
node_booking_routes -->|"checks access"| node_security
node_booking_routes -->|"validates with"| node_validators
node_functions_routes -->|"uses"| node_booking_service
node_functions_routes -->|"queries seats"| node_seat_repo
node_functions_routes -->|"queries reservations"| node_booking_repo
node_scheduler -->|"expires reservations"| node_booking_service
node_notifications -->|"generates codes"| node_qr
node_notifications -->|"sends email"| node_mail
node_omdb_service -.->|"searches"| node_omdb
node_movie_repo -->|"queries"| node_db_access
node_booking_repo -.->|"queries"| node_db_access
node_seat_repo -.->|"queries"| node_db_access
node_user_repo -->|"queries"| node_db_access
node_metrics_repo -.->|"queries"| node_db_access
node_db_access -->|"reads and writes"| node_mysql

click node_webapp "https://github.com/gastonroberti12/get_notas/blob/main/frontend/app.py"
click node_catalog "https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/products.py"
click node_purchases "https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/purchases.py"
click node_backoffice "https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/backoffice/backoffice.py"
click node_roles "https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/roles.py"
click node_profiledata "https://github.com/gastonroberti12/get_notas/blob/main/frontend/datos_perfil.py"
click node_branches "https://github.com/gastonroberti12/get_notas/blob/main/frontend/sucursales.py"
click node_api_client "https://github.com/gastonroberti12/get_notas/blob/main/frontend/api_cliente.py"
click node_backendapp "https://github.com/gastonroberti12/get_notas/blob/main/backend/app.py"
click node_film_routes "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/peliculas.py"
click node_booking_routes "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/reservas.py"
click node_functions_routes "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/funciones.py"
click node_other_routes "https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/routes"
click node_booking_service "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/reservas.py"
click node_security "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/seguridad.py"
click node_validators "https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/validators"
click node_repositories "https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/repositories"
click node_db_access "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/db.py"
click node_notifications "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/notificaciones_service.py"
click node_qr "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/qr_service.py"
click node_scheduler "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/scheduler.py"
click node_omdb_service "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/omdb_service.py"
click node_movie_repo "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/peliculas.py"
click node_booking_repo "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/reservas.py"
click node_seat_repo "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/butacas.py"
click node_user_repo "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/usuarios.py"
click node_metrics_repo "https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/estadisticas.py"

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_webapp,node_catalog,node_purchases,node_backoffice,node_roles,node_profiledata,node_branches,node_api_client toneBlue
class node_backendapp,node_film_routes,node_booking_routes,node_functions_routes,node_other_routes toneAmber
class node_booking_service,node_security,node_validators,node_notifications,node_qr,node_scheduler,node_omdb_service toneMint
class node_repositories,node_db_access,node_mysql,node_omdb,node_mail,node_movie_repo,node_booking_repo,node_seat_repo,node_user_repo,node_metrics_repo toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Customer and admin web

- [Web app](https://github.com/gastonroberti12/get_notas/blob/main/frontend/app.py): `frontend/app.py`
- [Film catalog](https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/products.py): `frontend/routes/products.py`
- [Booking checkout](https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/purchases.py): `frontend/routes/purchases.py`
- [Backoffice](https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/backoffice/backoffice.py): `frontend/routes/backoffice/backoffice.py`
- [Session roles](https://github.com/gastonroberti12/get_notas/blob/main/frontend/routes/roles.py): `frontend/routes/roles.py`
- [Profile formatting](https://github.com/gastonroberti12/get_notas/blob/main/frontend/datos_perfil.py): `frontend/datos_perfil.py`
- [Branch context](https://github.com/gastonroberti12/get_notas/blob/main/frontend/sucursales.py): `frontend/sucursales.py`
- [API client](https://github.com/gastonroberti12/get_notas/blob/main/frontend/api_cliente.py): `frontend/api_cliente.py`

### Backend API

- [API application](https://github.com/gastonroberti12/get_notas/blob/main/backend/app.py): `backend/app.py`
- [Film routes](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/peliculas.py): `backend/cine_fuente/routes/peliculas.py`
- [Booking routes](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/reservas.py): `backend/cine_fuente/routes/reservas.py`
- [Showtime routes](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/routes/funciones.py): `backend/cine_fuente/routes/funciones.py`
- [Other API routes](https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/routes): `backend/cine_fuente/routes`

### Cinema operations

- [Reservation service](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/reservas.py): `backend/cine_fuente/services/reservas.py`
- [Security service](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/seguridad.py): `backend/cine_fuente/services/seguridad.py`
- [Request validators](https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/validators): `backend/cine_fuente/validators`
- [Notifications](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/notificaciones_service.py): `backend/cine_fuente/services/notificaciones_service.py`
- [QR generation](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/qr_service.py): `backend/cine_fuente/services/qr_service.py`
- [Reservation expiry](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/scheduler.py): `backend/cine_fuente/scheduler.py`
- [OMDb integration](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/services/omdb_service.py): `backend/cine_fuente/services/omdb_service.py`

### Persistence and integrations

- [Repositories](https://github.com/gastonroberti12/get_notas/tree/main/backend/cine_fuente/repositories): `backend/cine_fuente/repositories`
- [Database access](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/db.py): `backend/cine_fuente/db.py`
- **MySQL database**
- **OMDb**
- **SMTP email**
- [Film repository](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/peliculas.py): `backend/cine_fuente/repositories/peliculas.py`
- [Reservation repository](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/reservas.py): `backend/cine_fuente/repositories/reservas.py`
- [Seat repository](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/butacas.py): `backend/cine_fuente/repositories/butacas.py`
- [User repository](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/usuarios.py): `backend/cine_fuente/repositories/usuarios.py`
- [Statistics repository](https://github.com/gastonroberti12/get_notas/blob/main/backend/cine_fuente/repositories/estadisticas.py): `backend/cine_fuente/repositories/estadisticas.py`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Web app: uses (evidence: `README.md`)
- Administrator → Web app: uses (evidence: `README.md`)
- Web app → Film catalog: registers (evidence: `frontend/app.py`)
- Web app → Booking checkout: registers (evidence: `frontend/app.py`)
- Web app → Backoffice: registers (evidence: `frontend/app.py`)
- Film catalog → API client: calls (evidence: `frontend/routes/products.py`)
- Booking checkout → API client: calls (evidence: `frontend/routes/purchases.py`)
- Film catalog → Branch context: reads context (evidence: `frontend/routes/products.py`)
- Backoffice → API client: calls (evidence: `frontend/routes/backoffice/backoffice.py`)
- Backoffice → Session roles: checks role (evidence: `frontend/routes/backoffice/backoffice.py`)
- Booking checkout → Session roles: checks login (evidence: `frontend/routes/purchases.py`)
- Booking checkout → Profile formatting: formats values (evidence: `frontend/routes/purchases.py`)
- API client → API application: HTTP requests (evidence: `README.md`)
- API application → Film routes: registers (evidence: `backend/app.py`)
- API application → Booking routes: registers (evidence: `backend/app.py`)
- API application → Showtime routes: registers (evidence: `backend/app.py`)
- API application → Other API routes: registers (evidence: `backend/app.py`)
- Film routes → Film repository: reads and writes (evidence: `backend/cine_fuente/routes/peliculas.py`)
- Film routes → OMDb integration: queries (evidence: `backend/cine_fuente/routes/peliculas.py`)
- Film routes → Request validators: validates with (evidence: `backend/cine_fuente/routes/peliculas.py`)
- Booking routes → Reservation service: delegates (evidence: `backend/cine_fuente/routes/reservas.py`)
- Booking routes → Notifications: requests notices (evidence: `backend/cine_fuente/routes/reservas.py`)
- Booking routes → Security service: checks access (evidence: `backend/cine_fuente/routes/reservas.py`)
- Booking routes → Request validators: validates with (evidence: `backend/cine_fuente/routes/reservas.py`)
- Showtime routes → Reservation service: uses (evidence: `backend/cine_fuente/routes/funciones.py`)
- Showtime routes → Seat repository: queries seats (evidence: `backend/cine_fuente/routes/funciones.py`)
- Showtime routes → Reservation repository: queries reservations (evidence: `backend/cine_fuente/routes/funciones.py`)
- Reservation expiry → Reservation service: expires reservations (evidence: `backend/cine_fuente/scheduler.py`)
- Notifications → QR generation: generates codes (evidence: `backend/cine_fuente/services/notificaciones_service.py`)
- Notifications → SMTP email: sends email (evidence: `backend/cine_fuente/services/notificaciones_service.py`)
- OMDb integration → OMDb: searches (evidence: `README.md`)
- Film repository → Database access: queries (evidence: `backend/cine_fuente/repositories/peliculas.py`)
- Reservation repository → Database access: queries
- Seat repository → Database access: queries
- User repository → Database access: queries (evidence: `backend/cine_fuente/repositories/usuarios.py`)
- Statistics repository → Database access: queries
- Database access → MySQL database: reads and writes (evidence: `backend/cine_fuente/db.py`)
