Skip to main content

Software Reviewer Guidelines

Grupo de prácticas: 8
Alberto Benitez Morales
Álvaro Carrera Bernal
Álvaro Navarro Rivera
Álvaro Jose Sanchez Flores
Artemio Rodriguez Asensio
Eduardo de Bustamante Lucena
Fernando Barroso Barroso
Francisco Jose Vargas Castro
Gonzalo Santigo Martín
Guillermo Alonso Pacheco Rodrigues
Jaime Caballero Hernandez
Javier Nunes Ruiz
Javier Rodríguez Cordero
Juan Martínez Cano
Marco Antonio Roca Rodríguez
Mario Sanchez Naranjo
Pablo Martínez Valladares

Documento de Revisión de Software

1.Introducción

En este documento se proporciona una visión general concisa de las funcionalidades del software, incluyendo su propósito, características principales y cómo funcionan.

En este documento explicaremos las distintas funcionalidades implementadas hasta el momento en el software que estamos desarrollando, haciendo hincapié en cómo utilizar cada una de estas funcionalidades así como el propósito de estas y su rol en la aplicación.

También se hablará de cómo se ha revisado el software, cómo se ha probado cada funcionalidad, las pruebas de usabilidad y el análisis del código.

2. Funcionalidades

2.1. Funcionalidades Core

Login

Url: /login

Página inicial para acceso a la página si ya se dispone de un usuario.

Reseteo de contraseña

Url: /reset_password/

Página para que en caso de que un usuario no se acuerde de su contraseña tenga la posibilidad de recuperarla

Elección de registro

Url: /register_choice

Página para elegir el tipo de usuario con el que se quiere acceder a la aplicación.

Pasarela de pago

Página común para el procesamiento de pagos.

About-us

Url: /about-us

En esta página se muestran un poco de información relacionada con quienes somos, qué es banquetBuddy, cuales son nuestros servicios…

Información de contacto

Url: /contact

En esta página facilitamos nuestra información de contacto.

Preguntas frecuentes

Url: /faq

En esta página se muestran algunas preguntas frecuentes y respondemos a estas.

Política de privacidad

Url: /privacy-policy/

En esta página mostramos nuestra política de privacidad y todas las cláusulas relacionadas con esta en detalle

Términos y condiciones

Url: /terms-and-conditions

Reporte de errores

Url: /error-report

2.2 Funcionalidad de Catering

Registro Catering

Url: /register_company

Vista de registro de caterings, donde se puede registrar un catering seleccionando opciones como el tipo de plan que quieren contratar, la dirección de la compañía y el CIF (código de identificación fiscal)

Reporte de errores

Listado de menús

Url: /list_menus/

Se muestra un listado con los menús que un catering tiene disponibles actualmente donde se pueden crear, editar y eliminar menús.

Añadir menú

Url: /add_menu

Formulario para añadir un nuevo menú al listado de menús del catering.

Editar Menú

Url: /edit_menu/<id>

Formulario desde donde se puede modificar la información actual de un menú.

Borrar Menu

URL: delete_menu/<id>

Botón para eliminar un menú de los actualmente disponibles.

Perfil de catering

Url: /profile

Página donde se muestran los datos de un perfil del tipo catering.

Editar perfil de cátering

Url: /catering_profile_edit

Página donde se muestran los datos a editar de un perfil del tipo catering.

Planes de subscripción

Url: /subscription-plans

Página donde muestran los planes de suscripción disponibles con las características de cada uno y un botón con la opción de cancelar la suscripción y, si la persona no está suscrita se muestran botones en todos los planes que redirige a la pasarela de pago para cada plan.

Lista de servicios

Url: /services

Lisrçtado de los servicios catering que proporciona una compañía de catering donde se muestran los datos de los servicios, con 3 botones para ver los empleados del catering, editar caterings y eliminar caterings.

Crear servicio

Url: /create_service/

Permite crear un nuevo servicio catering rellenando los distintos campos de un formulario.

Editar servicio

Url: /update_service/<id>/

Permite editar un servicio proporcionado por la compañía actualmente.

Eliminar Servicio

Url: /delete_service/<id>/

Permite eliminar un servicio del listado de servicios proporcionados actualmente.

Lista de empleados para un servicio de catering

Url: /service/<id>/employees

Listado con los empleados que se encuentran trabajando en ese servicio actualmente.

Carta de recomendación a empleados

Url: service/<service_id>/employees/<employee_id>/recommendation_letter

Permite escribir una carta de recomendación a un trabajador y tras enviar la carta se muestra que se ha enviado correctamente.

Listado de platos

Url: /plates

Listado de platos de un catering, donde se muestra el nombre del plato, el menú al que pertenece, una descripción, y el precio. Además ofrece las opciones de edición y eliminación de platos de un menú

Crear nuevo plato

Url: plates/add/

Permite a una compañía añadir un nuevo plato, asociándole un menú, precio, nombre y descripción.

Editar plato

Url: plates/<id>/edit/

Permite editar un plato ya publicado por un catering.

Eliminar plato

Url: plates/<id>/delete/

Permite eliminar un plato creado por una compañía catering.

Lista de ofertas publicadas

Url: /offer_list

Listado con las ofertas publicadas por el servicio catering con las opciones de crear una nueva oferta, editar una oferta, eliminar una oferta o ver las solicitudes de aplicaciones de los trabajadores

Crear oferta

Url: /create_offer

Permite crear una nueva oferta de empleo rellenando el formulario

Editar oferta

Url: /edit_offer/<id>Permite a una compañía catering editar una oferta ya publicada.

Borrar oferta

Url: /delete_offer/<id>

Lista de empleados que han aplicado una oferta

Url: /applicants/<offer_id>

Permite ver los empleados que han aplicado a una oferta en concreto.

Reservas

Url: /view-reservations/<id>

Permite ver las reservas que una compañía de catering tiene.

Calendario: elección de servicio

Url: catering-calendar/

Permite seleccionar el servicio catering del cual se quiere visualizar el mes.

Calendario

Url: /catering-calendar/<id>/<año>/<mes>

Permite ver en un calendario las fechas en las que el servicio catering está reservado.

2.3 Funcionalidad de Particular

Registro de Particular

Url: /caterings/register_particular

Listado de Catering

url: /particular/

Listado de caterings donde un cliente puede visualizar los distintos tipos de caterings disponibles.

Filtrado de catering

url: /particular/

Permite filtrar los caterings por los parámetros que aparecen al clickar en el desplegable

Buscar catering

url: /particular/

Permite buscar un catering con palabras claves, introducidas en el buscador de estas

Detalles de catering

url: /particular/<id>/

Tras hacer click en un catering de la lista de caterings se muestran los detalles del catering. También se muestran 2 botones, 1 para añadir un comentario y una valoración del catering y otro para hacer una reserva. Abajo de estos botones se muestran las valoraciones que los usuarios han dejado sobre este catering.

Añadir review

url: /particular/<id>/review

El usuario puede añadir una valoración con un comentario sobre el catering seleccionado.

Reservar Catering

url: /particular/<id>/book

Permite reservar el catering, seleccionando una fecha para el evento, el número de personas y los distintos menús que ofrece el servicio catering.

Mis reservas

url: /caterings/my_books

Muestra las reservas de caterings que ha realizado una persona, dando la posibilidad de editar y cancelar la reserva.

Editar Reserva

url: /particular/my_books/<id>/edit

Permite editar la fecha, el número de personas y el tipo de menú de la reserva.

Cancelar Reserva

url: /particular/my_books/<id>/cancel

Permite cancelar una reserva.

2.4 Funcionalidad de Empleado

Registro empleado

Url: /register_employee

Permite que un empleado se registre, introduciendo los datos correspondientes.

Lista de ofertas

Url: /employeeOfferList

Muestra un listado de ofertas a las cuales los empleados pueden aplicar pulsando el botón de apply.

Aplicar a oferta

Url: /employeeApplication/<int:offer_id>

Muestra que la aplicación a una oferta de trabajo se ha enviado correctamente.

Listado de aplicaciones a ofertas enviadas

Url: /JobApplicationList

Muestra una lista con todas las aplicaciones a ofertas que ha enviado el empleado.

Perfil empleado

Url: /profile

Muestra el perfil con los datos del empleado, con las opciones de editar el perfil y ver las cartas de recomendación recibidas.

Editar perfil empleado

Url: /profilex-edit

Cartas de recomendación

Url: /<employee_id>/recommendation_letters

Muestra las cartas de recomendación que ha recibido un empleado

3. Datos necesarios para realizar la revisión

Se han mandado las credenciales y urls por mensaje de enseñanza virtual

4 Evaluación de Usabilidad

Bajo nuestro punto de vista la aplicación se puede usar de forma fácil e intuitiva. Aun así, hay aspectos que no no están todo lo bien que nos gustaría, pero somos conscientes y tenemos previsto mejorar todo lo posible la web en el tercer sprint.

Otro punto a tener en cuenta es el feedback recibido por parte de los usuarios pilotos, que no está llegando en estos momentos. Estos datos los usaremos para tener puntos de vista objetivos por parte de personas ajenas al desarrollo de la aplicación y añadir mejoras propuestas en este tercer sprint.

5 Conclusiones

En conclusión la mayoría de requisitos se han cumplido y las funcionalidades implementadas funcionan correctamente. Podemos remarcar las diferencias de estilos en diversas páginas como un punto a mejorar en el último sprint, así como algunos pequeños errores y bad smells que se han encontrado durante la revisión del código, como urls repetidas y algunos vínculos que no aparecen en la barra de navegación cuando se cambia de vista, por lo demás todo lo que se ha probado ha funcionado correctamente en la revisión.