# mattenme/cinerama-final-2026 architecture

> Architecture diagram of the GitHub repository mattenme/cinerama-final-2026, 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/mattenme/cinerama-final-2026
- Repository: https://github.com/mattenme/cinerama-final-2026

## Overview

Cinerama is a cinema-management application with an Angular customer/admin interface and a Spring Boot API backed by Oracle. The main customer journey is browsing films and showtimes, selecting seats and confectionery, submitting a purchase, then viewing the ticket or presenting its QR at the entrance. The README also documents ratings, support incidents, administration, and reporting. Sampled sources confirm routing, client-side cart state, and selected controller/service calls; unsampled links are omitted or marked unverified rather than inferred.

Main entry points: [`frontend/src/app/features/pelicula/pelicula.component.ts`](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts) (Film and showtime), [`frontend/src/app/core/services/api.ts`](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/api.ts) (HTTP API client), [`backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java`](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java) (Purchase endpoints), [`backend/src/main/java/pe/edu/upeu/cinerama/services/CompraServiceImpl.java`](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/CompraServiceImpl.java) (Purchase processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular application"]
  node_routes["Application routes<br/>[app.routes.ts]"]
  node_film["Film and showtime"]
  node_cart["Seat and snack cart<br/>[carrito.service.ts]"]
  node_checkout["Checkout"]
  node_clientapi["HTTP API client<br/>[api.ts]"]
  node_catalogui["Catalog and admin pages"]
  node_purchaseui["Purchase client<br/>[compra.service.ts]"]
end

subgraph group_sales["Booking and access"]
  node_salescontroller["Purchase endpoints"]
  node_purchaseservice["Purchase processing"]
  node_qr["Ticket QR<br/>[QRServiceImpl.java]"]
  node_gate["QR entrance validation"]
  node_reservations["Seat reservation expiry"]
end

subgraph group_catalog["Cinema operations"]
  node_catalogops["Films, halls, shows"]
  node_snacks["Snack inventory"]
  node_ratings["Film ratings"]
  node_incidents["Customer incidents"]
end

subgraph group_identity["Identity and analytics"]
  node_authui["Login and session<br/>[auth.service.ts]"]
  node_authcontroller["Authentication endpoints"]
  node_reports["Business reports"]
end

node_visitor(("Customer or staff"))
node_oracle[("Oracle database")]
node_email["Email delivery"]

node_visitor -->|"uses"| node_routes
node_routes -->|"routes to"| node_film
node_film -->|"updates"| node_cart
node_film -->|"opens"| node_checkout
node_checkout -.->|"submits purchase"| node_purchaseui
node_film -->|"loads catalog"| node_catalogui
node_purchaseui -->|"sends requests"| node_clientapi
node_catalogui -->|"sends requests"| node_clientapi
node_clientapi -->|"HTTP API"| node_salescontroller
node_clientapi -.->|"HTTP API"| node_catalogops
node_salescontroller -->|"delegates to"| node_purchaseservice
node_salescontroller -->|"requests QR"| node_qr
node_purchaseservice -.->|"reads and writes"| node_oracle
node_purchaseservice -.->|"creates ticket QR"| node_qr
node_reservations -->|"cleans reservations"| node_oracle
node_visitor -->|"presents QR"| node_gate
node_gate -.->|"validates ticket"| node_oracle
node_visitor -->|"browses snacks"| node_snacks
node_visitor -.->|"rates films"| node_ratings
node_visitor -->|"reports issue"| node_incidents
node_visitor -->|"signs in"| node_authui
node_authui -->|"HTTP API"| node_authcontroller
node_authcontroller -.->|"checks account"| node_oracle
node_visitor -->|"administers"| node_reports
node_reports -->|"runs report queries"| node_oracle
node_visitor -.->|"administers email"| node_email

click node_routes "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/app.routes.ts"
click node_film "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts"
click node_cart "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/carrito.service.ts"
click node_checkout "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/shared/checkout/checkout.component.ts"
click node_clientapi "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/api.ts"
click node_catalogui "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/catalogo.service.ts"
click node_purchaseui "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/compra.service.ts"
click node_salescontroller "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java"
click node_purchaseservice "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/CompraServiceImpl.java"
click node_qr "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/QRServiceImpl.java"
click node_gate "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/PuertaServiceImpl.java"
click node_reservations "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/LimpiezaReservasService.java"
click node_catalogops "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/FuncionServiceImpl.java"
click node_snacks "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/ProductoServiceImpl.java"
click node_ratings "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/CalificacionController.java"
click node_incidents "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/IncidenciaController.java"
click node_authui "https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/auth.service.ts"
click node_authcontroller "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/AuthController.java"
click node_reports "https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/ReporteService.java"

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_film,node_cart,node_checkout,node_clientapi,node_catalogui,node_purchaseui toneBlue
class node_salescontroller,node_purchaseservice,node_qr,node_gate,node_reservations,node_oracle toneAmber
class node_catalogops,node_snacks,node_ratings,node_incidents toneMint
class node_authui,node_authcontroller,node_reports toneRose
class node_visitor,node_email toneIndigo
```

## Components

### Angular application

- [Application routes](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Film and showtime](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts): `frontend/src/app/features/pelicula/pelicula.component.ts`
- [Seat and snack cart](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/carrito.service.ts): `frontend/src/app/core/services/carrito.service.ts`
- [Checkout](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/shared/checkout/checkout.component.ts): `frontend/src/app/shared/checkout/checkout.component.ts`
- [HTTP API client](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/api.ts): `frontend/src/app/core/services/api.ts`
- [Catalog and admin pages](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/catalogo.service.ts): `frontend/src/app/core/services/catalogo.service.ts`
- [Purchase client](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/compra.service.ts): `frontend/src/app/core/services/compra.service.ts`

### Booking and access

- [Purchase endpoints](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java): `backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java`
- [Purchase processing](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/CompraServiceImpl.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/CompraServiceImpl.java`
- [Ticket QR](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/QRServiceImpl.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/QRServiceImpl.java`
- [QR entrance validation](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/PuertaServiceImpl.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/PuertaServiceImpl.java`
- [Seat reservation expiry](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/LimpiezaReservasService.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/LimpiezaReservasService.java`

### Cinema operations

- [Films, halls, shows](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/FuncionServiceImpl.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/FuncionServiceImpl.java`
- [Snack inventory](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/ProductoServiceImpl.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/ProductoServiceImpl.java`
- [Film ratings](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/CalificacionController.java): `backend/src/main/java/pe/edu/upeu/cinerama/controller/CalificacionController.java`
- [Customer incidents](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/IncidenciaController.java): `backend/src/main/java/pe/edu/upeu/cinerama/controller/IncidenciaController.java`

### Identity and analytics

- [Login and session](https://github.com/mattenme/cinerama-final-2026/blob/main/frontend/src/app/core/services/auth.service.ts): `frontend/src/app/core/services/auth.service.ts`
- [Authentication endpoints](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/controller/AuthController.java): `backend/src/main/java/pe/edu/upeu/cinerama/controller/AuthController.java`
- [Business reports](https://github.com/mattenme/cinerama-final-2026/blob/main/backend/src/main/java/pe/edu/upeu/cinerama/services/ReporteService.java): `backend/src/main/java/pe/edu/upeu/cinerama/services/ReporteService.java`

### Other components

- **Customer or staff**
- **Oracle database**
- **Email delivery**

## Connections

- Customer or staff → Application routes: uses (evidence: `README.md`)
- Application routes → Film and showtime: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Film and showtime → Seat and snack cart: updates (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Film and showtime → Checkout: opens (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Checkout → Purchase client: submits purchase (evidence: `frontend/src/app/shared/checkout/checkout.component.ts`)
- Film and showtime → Catalog and admin pages: loads catalog (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Purchase client → HTTP API client: sends requests (evidence: `frontend/src/app/core/services/compra.service.ts`)
- Catalog and admin pages → HTTP API client: sends requests (evidence: `frontend/src/app/core/services/catalogo.service.ts`)
- HTTP API client → Purchase endpoints: HTTP API (evidence: `README.md`)
- HTTP API client → Films, halls, shows: HTTP API
- Purchase endpoints → Purchase processing: delegates to (evidence: `backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java`)
- Purchase endpoints → Ticket QR: requests QR (evidence: `backend/src/main/java/pe/edu/upeu/cinerama/controller/CompraController.java`)
- Purchase processing → Oracle database: reads and writes
- Purchase processing → Ticket QR: creates ticket QR
- Seat reservation expiry → Oracle database: cleans reservations (evidence: `backend/src/main/java/pe/edu/upeu/cinerama/services/LimpiezaReservasService.java`)
- Customer or staff → QR entrance validation: presents QR (evidence: `README.md`)
- QR entrance validation → Oracle database: validates ticket
- Customer or staff → Snack inventory: browses snacks (evidence: `README.md`)
- Customer or staff → Film ratings: rates films
- Customer or staff → Customer incidents: reports issue (evidence: `README.md`)
- Customer or staff → Login and session: signs in (evidence: `README.md`)
- Login and session → Authentication endpoints: HTTP API (evidence: `README.md`)
- Authentication endpoints → Oracle database: checks account
- Customer or staff → Business reports: administers (evidence: `README.md`)
- Business reports → Oracle database: runs report queries (evidence: `backend/src/main/java/pe/edu/upeu/cinerama/services/ReporteService.java`)
- Customer or staff → Email delivery: administers email
