Skip to content

Latest commit

 

History

History
104 lines (65 loc) · 3.44 KB

README.md

File metadata and controls

104 lines (65 loc) · 3.44 KB

SendaAlquiler - Backend

Tabla de Contenidos

Introducción

SendaAlquiler es una aplicación web desarrollada con el framework Django, basado en el lenguaje de programación Python. Para la gestión y consulta de datos, se ha implementado GraphQL en lugar del convencional REST.

Acerca de GraphQL

GraphQL es un lenguaje de consulta para APIs, que se ejecuta en el servidor. A diferencia de REST, GraphQL permite interactuar con un único endpoint, permitiendo al cliente especificar los datos que desea recibir. Esto resulta en consultas más eficientes y flexibles.

Para la implementación de GraphQL en el contexto de Django, se ha optado por el uso de Graphene-Django, que facilita la creación de esquemas GraphQL utilizando modelos de Django.

Requisitos Previos

  • Python: Lenguaje de programación en el que se basa Django. Importante usar una versión menor a 3.12 para compatibilidad con Django 4.1.1 Descargar Python Al instalar Python, se instalará automáticamente pip, el gestor de paquetes de Python.

  • virtualenv: Herramienta para crear entornos virtuales en Python. Para instalarlo:

    pip install virtualenv

  • wkhtmltopdf: Herramienta para generar archivos PDF a partir de HTML. Descargar wkhtmltopdf

Instrucciones de Instalación

1. Configuración del Entorno Virtual

Windows:

python -m venv venv
.\venv\Scripts\activate

El prefijo (venv) en la terminal indica que el entorno virtual ha sido activado.

2. Instalación de Dependencias

Con el entorno virtual activo:

pip install -r requirements.txt

3. Configura las variables entorno

Para el funcionamiento de la aplicación debes crear un archivo llamado ".env" en este mismo directorio. Puedes basarte en el archivo de ejemplo .env.example.

4. Aplicación de Migraciones

Django utiliza un sistema de migraciones para gestionar cambios en la base de datos. Antes de correr el proyecto, necesitas aplicar estas migraciones:

python manage.py migrate

5. Inicio del Servidor

python manage.py runserver

El servidor se iniciará en http://127.0.0.1:8000/.

Uso de la Aplicación

Con el servidor en ejecución, se puede acceder a la interfaz de GraphQL a través de http://127.0.0.1:8000/graphql.

Recursos Educativos

A continuación, se presentan varios recursos que pueden ser de utilidad para comprender mejor las tecnologías implementadas:

Django

  1. Documentación Oficial de Django Consultar Documentación

GraphQL

  1. Comparativa entre GraphQL y REST Leer Artículo

  2. Herramienta Interactiva de GraphQL Acceder a la Herramienta

Graphene-Django

  1. Documentación Oficial de Graphene-Django Consultar Documentación