# mattenme/cinerama-2026-c2 architecture

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

- Interactive diagram: https://gitdiagram.com/mattenme/cinerama-2026-c2
- Repository: https://github.com/mattenme/cinerama-2026-c2

## Overview

Cinerama is a cinema-ticketing system with an Angular storefront and Spring Boot API backed by Oracle. The customer journey spans browsing films and showtimes, choosing seats and concessions, applying promotions, purchasing, and receiving a QR ticket; accounts and purchase history support that journey. The API also exposes cinema-management capabilities for films, showtimes, products, and promotions. The sampled code confirms authentication, catalog HTTP calls, and purchase processing; several feature implementations and controller links are unsampled, so those connections are shown only where documentation or indexed references support them.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/app.routes.ts) (App routes), [`frontend/src/app/core/services/compra.service.ts`](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/compra.service.ts) (Purchase API client), [`frontend/src/app/features/pelicula/pelicula.component.ts`](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts) (Film and seats), [`backend/src/main/java/cinerama/service/CompraServiceImpl.java`](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/service/CompraServiceImpl.java) (Purchase processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_film_views["Film browsing"]
  node_film_detail["Film and seats"]
  node_concessions["Concessions"]
  node_cart_view["Cart and checkout"]
  node_confirmation["Ticket confirmation"]
  node_purchase_history["Purchase history"]
  node_admin_views["Admin screens"]
  node_auth_web["Web authentication<br/>[auth.service.ts]"]
  node_cart_state["Cart state<br/>[carrito.service.ts]"]
  node_catalog_api["Catalog API client"]
  node_purchase_api["Purchase API client<br/>[compra.service.ts]"]
  node_http_api["HTTP API base<br/>[api.ts]"]
end

subgraph group_backend["Cinema API"]
  node_auth_controller["Authentication endpoints"]
  node_controllers["Cinema endpoints"]
  node_purchase_controller["Purchase endpoint"]
  node_purchase_service["Purchase processing"]
end

subgraph group_data["Persistence and domain"]
  node_domain["Cinema records"]
  node_repositories["Data repositories"]
  node_oracle[("Oracle database")]
end

subgraph group_integrations["External integrations"]
  node_email["Verification email<br/>[EmailUtil.java]"]
  node_qr["QR generation<br/>[QRUtil.java]"]
end

node_customer(("Cinema customer"))
node_admin(("Cinema admin"))

node_customer -->|"uses storefront"| node_routes
node_admin -->|"uses storefront"| node_routes
node_routes -->|"routes to"| node_film_views
node_routes -->|"routes to"| node_film_detail
node_routes -->|"routes to"| node_concessions
node_routes -->|"routes to"| node_cart_view
node_routes -->|"routes to"| node_confirmation
node_routes -->|"routes to"| node_purchase_history
node_routes -->|"routes to"| node_admin_views
node_routes -->|"guards routes"| node_auth_web
node_film_detail -->|"requests catalog"| node_catalog_api
node_film_detail -->|"updates cart"| node_cart_state
node_film_detail -->|"checks purchases"| node_purchase_api
node_auth_web -->|"calls API"| node_http_api
node_catalog_api -->|"calls API"| node_http_api
node_purchase_api -->|"calls API"| node_http_api
node_http_api -->|"consumes API"| node_controllers
node_auth_controller -->|"serves auth calls"| node_auth_web
node_auth_controller -->|"sends verification"| node_email
node_controllers -.->|"serves catalog calls"| node_catalog_api
node_purchase_api -->|"submits purchases"| node_purchase_controller
node_purchase_history -.->|"loads history"| node_purchase_api
node_cart_view -.->|"reads cart"| node_cart_state
node_cart_view -.->|"submits checkout"| node_purchase_api
node_purchase_controller -->|"delegates purchase"| node_purchase_service
node_purchase_controller -->|"generates QR"| node_qr
node_purchase_service -->|"reads and writes"| node_repositories
node_purchase_service -->|"uses records"| node_domain
node_purchase_service -->|"sends purchase email"| node_email
node_repositories -.->|"persists records"| node_oracle
node_admin_views -.->|"manages catalog"| node_catalog_api
node_customer -->|"browses films"| node_film_views
node_customer -->|"selects seats"| node_film_detail
node_customer -->|"chooses concessions"| node_concessions
node_customer -->|"purchases tickets"| node_cart_view
node_purchase_api -.->|"returns purchase"| node_confirmation
node_confirmation -->|"shows QR ticket"| node_qr

click node_routes "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/app.routes.ts"
click node_film_views "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/cartelera/cartelera.component.ts"
click node_film_detail "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts"
click node_concessions "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/dulceria/dulceria.component.ts"
click node_cart_view "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/carrito/carrito.component.ts"
click node_confirmation "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/confirmacion/confirmacion.component.ts"
click node_purchase_history "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/mis-compras/mis-compras.component.ts"
click node_admin_views "https://github.com/mattenme/cinerama-2026-c2/tree/main/frontend/src/app/features/admin"
click node_auth_web "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/auth.service.ts"
click node_cart_state "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/carrito.service.ts"
click node_catalog_api "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/catalogo.service.ts"
click node_purchase_api "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/compra.service.ts"
click node_http_api "https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/api.ts"
click node_auth_controller "https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/controller/AuthController.java"
click node_controllers "https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/controller"
click node_purchase_controller "https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/controller/CompraController.java"
click node_purchase_service "https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/service/CompraServiceImpl.java"
click node_domain "https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/entity"
click node_repositories "https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/repository"
click node_email "https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/util/EmailUtil.java"
click node_qr "https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/util/QRUtil.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_views,node_film_detail,node_concessions,node_cart_view,node_confirmation,node_purchase_history,node_admin_views,node_auth_web,node_cart_state,node_catalog_api,node_purchase_api,node_http_api toneBlue
class node_auth_controller,node_controllers,node_purchase_controller,node_purchase_service toneAmber
class node_domain,node_repositories,node_oracle toneMint
class node_email,node_qr toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Web experience

- [App routes](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Film browsing](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/cartelera/cartelera.component.ts): `frontend/src/app/features/cartelera/cartelera.component.ts`
- [Film and seats](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/pelicula/pelicula.component.ts): `frontend/src/app/features/pelicula/pelicula.component.ts`
- [Concessions](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/dulceria/dulceria.component.ts): `frontend/src/app/features/dulceria/dulceria.component.ts`
- [Cart and checkout](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/carrito/carrito.component.ts): `frontend/src/app/features/carrito/carrito.component.ts`
- [Ticket confirmation](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/confirmacion/confirmacion.component.ts): `frontend/src/app/features/confirmacion/confirmacion.component.ts`
- [Purchase history](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/features/mis-compras/mis-compras.component.ts): `frontend/src/app/features/mis-compras/mis-compras.component.ts`
- [Admin screens](https://github.com/mattenme/cinerama-2026-c2/tree/main/frontend/src/app/features/admin): `frontend/src/app/features/admin`
- [Web authentication](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/auth.service.ts): `frontend/src/app/core/services/auth.service.ts`
- [Cart state](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/carrito.service.ts): `frontend/src/app/core/services/carrito.service.ts`
- [Catalog API client](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/catalogo.service.ts): `frontend/src/app/core/services/catalogo.service.ts`
- [Purchase API client](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/compra.service.ts): `frontend/src/app/core/services/compra.service.ts`
- [HTTP API base](https://github.com/mattenme/cinerama-2026-c2/blob/main/frontend/src/app/core/services/api.ts): `frontend/src/app/core/services/api.ts`

### Cinema API

- [Authentication endpoints](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/controller/AuthController.java): `backend/src/main/java/cinerama/controller/AuthController.java`
- [Cinema endpoints](https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/controller): `backend/src/main/java/cinerama/controller`
- [Purchase endpoint](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/controller/CompraController.java): `backend/src/main/java/cinerama/controller/CompraController.java`
- [Purchase processing](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/service/CompraServiceImpl.java): `backend/src/main/java/cinerama/service/CompraServiceImpl.java`

### Persistence and domain

- [Cinema records](https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/entity): `backend/src/main/java/cinerama/entity`
- [Data repositories](https://github.com/mattenme/cinerama-2026-c2/tree/main/backend/src/main/java/cinerama/repository): `backend/src/main/java/cinerama/repository`
- **Oracle database**

### External integrations

- [Verification email](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/util/EmailUtil.java): `backend/src/main/java/cinerama/util/EmailUtil.java`
- [QR generation](https://github.com/mattenme/cinerama-2026-c2/blob/main/backend/src/main/java/cinerama/util/QRUtil.java): `backend/src/main/java/cinerama/util/QRUtil.java`

### Other components

- **Cinema customer**
- **Cinema admin**

## Connections

- Cinema customer → App routes: uses storefront (evidence: `README.md`)
- Cinema admin → App routes: uses storefront (evidence: `README.md`)
- App routes → Film browsing: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Film and seats: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Concessions: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Cart and checkout: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Ticket confirmation: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Purchase history: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Admin screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Web authentication: guards routes (evidence: `frontend/src/app/app.routes.ts`)
- Film and seats → Catalog API client: requests catalog (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Film and seats → Cart state: updates cart (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Film and seats → Purchase API client: checks purchases (evidence: `frontend/src/app/features/pelicula/pelicula.component.ts`)
- Web authentication → HTTP API base: calls API (evidence: `frontend/src/app/core/services/auth.service.ts`)
- Catalog API client → HTTP API base: calls API (evidence: `frontend/src/app/core/services/catalogo.service.ts`)
- Purchase API client → HTTP API base: calls API (evidence: `frontend/src/app/core/services/compra.service.ts`)
- HTTP API base → Cinema endpoints: consumes API (evidence: `README.md`)
- Authentication endpoints → Web authentication: serves auth calls (evidence: `backend/src/main/java/cinerama/controller/AuthController.java`)
- Authentication endpoints → Verification email: sends verification (evidence: `backend/src/main/java/cinerama/controller/AuthController.java`)
- Cinema endpoints → Catalog API client: serves catalog calls
- Purchase API client → Purchase endpoint: submits purchases (evidence: `backend/src/main/java/cinerama/controller/CompraController.java`)
- Purchase history → Purchase API client: loads history
- Cart and checkout → Cart state: reads cart (evidence: `frontend/src/app/features/carrito/carrito.component.ts`)
- Cart and checkout → Purchase API client: submits checkout (evidence: `frontend/src/app/features/carrito/carrito.component.ts`)
- Purchase endpoint → Purchase processing: delegates purchase (evidence: `backend/src/main/java/cinerama/controller/CompraController.java`)
- Purchase endpoint → QR generation: generates QR (evidence: `backend/src/main/java/cinerama/controller/CompraController.java`)
- Purchase processing → Data repositories: reads and writes (evidence: `backend/src/main/java/cinerama/service/CompraServiceImpl.java`)
- Purchase processing → Cinema records: uses records (evidence: `backend/src/main/java/cinerama/service/CompraServiceImpl.java`)
- Purchase processing → Verification email: sends purchase email (evidence: `backend/src/main/java/cinerama/service/CompraServiceImpl.java`)
- Data repositories → Oracle database: persists records
- Admin screens → Catalog API client: manages catalog (evidence: `frontend/src/app/features/admin/promociones/admin-promociones.component.ts`)
- Cinema customer → Film browsing: browses films (evidence: `README.md`)
- Cinema customer → Film and seats: selects seats (evidence: `README.md`)
- Cinema customer → Concessions: chooses concessions (evidence: `README.md`)
- Cinema customer → Cart and checkout: purchases tickets (evidence: `README.md`)
- Purchase API client → Ticket confirmation: returns purchase
- Ticket confirmation → QR generation: shows QR ticket (evidence: `README.md`)
