search

JaviFerradaDev / DEV014-movie-challenge-fw

0 stars 0 forks source link

readme

Movie Challenge con Framework

Índice

1. Preámbulo

La manera en que vemos películas ha cambiado radicalmente durante los últimos años debido, en parte, a la aparición de los servicios de streaming que nos permiten hacerlo desde donde estemos y en cualquier momento. El mejor reflejo de este fenómeno es el éxito de Netflix, HBO y Disney+, etc.

Creemos que hay una gran oportunidad de proponer productos/experiencias innovadoras de todo tipo utilizando datos de películas (directorxs, actorxs, sagas, secuelas, fechas, etc.). Podríamos pensar en juegos, comunidades, catálogos, recomendaciones basadas en gustos personales, etc. (sólo por mencionar algunas ideas obvias).

Pelis

2. Resumen del proyecto

En este proyecto, crearás una página web destinada a visualizar, filtrar y ordenar el catálogo de películas de The Movie Database API V3. Esta página puede servir como un catálogo de películas general, pero también, si te animas, puedes considerar la posibilidad de diseñarla para un público y usuarias específicas con preferencias como "películas western" o "películas de las 80's" por ejemplo.

Para implementar este proyecto deberás elegir un framework entre React y Angular. Al elegir un framework o librería para nuestra interfaz, nos apoyamos en una serie de convenciones e implementaciones probadas y documentadas para resolver un problema común a toda interfaz web: mantener la interfaz sincronizada con el estado. Esto nos permite concentrarnos mejor (dedicar más tiempo) en las características específicas de nuestra aplicación.

Cuando elegimos una de estas tecnologías no solo importamos un pedacito de código para reusarlo (lo cuál es un gran valor per se), si no que adoptamos una arquitectura, una serie de principios de diseño, un paradigma, unas abstracciones, un vocabulario, una comunidad, etc...

Como desarrolladora Front-end, estos kits de desarrollo pueden resultarte de gran ayuda para implementar rápidamente características de los proyectos en los que trabajes.

3. Objetivos de aprendizaje

Reflexiona y luego marca los objetivos que has llegado a entender y aplicar en tu proyecto. Piensa en eso al decidir tu estrategia de trabajo.

HTML

CSS

JavaScript

Testing en Javascript

Módulos

Control de Versiones (Git y GitHub)

Git

GitHub

HTTP

Angular

React

Vue

Typescript

Tipos básicos

Tipos Objecto (Tipos básicos)

Clases

Miembros de clase (Clases)
Herencia de clases (Clases)

Diseño de producto

4. Consideraciones generales

Este proyecto se debe "resolver" de manera individual.

Los tests unitarios deben cubrir un mínimo del 70% de statements, functions, lines y branches.

El rango de tiempo estimado para completar el proyecto es de 3 a 4 Sprints.

Para implementar este proyecto te recomendamos usar la planificación sugerida que se encuentra en el repo movie-challenge-planner el cual provee un CLI para hacer fork del presente repositorio y crear un GitHub Project con el milestone e issues de cada historia de usuaria.

5. Consideraciones técnicas

La aplicación debe ser un Single Page App.

La aplicación no debe ser responsive.

Para poder usar la API de The Movie Database API V3 deberás crear una cuenta, luego una llave (key) de acceso y usarla en cada petición que hagas al servidor. Recuerda que tienes un máximo de 1.000 peticiones diarias a la APIs por cada IP, creemos que es suficiente, pero te recomendamos hacer un uso responsable de este recurso gratuito.

Uno de los mayores objetivos de este proyecto es aprender a usar una librería o framework popular para desarrollar una web app. Debes elegir entre React o Angular.

Si usas Angular o React, tienes la obligación de usar TypeScript. Typescript es un lenguaje de programación fuertemente tipado basado en javascript.

Si usas Angular, te recomendamos usar la versión 14. Para esto es necesario que tengas instalada la version 12 de NodeJS. Puedes encontrar una guia de instalación acá o consultar con tus coaches.

La aplicación debe hacer uso de npm-scripts y contar con scripts start, test, build y deploy, que se encarguen de arrancar, correr las pruebas, empaquetar y desplegar la aplicación respectivamente.

6. Criterios mínimos de aceptación del proyecto

Prototipo de baja fidelidad

El Product Owner nos entrega una primera iteración del prototipo de baja fidelidad de la aplicación en esta imagen y esta otra.

Definición del producto

El Product Owner nos presenta este backlog que es el resultado de su trabajo con el clientx hasta hoy.

[Historia técnica 1] Configuración del proyecto

Al iniciar un proyecto siempre hay una serie de tareas a las que debemos dedicar tiempo.

Definición de terminado

[Historia de usuario 2] Lista de películas

Como usuario, quiero visualizar el catálogo de películas en filas y columnas.

Definición de terminado

[Historia de usuario 3] Lista de películas paginadas

Como usuario, quiero navegar por el catálogo de las películas dividido en páginas.

Definición de terminado

[Historia de usuario 4] Filtrar y ordenar

Como usuario, quiero poder filtrar las películas por género y ordenarlas por año en orden ascendente y descendente.

Definición de terminado

[Historia de usuario 5] Detalles de la película

Como usuario, quiero poder ver información detallada sobre una película, para poder tomar decisiones informadas sobre si verla o no.

Definición de terminado

7. Despliegue

Puedes elegir el proveedor (o proveedores) que prefieras junto con el mecanismo de despligue y estrategia de alojamiento. Te recomendamos explorar las siguientes opciones:

8. Planificación

Para implementar este proyecto te recomendamos usar la planificación sugerida que se encuentra en el repo movie-challenge-planner, el cual provee un CLI que te ayudará a forkear el presente repositorio y crear un GitHub Project con el milestone e issues de cada historia de usuaria.

El rango de tiempo estimado para completar el proyecto es de 3 a 4 Sprints. Te sugerimos organizarte de la siguiente manera:

9. Consideraciones para pedir tu Project Feedback

Antes de agendar tu Project Feedback con un coach, asegúrate que tu proyecto:

Recuerda que debes hacer una autoevaluación de objetivos de aprendizaje y life skills desde tu dashboard de estudiante.

Si no has completado todo lo anterior, no consideramos que estás lista para tu sesión de Project Feedback.

10. Pistas, tips y lecturas complementarias

Súmate al canal de Slack #project-movie-challenge-fw para conversar y pedir ayuda del proyecto.

Prototipo de alta fidelidad

Tomando como base el prototipo de baja fidelidad entregado, crea uno de alta fidelidad en Figma. Define una paleta de colores y un diseño grafico. Procura que esto te tome entre 1 o 2 días.

Explora y consume The Movie Database API

Explora la documentación de The Movie Database API. Inicia leyendo la sección Getting Started, luego AUTHENTICATION --> Application y finalmente las referencias de endpoints /discover/movie y /movie/{movie_id}.

Luego crear una cuenta y genera una llave (key) de acceso para consumir la API.

Finalmente, realiza peticiones HTTP de prueba a la API usando herramientas como Postman o REST Client. Identifica los headers, body, verbos, códigos de respuesta y encodings las peticiones.

Explora la documentacion del framework elegido

La comunidad de desarrolladoras de cada framework se ha forzado mucho por crear documentaciones amigables para quienes inician con cada tecnología. Por lo tanto, date la oportunidad de explorar la documentación y probar sus ejemplos y tutoriales.

Implementa tu primer componente

Toma la primera vista de prototipo de alta e implementala. Te sugerimos seguir los siguientes pasos independiente del framework que uses:

Frameworks / libraries