Biblioteca - API REST

Tabla de contenidos

Descripción

Escenario

Permisos

Tutoriales

Iniciar los containers docker

Descripción

Este es un sistema de administración de una biblioteca, basado en los roles socio y bibliotecario, cada uno con sus permisos dentro del sistema mismo.

Escenario

La biblioteca posee una base de datos de cuentas y otra de libros, las cuales pueden ser modificadas según los permisos que posea el usuario logueado.

Los socios pueden pedir prestados cuantos libros quieran por determinado tiempo, vencido el cual ya no pueden llevarse más hasta devolver los que se hayan pasado de fecha. Un libor puede devolverse en cualquier momento. Pueden visualizar la lista de libros y la de sus préstamos.

Los bibliotecarios pueden modificar la información de cualquier libro, crearlos y eliminarlos cuando no estén prestados. También puede modificar el inventario de cada uno. Pueden crear cuentas y eliminarlas cuando no posean préstamos activos. Pueden visualizar la lista de libros, la de todos los préstamos y las cuentas creadas, tanto de socios como de bibliotecarios.

Permisos

Permiso	Bibliotecario	Socio
Ver libros	✔️	✔️
Ver préstamos	✔️ (todos)	✔️ (sólo propios)
Pedir/devolver libros	❌	✔️
Crear libros	✔️	❌
Modificar libros	✔️	❌
Eliminar libros	✔️	❌
Ver cuentas	✔️	❌
Crear cuentas	✔️	❌
Eliminar cuentas	✔️	❌

Tutoriales

Para seguir los pasos de los tutoriales deberá loguearse en la página, las credenciales para testing se encuentran en el archivo credentials.txt.

Iniciar los containers docker

Correr los siguientes comandos en la carpeta raíz del proyecto:

docker-compose build
docker-compose up

Socio: pedir prestado un libro

Diríjase al listado de todos los libros, para pedir uno debe hacer click en el botón PEDIR. El libro pedido debería aparecer en el listado de préstamos, a la derecha. Atención: si el socio tiene préstamos vencidos, no podrá pedir más hasta haber devuelto los mismos. Atención: si algún libro está sin stock, su botón para pedirlo va a estar deshabilitado.

Socio: devolver un libro prestado

Diríjase al listado de préstamos y haga click en el botón DEVOLVER. El libro devuelto va a desaparecer del listado de préstamos.

Bibiotecario: crear un libro

Diríjase al listado de libros y haga click sobre el ícono indicado en la imágen. Llene los campos solicitados y haga click en el botón AGREGAR. El nuevo libro aparecerá en el listado.

Bibliotecario: eliminar un libro

En el listado de libros, haga click sobre el que desee eliminar. Se abrirá la información del libro, hacer click en el botón de edición. Sin modificar sus datos, haga click en el botón apropiado para borrarlo. El libro desaparecerá del listado. Atención: si el libro posee préstamos activos no va a poder eliminarse.

Bibliotecario: modificar un libro

En el listado de libros, haga click sobre el que desee modificar. Se abrirá la información del libro, hacer click en el botón de edición. Modifique la información del libro y haga click en el botón GUARDAR. La infomación del libro se verá modificada.

Bibliotecario: modificar el inventario de un libro

En el listado de libros, haga click sobre el que desee modificar. Se abrirá la información del libro, use los botones indicados para modificar el inventario del libro. Atención: Al eliminar la última copia de un libro, se eliminará totalmente de la base de datos. Al intentar eliminar la última copia de un libro con préstamos, un cartel advertirá la imposibilidad de realizar la acción.

Bibliotecario: crear una cuenta de usuario

En el listado de cuentas, haga click en el ícono indicado en la imágen. Llene los datos de la cuenta y haga click en AGREGAR. La cuenta nueva aparecerá en el listado.

Bibliotecario: eliminar una cuenta de usuario

En el listado de cuentas, haga click en el ícono correspondiente de la cuenta que desee eliminar. La cuenta será eliminada del listado. Atención: si la cuenta es de socio y además tiene préstamos activos, no va a poder eliminarla. Atención: no se puede eliminar la cuenta actual, por lo que el ícono no estará presente.