Trabajo Tarjeta: Versión 2018

El siguiente trabajo es un enunciado iterativo. Todas las semanas nuevos requerimientos serán agregados y/o modificados para ilustrar la dinámica de desarrollo de software.

Iteracion 1. (31 de Julio al 14 de Agosto)

Escribir un programa con programación orientada a objetos que permita ilustrar el funcionamiento del transporte urbano de pasajeros de la ciudad de rosario.

Las clases que interactuan en la simulación son: Colectivo, Tarjeta y Boleto.

Cuando un usuario viaja en colectivo con una tarjeta, obtiene un boleto como resultado de la operación $coletivo->pagarCon($tarjeta);

Para esta iteracion se consideran los siguientes supuestos:

• No hay medio boleto de ningun tipo.
• No hay transbordos.
• No hay viajes plus.
• La tarifa básica de un pasaje es de: $ 14,80
• Las cargas aceptadas de tarjetas son: (10, 20, 30, 50, 100, 510,15 y 962,59)
• Cuando se cargan $510,15 se acreditan de forma adicional: 81,93
• Cuando se cargan $962,59 se acreditan de forma adicional: 221,58

Se pide:

• Hacer un fork del repositorio.
• Implementar el código de las clases Tarjeta, Colectivo y Boleto.
• Hacer que el test Boleto.php funcione correctamente con todos los montos de pago listados.
• Conectar el repositorio con travis-ci para que los tests se ejecuten automaticamente en cada commit.
• Enviar el enlace del repositorio al mail del profesor con los integrantes del grupo: dos por grupo.

Para instalar el codigo inicial clonar el repositorio y luego ejecutar:

composer install

En caso de no contar con composer instalado, descargarlo desde: https://getcomposer.org/

Para correr los tests:

./vendor/bin/phpunit

Si se agregan nuevas clases al código tal vez sea necesario correr:

composer dump-autoload

Iteracion 2. (14 de Agosto al 28 de Agosto)

Para esta iteración hay 3 tareas principales. Crear un issue en github copiando la descripción de cada tarea y completar cada uno en una rama diferente. Éstas serán mergeadas al validar, luego de una revisión cruzada (de ambos integrantes del grupo), que todo el código tiene sentido y está correctamente implementado.

No es necesario que todo el código para un issue esté funcionando al 100% antes de mergiarlo, pueden crear pull requests que solucionen algún item particular del problema para avanzar más rápido.

Además de las tareas planteadas, cada grupo tiene tareas pendientes de la iteración anterior que debe finalizar antes de comenzar con la iteración 2. Cuando la iteración 1 este completada, crear un tag llamado iteracion1: Y subirlo a github

IMPORTANTE: Como punto de control, alguna de estas dos funcionalidades: "Viaje plus" o "Franquicia de Boleto" tiene que estar lista para revisar a mitad de la iteración. (21 de Agosto).

Descuento de saldos.

• Cada vez que una tarjeta paga un boleto, descuenta el valor del monto gastado.
• Si la tarjeta se queda sin saldo, la operación $colectivo->pagarCon($tarjeta) devuelve FALSE,
• Escribir un test que valide dos casos, pagar con saldo y pagar sin saldo.

Viaje plus

• Si la tarjeta se queda sin crédito, puede otorgar hasta dos viajes plus.
• Cuando se vuelve a cargar la tarjeta, se descuenta el saldo de lo que se haya consumido en concepto de viaje plus.
• Escribir un test que valide que se pueden dar hasta dos viajes plus.
• Escribir un test que valide que el saldo de la tarjeta descuenta correctamente el/los viaje/s plus otorgado/s.

Franquicia de Boleto.

• Existen dos tipos de franquicia en lo que refiere a tarjetas, las franquicias parciales, como el medio boleto estudiantil o el universitario, y las completas como las de jubilados.
• Implementar cada tipo de tarjeta como una Herencia de la tarjeta original.
• Para esta iteración considerar simplemente que cuando se paga con una tarjeta del tipo MedioBoleto el costo del pasaje vale la mitad, independientemente de cuantas veces se use y que dia de la semana sea.
• Escribir un test que valide que una tarjeta de FranquiciaCompleta siempre puede pagar un boleto.

• Escribir un test que valide que el monto del boleto pagado con medio boleto es siempre la mitad del normal.

  Iteracion 3 (28 de Agosto al 11 de Septiembre)

Al igual que la iteración anterior, se pide mantener la mecánica de trabajo para ir añadiendo las nuevas funcionalidades y/o modificaciones (issue, una rama específica para cada tarea y finalmente el mergeo cuando todo funcione correctamente..., etc.)

En esta iteración daremos una introducción a la manipulación de fechas y horarios. Éstos serán necesarios en esta oportunidad para realizar las modificaciones pedidas. Consultar este video para conocer más sobre el manejo de fechas y horas en PHP: https://www.youtube.com/watch?v=dVRl1kqxdwY

Más datos sobre el boleto.

• La clase boleto tendrá nuevos métodos que permitan conocer: (Fecha, tipo de tarjeta, línea de colectivo, total abonado, saldo e ID de la tarjeta. Recordar que el tipo de boleto (Normal, Viaje Plus) de los boletos indican si se hizo un viaje plus o no

• Además el boleto tiene una descripcion extra indicando si se canceló viaje plus con el pago de este boleto (Ejemplo: Abona viajes plus 29.63 y).

• Deben crearse los atributos faltantes de las correspondientes clases, si los hubiere. Considerar la siguiente imagen para entender las posibles variaciones de un boleto:

• Escribir los tests correspondientes a los posibles tipos de boletos a obtener según el tipo de tarjeta.

Limitación en el pago de medio boletos

Para evitar el uso de una tarjeta de tipo medio boleto en más de una persona en el mismo viaje se pide que:

• Al utilizar una tarjeta de tipo medio boleto para viajar, deban pasar como mínimo 5 minutos antes de realizar otro viaje. No será posible pagar otro viaje antes de que pasen estos 5 minutos.
• Escribir un test que verifique efectivamente que no se deje marcar nuevamente al intentar realizar otro viaje en un intervalo menor a 5 minutos con la misma tarjeta medio boleto. Para el caso de medio boleto universitario, se pueden realizar solo dos viajes por día. El tercer viaje ya posee su valor normal.
• Escribir un test que verifique que no se puedan realizar más de dos viajes por día.

Iteracion 4 (12 de Septiembre al 25 de Septiembre)

Cobertura de código.

• Contar al menos con un 80% de cobertura de codigo en coveralls.io
• Agregar el icono de coverals al README del proyecto.

Trasbordos

Cuando se realiza un trasbordo, el 2º viaje se cancela a un 33% de la tarifa vigente:

Se pueden abonar solamente con las tarjetas y se pueden realizar todos los días del año durante las 24 hs, exceptuando la misma línea y bandera, teniendo en cuenta tiempos máximos para realizarlos por franja horaria:

• Lunes a viernes de 6 a 22 y sábados de 6 a 14 hs: tiempo máximo 60 minutos.
• Sábados de las 14 a 22 hs, domingos y feriados de 6 a 22 hs: tiempo máximo 90 minutos.
• Noche, comprende franja horaria de 22 a 6 hs: tiempo máximo 90 minutos.

Sólo se permite 1 trasbordo por tarjeta en cada viaje.

Acercando la tarjeta se cancela el viaje emitiendo un boleto impreso con la palabra "trasbordo". No se efectiviza el trasbordo con la cancelación del pasaje plus.

Iteracion 5

• Formatear el código de todo el proyecto utilizando un Coding Standard en particular. (PSR2, Drupal, Wordpress)
• Documentar todos los metodos del proyecto utilizando la sintaxis correcta. Ejemplo: https://gist.github.com/dagostinoips/0bb7aa98a80d0dba11fb4e1c87038bdc
• Configurar scrutinizer-ci para que haga un analisis del código del proyecto.
• Contar con un indice de A o B para cada archivo del proyecto.
• Agregar al README los badges () de Travis, Coveralls y Scrunitizer.

Iteración 6

(Solo en caso de presentarse a un mesa complementaria).

• En caso de no ser el dueño del proyecto original. Crear un Fork del mismo.
• Las iteraciones anteriores deben estar completas en su totalidad.
• Contar con un porcentaje de cobertura en coveralls del al menos el 95%.
• Todos los métodos de las clases del proyecto deben tener una complejidad de A o B en Scrunitizer.