How imsteffy/backend-grupo-lotus works
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: app.js Express App · usuario.controller.js Account Management · animes.routes.js Anime Routes · anime.controller.js Anime Catalog
Components 26
API and Security
- Express App
src/app.js - Auth Routes
src/routes/auth.routes.js - User Routes
src/routes/usuarios.routes.js - Authentication
src/controllers/auth.controller.js - Account Management
src/controllers/usuario.controller.js - JWT Authentication
src/middlewares/auth.middleware.js - Role Authorization
src/middlewares/authorize.middleware.js
Catalog Management
- Anime Routes
src/routes/animes.routes.js - Genre Routes
src/routes/generos.routes.js - Anime Catalog
src/controllers/anime.controller.js - Genre Management
src/controllers/genero.controller.js
Personal and Community
- Tracking Routes
src/routes/seguimientos.routes.js - Review Routes
src/routes/resenas.routes.js - Statistics Routes
src/routes/stats.routes.js - Personal Tracking
src/controllers/seguimiento.controller.js - Community Reviews
src/controllers/resena.controller.js - Rankings and Stats
src/controllers/stats.controller.js
Persistence
- User Records
src/models/Usuario.js - Anime Records
src/models/Anime.js - Genre Records
src/models/Genero.js - Tracking Records
src/models/Seguimiento.js - Review Records
src/models/Resena.js - MongoDB Connection
src/config/db.js
Other components
- API Client
- MongoDB Atlas
- Jikan and AniList
Connections 32
- API Client → Express App: sends requests
src/app.js - Express App → Auth Routes: mounts routes
src/app.js - Express App → User Routes: mounts routes
src/app.js - Express App → Anime Routes: mounts routes
src/app.js - Express App → Genre Routes: mounts routes
src/app.js - Express App → Tracking Routes: mounts routes
src/app.js - Express App → Review Routes: mounts routes
src/app.js - Express App → Statistics Routes: mounts routes
src/app.js - Express App → MongoDB Connection: connects through
src/app.js - MongoDB Connection → MongoDB Atlas: connects to
src/config/db.js - Auth Routes → Authentication: dispatches to
src/routes/auth.routes.js - User Routes → Account Management: dispatches to
src/routes/usuarios.routes.js - Anime Routes → Anime Catalog: dispatches to
src/routes/animes.routes.js - Genre Routes → Genre Management: dispatches to
src/routes/generos.routes.js - Tracking Routes → Personal Tracking: dispatches to
src/routes/seguimientos.routes.js - Review Routes → Community Reviews: dispatches to
src/routes/resenas.routes.js - Statistics Routes → Rankings and Stats: dispatches to
src/routes/stats.routes.js - Anime Routes → JWT Authentication: protects admin actions
src/routes/animes.routes.js - Anime Routes → Role Authorization: checks admin role
src/routes/animes.routes.js - JWT Authentication → User Records: loads account
src/middlewares/auth.middleware.js - Authentication → User Records: manages accounts
src/controllers/auth.controller.js - Account Management → User Records: manages accounts
src/controllers/usuario.controller.js - Account Management → Tracking Records: checks dependencies
src/controllers/usuario.controller.js - Account Management → Review Records: checks dependencies
src/controllers/usuario.controller.js - Anime Catalog → Anime Records: queries and updates
src/controllers/anime.controller.js - Anime Catalog → Genre Management: resolves genres
src/controllers/anime.controller.js - Anime Catalog → Jikan and AniList: imports catalog data
src/controllers/anime.controller.js - Genre Management → Genre Records: manages genres
src/controllers/genero.controller.js - Genre Management → Anime Records: checks genre use
src/controllers/genero.controller.js - Personal Tracking → Tracking Records: manages tracking
src/controllers/seguimiento.controller.js - Community Reviews → Review Records: manages reviews
src/controllers/resena.controller.js - Rankings and Stats → Tracking Records: aggregates tracking
src/controllers/stats.controller.js