Servidor d'EBooks

Aquest projecte te com a proposit proveir d'una plataforma per administrar i donar access a EBooks. Els desenvolupadors han sigut:

• P. Navlani
• M. Peral

L'usabilitat d'aquesta plataforma es divideix en dues seccions, una per l'administrador i una per l'usuari.

Administrador

L'administrador pot afegir llibres, esborrar-los i veure la llista de llibres disponibles des del panell d'administracio.

Usuari

L'usuari pot veure la llista de llibres disponibles i llegir-los. A més, cada vegada que l'usuari llegeixi un capitol, es guardará automaticament per a que pugui continuar llegint des d'on ho va deixar en un altre dispositiu. Per poder emmagatzemar l'estat de lectura, s'ha de introduir el nom d'usuari. Aquest nom d'usuari es guardará a la base de dades, i es fará servir per identificar l'usuari.

Configuracio

Instal·lacio de paquets

Per poder fer servir aquiest projecte, s'ha de fer servir NodeJS amb els paquets indicats en package.json. Per instal·lar els paquets, s'ha de fer servir la següent comanda:

npm install

Nota: Aquest projecte s'ha desenvolupat fent servir NodeJS 20.11. No es garanteix el funcionament correcte amb versions anteriors.

Configuracio d'autenticacio amb Google Drive

Primer de tot, s'ha de crear un compte de serveis en la plataforma de Google Cloud, i descarregar el fitxer credentials.json. Aquest fitxer s'ha de guardar a l'arrel del projecte. Aquest fitxer es necessari per poder accedir a Google Drive.

Com a exemple d'aquest fitxer, es pot veure el fitxer credentials.json.example.

Inicialitzacio del servidor

Per poder inicialitzar el servidor, s'ha de fer servir la següent comanda:

node src/server.js

Desplegament

A l'hora de realitzar el desplegament, hem optat per fer servir Docker. Per això, s'ha inclós un fitxer Dockerfile i un Docker Compose per facilitar el desplegament. Per poder desplegar el servidor, s'ha de fer servir les següents comandes:

docker build -t servidor-books .
docker compose up -d

Seccions

Admin

L'admin pot fer les seguents accions en el panell d'administracio

• Afegir llibres
• Visualitza llista de Llibres
• Esborra Llibres

Client

El client pot fer les seguents accions

• Visualitza llista de Llibres
• Visualitza un Llibre També, cada vegada que visiti un capitol, es guardará automaticament.

Tasques

• Admin
  • Llistar Llibres
  • Afegir Llibres
  • Esborrar Llibres
• Client
  • Llistar Llibres
  • Llegir Llibre
  • Afegir "autenticacio" per a que els usuaris puguin continuar llegint des d'on ho van deixar en un altre dispositiu