/TicketUM

Repositorio usado para el desarrollo de la API de gestion de eventos TicketUM. Realizado para la materia Aseguramiento de la Calidad del Software de la UM - FI - SR.

Primary LanguagePython

Ticket UM

Covers Subjects

API diseñada como parte de la materia Aseguramiento de la Calidad del Software (ACS) de la Universidad de Mendoza.

About

Aplicación creada para el registro y gestión de invitados de diferentes eventos. Esta es una solución de software que tiene como objetivo permitir la gestión de eventos, facilitando la creación, inscripción y administración de estos. Este sistema está diseñado para ser accesible tanto desde una aplicación web como desde una aplicación móvil (que se desarrollará en el futuro por un equipo externo).

Propósito

El propósito de este documento es delinear los requisitos para la solución de inscripción a eventos que se desarrollará para una empresa/cliente en concreto. Este documento será utilizado por todos los stakeholders, incluidos desarrolladores y testers.

Contrato de la API

El desarrollo de la API se realizó de acuerdo con los requerimientos y especificaciones acordadas con el cliente, las cuales se documentaron utilizando Swagger. Este contrato define los endpoints disponibles, los métodos HTTP que se pueden usar, los parámetros requeridos y opcionales, así como las respuestas esperadas.

Usted podrá encontrar nuestro contrato en el apartado de documentación, ubicado en la carpeta docs.

La documentación incluye:

  • Endpoints: Lista de todos los endpoints disponibles en la API.
  • Métodos HTTP: GET, POST, PUT, DELETE, etc.
  • Parámetros: Detalles sobre los parámetros requeridos y opcionales para cada endpoint.
  • Respuestas: Descripción de las respuestas esperadas, incluidos los códigos de estado HTTP y los formatos de respuesta.

Instalación y Ejecución

Sigue estos pasos para instalar y ejecutar la aplicación TicketUM en tu entorno local:

Prerrequisitos

  • Python 3.8 o superior
  • pip (gestor de paquetes de Python)
  • virtualenv (opcional pero recomendado)

Instrucciones de ejecución

Paso 1: Clonar el repositorio

Clona este repositorio en tu máquina local usando Git:

git clone https://github.com/Lucas16AR/TicketUM.git
cd Ticketum

Paso 2: Crear un entorno virtual y activarlo

cd ticketum
python3 -m venv .
source bin/activate # En Windows usar `Scripts\activate`

Paso 3: Instalar Dependencias

pip install -r requirements.txt

Paso 4: Configurar variables de entorno

Actualice la configuración de variables en un archivo .env para que coincida con la configuración de su base de datos y Flask Mail.

# Database configuration
DB_NAME = "db_name_example"
DB_USER = "db_user_example"
DB_PASSWORD = "db_password_example"
DB_HOST = "db_host_example"
DB_PORT = "db_port_example"
DB_ENGINE = "db_engine_example:////" # sqlite for default
DB_PATH = "db/path/to/your/folder"
SV_PORT = 5000

# Mail configuration
# IMPORTANT: You need to enable less secure apps in your gmail account
MAIL_SERVER = "smtp.gmail.com"
MAIL_PORT = 587
MAIL_USE_TLS = True
MAIL_USERNAME = "your-mail-here@example.com"
MAIL_PASSWORD = "your-password-here"

Paso 5: Aplicar Migraciones

flask db init
flask db migrate -m "Initial Migration"
flask db upgrade

Paso 6: Ejecutar el servidor de desarrollo de la API

python3 app.py

Creditos

um-cover