# imsteffy/backend-grupo-lotus architecture

> Architecture diagram of the GitHub repository imsteffy/backend-grupo-lotus, 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/imsteffy/backend-grupo-lotus
- Repository: https://github.com/imsteffy/backend-grupo-lotus

## Overview

Kiroku is an anime catalog and community REST API. A client request enters the Express app, is dispatched to a resource route, and then handled by a controller that reads or writes MongoDB; protected routes validate a JWT and may enforce roles. The product also supports personal tracking, reviews, rankings and dashboards, account administration, genre management, and administrator-assisted external catalog import. Route wiring and sampled controller/model references support the main relationships; unsampled controller behavior is represented at subsystem level based on the README and source index.

Main entry points: [`src/app.js`](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/app.js) (Express App), [`src/controllers/usuario.controller.js`](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/usuario.controller.js) (Account Management), [`src/routes/animes.routes.js`](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/animes.routes.js) (Anime Routes), [`src/controllers/anime.controller.js`](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/anime.controller.js) (Anime Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Security"]
  node_app["Express App<br/>[app.js]"]
  node_auth_routes["Auth Routes<br/>[auth.routes.js]"]
  node_user_routes["User Routes<br/>[usuarios.routes.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_user_controller["Account Management"]
  node_auth_middleware["JWT Authentication<br/>[auth.middleware.js]"]
  node_role_middleware["Role Authorization"]
end

subgraph group_catalog["Catalog Management"]
  node_anime_routes["Anime Routes<br/>[animes.routes.js]"]
  node_genre_routes["Genre Routes<br/>[generos.routes.js]"]
  node_anime_controller["Anime Catalog"]
  node_genre_controller["Genre Management"]
end

subgraph group_community["Personal and Community"]
  node_tracking_routes["Tracking Routes"]
  node_review_routes["Review Routes<br/>[resenas.routes.js]"]
  node_stats_routes["Statistics Routes<br/>[stats.routes.js]"]
  node_tracking_controller["Personal Tracking"]
  node_review_controller["Community Reviews"]
  node_stats_controller["Rankings and Stats"]
end

subgraph group_persistence["Persistence"]
  node_user_model[("User Records<br/>[Usuario.js]")]
  node_anime_model[("Anime Records<br/>[Anime.js]")]
  node_genre_model[("Genre Records<br/>[Genero.js]")]
  node_tracking_model[("Tracking Records<br/>[Seguimiento.js]")]
  node_review_model[("Review Records<br/>[Resena.js]")]
  node_db_config["MongoDB Connection<br/>[db.js]"]
end

node_client(("API Client"))
node_mongo[("MongoDB Atlas")]
node_external_catalog{{"Jikan and AniList"}}

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_user_routes
node_app -->|"mounts routes"| node_anime_routes
node_app -->|"mounts routes"| node_genre_routes
node_app -->|"mounts routes"| node_tracking_routes
node_app -->|"mounts routes"| node_review_routes
node_app -->|"mounts routes"| node_stats_routes
node_app -->|"connects through"| node_db_config
node_db_config -->|"connects to"| node_mongo
node_auth_routes -->|"dispatches to"| node_auth_controller
node_user_routes -->|"dispatches to"| node_user_controller
node_anime_routes -->|"dispatches to"| node_anime_controller
node_genre_routes -->|"dispatches to"| node_genre_controller
node_tracking_routes -->|"dispatches to"| node_tracking_controller
node_review_routes -->|"dispatches to"| node_review_controller
node_stats_routes -->|"dispatches to"| node_stats_controller
node_anime_routes -->|"protects admin actions"| node_auth_middleware
node_anime_routes -->|"checks admin role"| node_role_middleware
node_auth_middleware -->|"loads account"| node_user_model
node_auth_controller -->|"manages accounts"| node_user_model
node_user_controller -->|"manages accounts"| node_user_model
node_user_controller -->|"checks dependencies"| node_tracking_model
node_user_controller -->|"checks dependencies"| node_review_model
node_anime_controller -->|"queries and updates"| node_anime_model
node_anime_controller -->|"resolves genres"| node_genre_controller
node_anime_controller -->|"imports catalog data"| node_external_catalog
node_genre_controller -->|"manages genres"| node_genre_model
node_genre_controller -->|"checks genre use"| node_anime_model
node_tracking_controller -->|"manages tracking"| node_tracking_model
node_review_controller -->|"manages reviews"| node_review_model
node_stats_controller -->|"aggregates tracking"| node_tracking_model

click node_app "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/app.js"
click node_auth_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/auth.routes.js"
click node_user_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/usuarios.routes.js"
click node_anime_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/animes.routes.js"
click node_genre_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/generos.routes.js"
click node_tracking_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/seguimientos.routes.js"
click node_review_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/resenas.routes.js"
click node_stats_routes "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/stats.routes.js"
click node_auth_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/auth.controller.js"
click node_user_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/usuario.controller.js"
click node_auth_middleware "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/middlewares/auth.middleware.js"
click node_role_middleware "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/middlewares/authorize.middleware.js"
click node_anime_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/anime.controller.js"
click node_genre_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/genero.controller.js"
click node_tracking_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/seguimiento.controller.js"
click node_review_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/resena.controller.js"
click node_stats_controller "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/stats.controller.js"
click node_user_model "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Usuario.js"
click node_anime_model "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Anime.js"
click node_genre_model "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Genero.js"
click node_tracking_model "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Seguimiento.js"
click node_review_model "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Resena.js"
click node_db_config "https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/config/db.js"

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_app,node_auth_routes,node_user_routes,node_auth_controller,node_user_controller,node_auth_middleware,node_role_middleware,node_client toneBlue
class node_anime_routes,node_genre_routes,node_anime_controller,node_genre_controller,node_mongo toneAmber
class node_tracking_routes,node_review_routes,node_stats_routes,node_tracking_controller,node_review_controller,node_stats_controller toneMint
class node_user_model,node_anime_model,node_genre_model,node_tracking_model,node_review_model,node_db_config toneRose
class node_external_catalog toneIndigo
```

## Components

### API and Security

- [Express App](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/app.js): `src/app.js`
- [Auth Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [User Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/usuarios.routes.js): `src/routes/usuarios.routes.js`
- [Authentication](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [Account Management](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/usuario.controller.js): `src/controllers/usuario.controller.js`
- [JWT Authentication](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [Role Authorization](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/middlewares/authorize.middleware.js): `src/middlewares/authorize.middleware.js`

### Catalog Management

- [Anime Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/animes.routes.js): `src/routes/animes.routes.js`
- [Genre Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/generos.routes.js): `src/routes/generos.routes.js`
- [Anime Catalog](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/anime.controller.js): `src/controllers/anime.controller.js`
- [Genre Management](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/genero.controller.js): `src/controllers/genero.controller.js`

### Personal and Community

- [Tracking Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/seguimientos.routes.js): `src/routes/seguimientos.routes.js`
- [Review Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/resenas.routes.js): `src/routes/resenas.routes.js`
- [Statistics Routes](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/routes/stats.routes.js): `src/routes/stats.routes.js`
- [Personal Tracking](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/seguimiento.controller.js): `src/controllers/seguimiento.controller.js`
- [Community Reviews](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/resena.controller.js): `src/controllers/resena.controller.js`
- [Rankings and Stats](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/controllers/stats.controller.js): `src/controllers/stats.controller.js`

### Persistence

- [User Records](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Usuario.js): `src/models/Usuario.js`
- [Anime Records](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Anime.js): `src/models/Anime.js`
- [Genre Records](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Genero.js): `src/models/Genero.js`
- [Tracking Records](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Seguimiento.js): `src/models/Seguimiento.js`
- [Review Records](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/models/Resena.js): `src/models/Resena.js`
- [MongoDB Connection](https://github.com/imsteffy/backend-grupo-lotus/blob/main/src/config/db.js): `src/config/db.js`

### Other components

- **API Client**
- **MongoDB Atlas**
- **Jikan and AniList**

## Connections

- API Client → Express App: sends requests (evidence: `src/app.js`)
- Express App → Auth Routes: mounts routes (evidence: `src/app.js`)
- Express App → User Routes: mounts routes (evidence: `src/app.js`)
- Express App → Anime Routes: mounts routes (evidence: `src/app.js`)
- Express App → Genre Routes: mounts routes (evidence: `src/app.js`)
- Express App → Tracking Routes: mounts routes (evidence: `src/app.js`)
- Express App → Review Routes: mounts routes (evidence: `src/app.js`)
- Express App → Statistics Routes: mounts routes (evidence: `src/app.js`)
- Express App → MongoDB Connection: connects through (evidence: `src/app.js`)
- MongoDB Connection → MongoDB Atlas: connects to (evidence: `src/config/db.js`)
- Auth Routes → Authentication: dispatches to (evidence: `src/routes/auth.routes.js`)
- User Routes → Account Management: dispatches to (evidence: `src/routes/usuarios.routes.js`)
- Anime Routes → Anime Catalog: dispatches to (evidence: `src/routes/animes.routes.js`)
- Genre Routes → Genre Management: dispatches to (evidence: `src/routes/generos.routes.js`)
- Tracking Routes → Personal Tracking: dispatches to (evidence: `src/routes/seguimientos.routes.js`)
- Review Routes → Community Reviews: dispatches to (evidence: `src/routes/resenas.routes.js`)
- Statistics Routes → Rankings and Stats: dispatches to (evidence: `src/routes/stats.routes.js`)
- Anime Routes → JWT Authentication: protects admin actions (evidence: `src/routes/animes.routes.js`)
- Anime Routes → Role Authorization: checks admin role (evidence: `src/routes/animes.routes.js`)
- JWT Authentication → User Records: loads account (evidence: `src/middlewares/auth.middleware.js`)
- Authentication → User Records: manages accounts (evidence: `src/controllers/auth.controller.js`)
- Account Management → User Records: manages accounts (evidence: `src/controllers/usuario.controller.js`)
- Account Management → Tracking Records: checks dependencies (evidence: `src/controllers/usuario.controller.js`)
- Account Management → Review Records: checks dependencies (evidence: `src/controllers/usuario.controller.js`)
- Anime Catalog → Anime Records: queries and updates (evidence: `src/controllers/anime.controller.js`)
- Anime Catalog → Genre Management: resolves genres (evidence: `src/controllers/anime.controller.js`)
- Anime Catalog → Jikan and AniList: imports catalog data (evidence: `src/controllers/anime.controller.js`)
- Genre Management → Genre Records: manages genres (evidence: `src/controllers/genero.controller.js`)
- Genre Management → Anime Records: checks genre use (evidence: `src/controllers/genero.controller.js`)
- Personal Tracking → Tracking Records: manages tracking (evidence: `src/controllers/seguimiento.controller.js`)
- Community Reviews → Review Records: manages reviews (evidence: `src/controllers/resena.controller.js`)
- Rankings and Stats → Tracking Records: aggregates tracking (evidence: `src/controllers/stats.controller.js`)
