# dy0rama/api-restful-para-servico-de-streaming architecture

> Architecture diagram of the GitHub repository dy0rama/api-restful-para-servico-de-streaming, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dy0rama/api-restful-para-servico-de-streaming
- Repository: https://github.com/dy0rama/api-restful-para-servico-de-streaming

## Overview

A REST API for a streaming platform, with account registration and management, plan-based sharing, age- and plan-filtered catalog access, simulated playback, and per-user history. The principal flow is signup or login, then authenticated account/catalog actions; playback checks eligibility before simulation and history recording. Security and initial catalog loading are included as documented capabilities. Source excerpts show several service calls; unsampled security wiring and some persistence details are represented only where the README supports them.

Main entry points: [`src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/AssistirFilmeService.java) (Playback Rules), [`src/main/java/com/ebac/streaming/services/UsuarioService.java`](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/UsuarioService.java) (Account Rules), [`src/main/java/com/ebac/streaming/controller/TokenController.java`](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/TokenController.java) (Token API), [`src/main/java/com/ebac/streaming/controller/FilmeController.java`](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/FilmeController.java) (Catalog API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and Plans"]
  node_signup["Subscriber Signup"]
  node_account_api["Account API"]
  node_user_service["Account Rules"]
  node_user_repo["User Repository"]
  node_user_entity["User and Plan<br/>[Usuario.java]"]
end

subgraph group_identity["Identity and Security"]
  node_auth_api["Session API"]
  node_token_api["Token API"]
  node_token_service["Token Service<br/>[TokenService.java]"]
  node_user_details["Login Lookup"]
  node_security["JWT Security"]
  node_jwt_config["JWT Configuration<br/>[JwtConfig.java]"]
end

subgraph group_catalog["Catalog and Playback"]
  node_catalog_api["Catalog API"]
  node_catalog_service["Catalog Filtering<br/>[FilmeService.java]"]
  node_access_policy["Viewing Policy"]
  node_playback_service["Playback Rules"]
  node_simulator["Playback Simulator"]
  node_film_repo["Film Repository"]
  node_film_entity["Film Records<br/>[Filme.java]"]
  node_catalog_seed["Initial Catalog Load"]
end

subgraph group_history["Viewing History"]
  node_history_api["History API"]
  node_history_service["History Queries"]
  node_history_repo["History Repository"]
  node_history_entity["Viewing Records"]
end

node_client(("API Client"))
node_mysql[("MySQL Database")]

node_client -->|"registers"| node_signup
node_signup -->|"creates subscriber"| node_user_service
node_user_service -->|"saves and queries"| node_user_repo
node_user_repo -.->|"persists users"| node_mysql
node_client -->|"requests token"| node_token_api
node_token_api -->|"requests token"| node_token_service
node_token_api -->|"loads login user"| node_user_details
node_user_details -->|"looks up email"| node_user_repo
node_security -.->|"configures JWT"| node_jwt_config
node_client -->|"manages account"| node_account_api
node_account_api -->|"delegates account actions"| node_user_service
node_client -->|"requests session"| node_auth_api
node_auth_api -->|"loads session details"| node_user_service
node_client -->|"browses or watches"| node_catalog_api
node_catalog_api -->|"requests filtered catalog"| node_catalog_service
node_catalog_service -->|"checks eligibility"| node_access_policy
node_catalog_service -->|"loads films"| node_film_repo
node_catalog_api -->|"starts playback"| node_playback_service
node_playback_service -->|"checks eligibility"| node_access_policy
node_playback_service -->|"simulates duration"| node_simulator
node_playback_service -->|"loads requested film"| node_film_repo
node_catalog_seed -.->|"loads sample films"| node_mysql
node_client -->|"requests history"| node_history_api
node_history_api -->|"requests user history"| node_history_service
node_history_service -->|"queries viewing records"| node_history_repo
node_playback_service -->|"records completed view"| node_history_repo
node_user_entity -.->|"stores account data"| node_mysql
node_film_entity -.->|"stores catalog data"| node_mysql
node_history_entity -.->|"stores viewing data"| node_mysql

click node_signup "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/UsuarioController.java"
click node_account_api "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/ContaController.java"
click node_user_service "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/UsuarioService.java"
click node_user_repo "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/UsuarioRepository.java"
click node_user_entity "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/Usuario.java"
click node_auth_api "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/AuthController.java"
click node_token_api "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/TokenController.java"
click node_token_service "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/TokenService.java"
click node_user_details "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/UsuarioDetailsService.java"
click node_security "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/configurations/SecurityConfig.java"
click node_jwt_config "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/configurations/JwtConfig.java"
click node_catalog_api "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/FilmeController.java"
click node_catalog_service "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/FilmeService.java"
click node_access_policy "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/AcessoFilmePolicy.java"
click node_playback_service "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/AssistirFilmeService.java"
click node_simulator "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/SimuladorReproducao.java"
click node_film_repo "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/FilmeRepository.java"
click node_film_entity "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/Filme.java"
click node_catalog_seed "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/CargaInicialFilmes.java"
click node_history_api "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/HistoricoController.java"
click node_history_service "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/HistoricoService.java"
click node_history_repo "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/HistoricoFilmeRepository.java"
click node_history_entity "https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/HistoricoFilme.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_signup,node_account_api,node_user_service,node_user_repo,node_user_entity,node_client toneBlue
class node_auth_api,node_token_api,node_token_service,node_user_details,node_security,node_jwt_config,node_mysql toneAmber
class node_catalog_api,node_catalog_service,node_access_policy,node_playback_service,node_simulator,node_film_repo,node_film_entity,node_catalog_seed toneMint
class node_history_api,node_history_service,node_history_repo,node_history_entity toneRose
```

## Components

### Accounts and Plans

- [Subscriber Signup](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/UsuarioController.java): `src/main/java/com/ebac/streaming/controller/UsuarioController.java`
- [Account API](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/ContaController.java): `src/main/java/com/ebac/streaming/controller/ContaController.java`
- [Account Rules](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/UsuarioService.java): `src/main/java/com/ebac/streaming/services/UsuarioService.java`
- [User Repository](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/UsuarioRepository.java): `src/main/java/com/ebac/streaming/repository/UsuarioRepository.java`
- [User and Plan](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/Usuario.java): `src/main/java/com/ebac/streaming/entities/Usuario.java`

### Identity and Security

- [Session API](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/AuthController.java): `src/main/java/com/ebac/streaming/controller/AuthController.java`
- [Token API](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/TokenController.java): `src/main/java/com/ebac/streaming/controller/TokenController.java`
- [Token Service](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/TokenService.java): `src/main/java/com/ebac/streaming/services/TokenService.java`
- [Login Lookup](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/UsuarioDetailsService.java): `src/main/java/com/ebac/streaming/services/UsuarioDetailsService.java`
- [JWT Security](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/configurations/SecurityConfig.java): `src/main/java/com/ebac/streaming/configurations/SecurityConfig.java`
- [JWT Configuration](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/configurations/JwtConfig.java): `src/main/java/com/ebac/streaming/configurations/JwtConfig.java`

### Catalog and Playback

- [Catalog API](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/FilmeController.java): `src/main/java/com/ebac/streaming/controller/FilmeController.java`
- [Catalog Filtering](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/FilmeService.java): `src/main/java/com/ebac/streaming/services/FilmeService.java`
- [Viewing Policy](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/AcessoFilmePolicy.java): `src/main/java/com/ebac/streaming/services/AcessoFilmePolicy.java`
- [Playback Rules](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/AssistirFilmeService.java): `src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`
- [Playback Simulator](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/SimuladorReproducao.java): `src/main/java/com/ebac/streaming/services/SimuladorReproducao.java`
- [Film Repository](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/FilmeRepository.java): `src/main/java/com/ebac/streaming/repository/FilmeRepository.java`
- [Film Records](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/Filme.java): `src/main/java/com/ebac/streaming/entities/Filme.java`
- [Initial Catalog Load](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/CargaInicialFilmes.java): `src/main/java/com/ebac/streaming/services/CargaInicialFilmes.java`

### Viewing History

- [History API](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/controller/HistoricoController.java): `src/main/java/com/ebac/streaming/controller/HistoricoController.java`
- [History Queries](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/services/HistoricoService.java): `src/main/java/com/ebac/streaming/services/HistoricoService.java`
- [History Repository](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/repository/HistoricoFilmeRepository.java): `src/main/java/com/ebac/streaming/repository/HistoricoFilmeRepository.java`
- [Viewing Records](https://github.com/dy0rama/api-restful-para-servico-de-streaming/blob/main/src/main/java/com/ebac/streaming/entities/HistoricoFilme.java): `src/main/java/com/ebac/streaming/entities/HistoricoFilme.java`

### Other components

- **API Client**
- **MySQL Database**

## Connections

- API Client → Subscriber Signup: registers
- Subscriber Signup → Account Rules: creates subscriber (evidence: `src/main/java/com/ebac/streaming/controller/UsuarioController.java`)
- Account Rules → User Repository: saves and queries (evidence: `src/main/java/com/ebac/streaming/services/UsuarioService.java`)
- User Repository → MySQL Database: persists users
- API Client → Token API: requests token
- Token API → Token Service: requests token (evidence: `src/main/java/com/ebac/streaming/controller/TokenController.java`)
- Token API → Login Lookup: loads login user (evidence: `src/main/java/com/ebac/streaming/controller/TokenController.java`)
- Login Lookup → User Repository: looks up email (evidence: `src/main/java/com/ebac/streaming/services/UsuarioDetailsService.java`)
- JWT Security → JWT Configuration: configures JWT
- API Client → Account API: manages account
- Account API → Account Rules: delegates account actions (evidence: `src/main/java/com/ebac/streaming/controller/ContaController.java`)
- API Client → Session API: requests session
- Session API → Account Rules: loads session details (evidence: `src/main/java/com/ebac/streaming/controller/AuthController.java`)
- API Client → Catalog API: browses or watches
- Catalog API → Catalog Filtering: requests filtered catalog (evidence: `src/main/java/com/ebac/streaming/controller/FilmeController.java`)
- Catalog Filtering → Viewing Policy: checks eligibility (evidence: `src/main/java/com/ebac/streaming/services/FilmeService.java`)
- Catalog Filtering → Film Repository: loads films (evidence: `src/main/java/com/ebac/streaming/services/FilmeService.java`)
- Catalog API → Playback Rules: starts playback (evidence: `src/main/java/com/ebac/streaming/controller/FilmeController.java`)
- Playback Rules → Viewing Policy: checks eligibility (evidence: `src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`)
- Playback Rules → Playback Simulator: simulates duration (evidence: `src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`)
- Playback Rules → Film Repository: loads requested film (evidence: `src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`)
- Initial Catalog Load → MySQL Database: loads sample films
- API Client → History API: requests history
- History API → History Queries: requests user history (evidence: `src/main/java/com/ebac/streaming/controller/HistoricoController.java`)
- History Queries → History Repository: queries viewing records (evidence: `src/main/java/com/ebac/streaming/services/HistoricoService.java`)
- Playback Rules → History Repository: records completed view (evidence: `src/main/java/com/ebac/streaming/services/AssistirFilmeService.java`)
- User and Plan → MySQL Database: stores account data
- Film Records → MySQL Database: stores catalog data
- Viewing Records → MySQL Database: stores viewing data
