Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/camiloivcode/biblioteca-la-palabra/llms.txt

Use this file to discover all available pages before exploring further.

Bienvenido a la documentación oficial de Biblioteca Popular La Palabra, un sistema de gestión bibliotecaria completo pensado para bibliotecas comunitarias e institucionales. La plataforma cubre todo el ciclo de vida del préstamo: desde el registro de socios y el catálogo de materiales hasta el control de mora y los reportes de actividad.

Inicio Rápido

Levanta el sistema completo con Docker Compose en minutos y accede con las credenciales del seed.

Arquitectura

Conoce el stack técnico, la estructura MVC y el flujo de cada request de extremo a extremo.

API Reference

Explora todos los endpoints REST: autenticación, socios, materiales, préstamos y más.

Despliegue

Configura variables de entorno, contenedores y base de datos para producción.

¿Qué incluye el sistema?

Biblioteca La Palabra es una aplicación full-stack compuesta por un backend Node.js/Express con Prisma ORM sobre MySQL 8, y un frontend Astro estático con Bootstrap 5. Todos los servicios se orquestan mediante Docker Compose.

Socios

CRUD completo con estados ACTIVO, SUSPENDIDO y MOROSO.

Materiales

Catálogo de libros, revistas, DVD y más con control de stock.

Préstamos

Reglas de negocio automáticas: límite de 3, mora a 30 días.

Autores & Categorías

Clasificación del catálogo con iconos por categoría.

Reportes

Morosos, materiales populares e historial de préstamos.

Usuarios

Gestión de cuentas con roles ADMIN y BIBLIOTECARIO.

Inicio rápido en 3 pasos

1

Clona el repositorio y copia las variables de entorno

git clone https://github.com/camiloivcode/biblioteca-la-palabra.git
cd biblioteca-la-palabra
cp .env.example .env
2

Levanta todos los servicios con Docker Compose

docker-compose up --build -d
Esto iniciará MySQL, el backend (:4000), el frontend (:3000) y phpMyAdmin (:8080). El backend ejecutará automáticamente prisma db push y el seed inicial.
3

Accede al panel con las credenciales del seed

Abre http://localhost:3000 e inicia sesión con:
RolEmailContraseña
ADMINadmin@biblioteca.comAdmin2024!
BIBLIOTECARIObibliotecario@biblioteca.comBiblio2024!
Consulta la guía de Configuración para ajustar credenciales, SMTP y variables de producción antes de exponer el sistema públicamente.

Build docs developers (and LLMs) love