https://github.com/idealista/coding-test-ranking-php
- Se han modificado los constructores en php8 debido a que todavía no son compatibles con netbeans 12.2
- Se ha interpretado que tanto publicAd como qualityAd eran entidades de dominio.
- Endpoint para el cálculo: /calculate
- Endpoint para el listado de ad para usuarios: /listing
- Endpoint para el listado de ad para calidad: /quality
- Se usa la dependencia FileSystem para persistir los datos.
- Ejecución de test unitarios: php bin/phpunit
- No se han realizado test de aceptación, con los test unitarios he pensado que era suficiente.
Este repositorio contiene un API parcialmente desarrollada para desarrollar un servicio que se encargue de medir la calidad de los anuncios. Tu objetivo será implementar las historias de usuario que se describen más adelante.
Los supuestos están basados en un hipotético equipo de gestión de calidad de los anuncios, que demanda una serie de verificaciones automáticas para clasificar los anuncios en base a una serie de características concretas.
-
Yo, como encargado del equipo de gestión de calidad de los anuncios quiero asignar una puntuación a un anuncio para que los usuarios de idealista puedan ordenar anuncios de más completos a menos completos. La puntuación del anuncio es un valor entre 0 y 100 que se calcula teniendo encuenta las siguientes reglas:
- Si el anuncio no tiene ninguna foto se restan 10 puntos. Cada foto que tenga el anuncio proporciona 20 puntos si es una foto de alta resolución (HD) o 10 si no lo es.
- Que el anuncio tenga un texto descriptivo suma 5 puntos.
- El tamaño de la descripción también proporciona puntos cuando el anuncio es sobre un piso o sobre un chalet. En el caso de los pisos, la descripción aporta 10 puntos si tiene entre 20 y 49 palabras o 30 puntos si tiene 50 o mas palabras. En el caso de los chalets, si tiene mas de 50 palabras, añade 20 puntos.
- Que las siguientes palabras aparezcan en la descripción añaden 5 puntos cada una: Luminoso, Nuevo, Céntrico, Reformado, Ático.
- Que el anuncio esté completo también aporta puntos. Para considerar un anuncio completo este tiene que tener descripción, al menos una foto y los datos particulares de cada tipología, esto es, en el caso de los pisos tiene que tener también tamaño de vivienda, en el de los chalets, tamaño de vivienda y de jardín. Además, excepcionalmente, en los garajes no es necesario que el anuncio tenga descripción. Si el anuncio tiene todos los datos anteriores, proporciona otros 40 puntos.
-
Yo como encargado de calidad quiero que los usuarios no vean anuncios irrelevantes para que el usuario siempre vea contenido de calidad en idealista. Un anuncio se considera irrelevante si tiene una puntación inferior a 40 puntos.
-
Yo como encargado de calidad quiero poder ver los anuncios irrelevantes y desde que fecha lo son para medir la calidad media del contenido del portal.
-
Yo como usuario de idealista quiero poder ver los anuncios ordenados de mejor a peor para encontrar fácilmente mi vivienda.
En este proyecto te proporcionamos un pequeño esqueleto escrito en PHP 8 usando Symfony Flex.
En dicho esqueleto hemos dejado varios Controllers y un Repository en el sistema de ficheros como orientación. Puedes crear las clases y métodos que consideres necesarios.
Podrás ejecutar el proyecto utilizando la configuración de Docker que dejamos en el mismo esqueleto e instalando a través de composer los paquetes necesarios.
La persistencia de datos no forma parte del objetivo del reto. Si no vas a usar el esqueleto que te proporcionamos, te sugerimos que la simplifiques tanto como puedas (con una base de datos embebida, "persistiendo" los objetos en memoria, usando un fichero...). El diseño de una interfaz gráfica tampoco forma parte del alcance del reto, por tanto no es necesario que la implementes.
Nota: No estás obligado a usar el proyecto proporcionado. Si lo prefieres, puedes usar cualquier otro lenguaje, framework y/o librería. Incluso puedes prescindir de estos últimos si consideras que no son necesarios. A lo que más importancia damos es a tener un código limpio y de calidad.
A continuación se enumeran los requisitos mínimos para ejecutar el proyecto:
- PHP 8
- Symfony Local Web Server o Nginx.
-
El código debe ser ejecutable y no mostrar ninguna excepción.
-
Debes proporcionar 3 endpoints: Uno para calcular la puntuación de todos los anuncios, otro para listar los anuncios para un usuario de idealista y otro para listar los anuncios para el responsable del departamento de gestión de calidad.