# sabaych/gestion_biblioteca architecture

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

- Interactive diagram: https://gitdiagram.com/sabaych/gestion_biblioteca
- Repository: https://github.com/sabaych/gestion_biblioteca

## Overview

##### Project Type & Purpose
- Este es un sistema web full-stack de gestión de biblioteca.
- Frontend y backend conviven en un único repositorio Next.js 14 (App Router).
- Ofrece: autenticación/roles, inventario de libros, gestión de préstamos, administración de usuarios, dashboard con estadísticas y logs de auditoría.

##### Análisis de la Estructura de Archivos
- Top-level “app/”: rutas y páginas Next.js (App Router).
- app/api/: endpoints REST internos (auth, libros, préstamos, usuarios).
- app/dashboard/, app/login/, app/page.tsx: páginas públicas y protegidas.
- components/: UI React reutilizable (cards, formularios, sidebar, toasts).
- lib/: lógica de negocio y utilidades (acciones con Prisma, autenticación NextAuth, wrapper de toast).
- prisma/: esquema de BD (schema.prisma), migraciones, seed data, y archivo dev.db (SQLite).
- types/: definiciones TypeScript globales (Next-Auth, modelos).
- Configs: next.config.js, tailwind.config.js, tsconfig.json, ESLint, PostCSS.

##### Insights del README
- Stack: Next.js 14, React 18, TypeScript, TailwindCSS, NextAuth.js, Prisma ORM, SQLite.
- Flujo de desarrollo: “npm run dev” levanta servidor que sirve SSR/SSG y API Routes.
- Modelo de datos: User (con roles), Libro, Préstamo, LogAudit.
- Seguridad: bcrypt, sesiones, validación Zod en frontend y backend, control de acceso por rol.

##### Cómo Diagramar la Arquitectura
a. Componentes Principales
1. Cliente Web (navegador)
2. Next.js Server (SSR/SSG + API Routes)
- Rutas de página (login, dashboard, inventario, préstamos, usuarios)
- Endpoints REST internos (app/api/auth, /libros, /prestamos, /usuarios)
3. Servicios Transversales
- NextAuth.js (autenticación, sesión, callbacks)
- Zod (validación de payloads)
4. Prisma Client
5. Base de Datos SQLite (prisma/dev.db)
6. Componentes React compartidos (Sidebar, Cards, Formularios)
7. Herramientas de build/deploy (Vercel, Docker, no explicitado)

b. Relaciones e Interacciones
- Flechas del Cliente → Next.js Server (HTTPS GET/POST).
- Dentro del Server:
- Page Requests → Server-Side Rendering / Static Props
- API Calls → NextAuth (login/logout) y CRUD via Prisma Client.
- Prisma Client → SQLite DB (queries/inserts/updates).
- Log de acciones → Prisma escribe en tabla de auditoría.
- Zod valida request bodies antes de llegar a Prisma.

c. Patrones & Principios
- Monolito modular: frontend + backend en un solo proyecto.
- Capa “lib/actions”: services pattern para separar lógica de negocio de rutas.
- App Router (Next.js 14): colocation de UI y datos.
- ORM (Prisma): repository pattern para acceso a datos.
- Control de acceso basado en roles integrado en API Routes.

d. Tecnologías Clave
- Frontend: Next.js 14, React 18, TailwindCSS
- Backend: Next.js API Routes, NextAuth.js, Zod para validación
- Persistencia: SQLite + Prisma ORM
- Build/Config: TypeScript, PostCSS, ESLint, Git

##### Elementos Obligatorios en el Diagrama
- Labels claros por componente (e.g., “InventoryPage”, “api/auth/route.ts”).
- Flechas direccionales (datos, control, respuestas).
- Azul para UI/Frontend
- Verde para Backend/API
- Naranja para servicios transversales (Auth/Validation)
- Gris para persistencia (DB/ORM)
- Leyenda explicativa de colores y símbolos.

##### Recomendaciones Finales
- Sé detallado pero modular: cada módulo de app/, lib/, prisma/ es un nodo.
- Muestra flujos críticos: login → token/session → acceso páginas protegidas.
- Indica puntos de validación (Zod) y control de acceso (roles).
- Refleja la topología actual (monolito desplegado en un solo host/server).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Client["Client Web (Browser)"]:::frontend

    %% Server Layer
    subgraph "Next.js Server" 
        direction TB
        PagesSub["Page Routes"]:::backend
        APISub["API Routes"]:::backend

        %% Page Routes
        PagesSub --> HomePage["HomePage"]:::frontend
        PagesSub --> LoginPage["LoginPage"]:::frontend
        PagesSub --> DashboardLanding["Dashboard Landing"]:::frontend
        PagesSub --> DashboardLayout["Dashboard Layout"]:::frontend
        PagesSub --> InventoryList["Inventory List"]:::frontend
        PagesSub --> ViewEditBook["View/Edit Book"]:::frontend
        PagesSub --> NewBookForm["New Book Form"]:::frontend
        PagesSub --> ImportInventory["Import Inventory"]:::frontend
        PagesSub --> LoansList["Loans List"]:::frontend
        PagesSub --> NewLoanForm["New Loan Form"]:::frontend
        PagesSub --> UsersList["Users List"]:::frontend
        PagesSub --> NewUserForm["New User Form"]:::frontend
        PagesSub --> EditUser["Edit User"]:::frontend

        %% API Routes
        APISub --> AuthRoute["auth/[...nextauth]/route.ts"]:::backend
    end

    %% Cross-cutting Services
    subgraph "Services & Validation" 
        direction TB
        NextAuth["NextAuth Helper"]:::service
        Zod["Zod Validation"]:::service
        ToastWrapper["Toast Wrapper"]:::service
    end

    %% Business Logic
    subgraph "Business Logic (lib/actions)"
        direction TB
        BookActions["Book Actions"]:::service
        LoanActions["Loan Actions"]:::service
        UserActions["User Actions"]:::service
    end

    %% Data Layer
    subgraph "Data Layer & Persistence"
        direction TB
        PrismaClient["Prisma Client Instance"]:::persistence
        SQLiteDB["SQLite DB (dev.db)"]:::persistence
        Schema["schema.prisma"]:::persistence
    end

    %% Flows
    Client -->|HTTP GET/POST| PagesSub
    Client -->|AJAX Calls| APISub
    AuthRoute -->|uses| NextAuth
    AuthRoute -->|validates| Zod
    APISub -->|calls| BookActions
    APISub -->|calls| LoanActions
    APISub -->|calls| UserActions
    BookActions -->|validates| Zod
    LoanActions -->|validates| Zod
    UserActions -->|validates| Zod
    BookActions -->|queries| PrismaClient
    LoanActions -->|queries| PrismaClient
    UserActions -->|queries| PrismaClient
    PrismaClient -->|reads/writes| SQLiteDB
    AuthRoute -->|logs| PrismaClient

    %% Click Events for Pages
    click HomePage "https://github.com/sabaych/gestion_biblioteca/blob/main/app/page.tsx"
    click LoginPage "https://github.com/sabaych/gestion_biblioteca/blob/main/app/login/page.tsx"
    click DashboardLanding "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/page.tsx"
    click DashboardLayout "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/layout.tsx"
    click InventoryList "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/inventario/page.tsx"
    click ViewEditBook "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/inventario/[id]/editar/page.tsx"
    click NewBookForm "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/inventario/nuevo/page.tsx"
    click ImportInventory "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/inventario/importar/page.tsx"
    click LoansList "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/prestamos/page.tsx"
    click NewLoanForm "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/prestamos/nuevo/page.tsx"
    click UsersList "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/usuarios/page.tsx"
    click NewUserForm "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/usuarios/nuevo/page.tsx"
    click EditUser "https://github.com/sabaych/gestion_biblioteca/blob/main/app/dashboard/usuarios/[id]/editar/page.tsx"

    %% Click Events for API
    click AuthRoute "https://github.com/sabaych/gestion_biblioteca/blob/main/app/api/auth/[...nextauth]/route.ts"

    %% Click Events for Components & Services
    click BookActions "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/actions/libros.ts"
    click LoanActions "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/actions/prestamos.ts"
    click UserActions "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/actions/usuarios.ts"
    click NextAuth "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/auth.ts"
    click ToastWrapper "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/toast.tsx"
    click PrismaClient "https://github.com/sabaych/gestion_biblioteca/blob/main/lib/prisma.ts"
    click Schema "https://github.com/sabaych/gestion_biblioteca/blob/main/prisma/schema.prisma"
    click SQLiteDB "https://github.com/sabaych/gestion_biblioteca/blob/main/prisma/prisma/dev.db"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#E2F0D9,stroke:#26A65B,color:#26A65B
    classDef service fill:#FFE1B3,stroke:#D35400,color:#D35400
    classDef persistence fill:#E0E0E0,stroke:#7F8C8D,color:#7F8C8D
```
