Skip to content

ISPC-TSDW/libroteka-documentacion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 

Repository files navigation

Proyecto Libroteka — Versión Web y Móvil

Bienvenido/a al proyecto Libroteka, desarrollado en el marco de la Tecnicatura Superior en Desarrollo Web y Aplicaciones Digitales, correspondiente a la asignatura Práctica Profesionalizante. Cohorte: 2022–2023

🧩 Introducción

Libroteka es una aplicación web y móvil creada con el propósito de fortalecer las habilidades técnicas de desarrollo fullstack bajo un enfoque colaborativo utilizando la metodología ágil Scrum. El sistema permite a los usuarios buscar, filtrar y encontrar libros según sus preferencias, facilitando una experiencia de navegación moderna, fluida y eficiente.

Este proyecto integra herramientas actuales del ecosistema tecnológico web y móvil, y plantea una arquitectura escalable, segura y orientada al usuario. La plataforma busca fomentar la lectura digital y el acceso igualitario a obras de todo tipo, desde cualquier lugar.

🎯 Objetivo de Libroteka

Libroteka tiene como propósito ofrecer a los usuarios una experiencia enriquecedora para encontrar libros según sus preferencias de autor, género o título. La aplicación mejora la experiencia de búsqueda y proporciona una plataforma que fomenta la lectura, facilitando la navegación a través de un catálogo de libros actualizado y variado. La idea principal de este proyecto ha sido desarrollar un sistema eficiente, seguro y escalable, con la experiencia del usuario como eje central.

📝 Proposito del Proyecto

1. Facilitar el acceso a la lectura: Permitir que los usuarios accedan a una amplia variedad de títulos y géneros desde cualquier lugar, eliminando la necesidad de desplazarse esencialmente a una librería.

2. Ampliar la selección: Aprovechar el espacio virtual ilimitado para ofrecer una gama más amplia de libros, incluyendo títulos menos conocidos o difíciles de encontrar en tiendas locales, ampliando así las opciones de lectura.

3. Comodidad: Ofrecer la ventaja de acceder al catálogo en línea en cualquier momento y desde cualquier lugar, especialmente beneficio para aquellos con horarios ocupados o acceso limitado a tiendas físicas.

4. Facilitar la búsqueda y descubrimiento: Proporcionar herramientas de búsqueda para ayudar a los usuarios a descubrir nuevos libros basados en sus intereses y preferencias anteriores.

5. Promoción de la lectura: Fomentar la cultura de la lectura y crear una comunidad de lectores a través de un entorno en línea donde se discuten y recomiendan libros.

6. Servicio al cliente: Brindar soporte al cliente, resolver dudas sobre la plataforma y proporcionar información sobre los productos para mejorar la experiencia del usuario.

7. Internacionalización: Llegar a audiencias globales, proporcionando acceso a títulos que de otra manera serían inaccesibles para muchas personas.

✨ Características Principales

🔍 Navegación Intuitiva: Tanto en la web como en la app móvil, la navegación está organizada mediante componentes reutilizables y rutas bien definidas. La app móvil incluye Activities conectadas entre sí mediante herencia, facilitando el retorno a pantallas anteriores.

🛠️ Gestión CRUD: Los usuarios pueden gestionar datos personales, libros favoritos, reseñas, etc., con operaciones CRUD sincronizadas entre frontend y backend a través de API REST.

📸 Actividad Multimedia: La versión móvil incorpora vistas enriquecidas con imágenes que mejoran la experiencia de usuario.

🔐 Seguridad y Autenticación: La autenticación está basada en JWT (JSON Web Tokens), lo cual asegura el acceso controlado a recursos protegidos, tanto para usuarios estándar como administradores.

🌐 Redirección y Compras Online: Desde la app móvil, los usuarios pueden ser redirigidos a la web para realizar la compra del libro, aprovechando la integración con Mercado Pago en entorno sandbox.

☁️ Nota sobre Servicios en la Nube

⚠️ Debido al uso de servicios gratuitos como Koyeb y Railway, las instancias pueden entrar en suspensión por inactividad. Si al iniciar sesión o registrarte ocurre un error, simplemente intentá nuevamente luego de unos segundos.

DESARROLLADORES:

Fullstack Developer

QA, Fullstack Developer

Fullstack Developer

DevOps Engineer, Fullstack Developer

Fullstack Developer

Fullstack Developer

Tecnologias


⚙️ Tecnologías Utilizadas

Frontend Web:

  • Angular 17

  • Bootstrap

  • RxJS

  • Font Awesome

  • Nodemailer, SMTPjs

Frontend Móvil:

  • Java

  • Android Studio

Backend:

  • Django 4.2

  • Django REST Framework

  • MySQL

  • django-cors-headers

  • Pillow

  • jsonfield

📌 Organización del Proyecto


🗝️ Credenciales Django Admin

  • user: ####### (comunicarse con el admin)
  • password: ####### (comunicarse con el admin)

🧪 Instrucciones para Desarrolladores

🖥 Versión Web

Frontend

  git clone https://github.com/ISPC-TSDW/libroteka-frontend.git
  cd Frontend
  npm install
  npm start

Backend

  git clone https://github.com/ISPC-TSDW/libroteka-backend.git
  cd Backend/Libroteka
  # Windows
  .\backendLibroteka-env\Scripts\activate
  # Linux/macOS
  source backendLibroteka-env/bin/activate

  pip install -r requirements.txt
  python manage.py runservere 

Docker

  cd Frontend
  npm install
  cd ..
  docker compose up --build

📱 Versión Móvil

  git clone https://github.com/ISPC-TSDW/libroteka-mobile.git
  cd Backend/Libroteka
  # Activar entorno virtual
  # Windows:
  python -m venv .backendLibroteka-env
  .backendLibroteka-env\Scripts\activate
  # Linux:
  source backendLibroteka-env/bin/activate

  pip install -r requirements.txt
  python manage.py runserver

About

En este repositorio se encontrara la documetación de libroteka web y app.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors