Skip to content

Laboratoria/DEV014-movie-challenge-fw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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

  • Uso de linter (ESLINT)

  • Uso de identificadores descriptivos (Nomenclatura y Semántica)

Testing en Javascript

Módulos

Control de Versiones (Git y GitHub)

Git

  • Git: Instalación y configuración

  • Git: Control de versiones con git (init, clone, add, commit, status, push, pull, remote)

  • Git: Integración de cambios entre ramas (branch, checkout, fetch, merge, reset, rebase, tag)

GitHub

  • GitHub: Colaboración en Github (branches | forks | pull requests | code review | tags)

  • GitHub: Organización en Github (projects | issues | labels | milestones | releases)

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

  • Crear prototipos de alta fidelidad que incluyan interacciones

  • Seguir los principios básicos de diseño visual

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
  • Es posible ejecutar el proyecto y que nuestro navegador muestre la aplicación por defecto.

  • Es posible ejecutar el linter y los tests unitarios.

  • No es posible hacer un push directo a la rama principal

  • Existe un Figma con los diseños de alta fidelidad

  • La aplicación esta desplegada correctamente y se proporciona una URL pública.


[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
  • Al visitar la aplicación desplegada debe visualizar en una tabla (filas y columnas) el catálogo de películas de The Movie Database API V3

[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
  • Al visitar nuestra aplicación desplegada debe visualizar el catálogo de películas y navegar entre páginas.

[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
  • El usuario debe poder filtrar el catálogo por género.

  • El usuario debe poder eliminar el filtro para ver películas sin filtrar

  • El usuario debe poder ordenar de forma ascendente el catálogo por año.

  • El usuario debe poder ordenar el catálogo de forma descendente por año.

  • El usuario debe poder eliminar la clasificación para ver las películas sin ordenar


[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
  • Los usuarios pueden navegar a la página de detalles de la película desde la lista de películas o cualquier sección relevante.

  • Los detalles de la película se muestran de forma destacada, proporcionando información completa sobre la película seleccionada.

  • Los usuarios pueden volver fácilmente a la página anterior.

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:

  • Vercel es una plataforma de despliegue que nos permite desplegar nuestra aplicación web estática (HTML, CSS y JavaScript) y también nos permite desplegar aplicaciones web que se ejecutan en el servidor (Node.js).
  • Netlify al igual que Vercel, es una plataforma de despliegue que nos permite desplegar nuestra aplicación web estática (HTML, CSS y JavaScript) y también nos permite desplegar aplicaciones web que se ejecutan en el servidor (Node.js).

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:

  • Paso 1: Separa la UI en una jerarquía de componentes
  • Paso 2: Construye una versión estática de la UI sin añadir ninguna interactividad aún
  • Paso 3: Encuentra la representación mínima pero completa del estado de la UI. Piensa en el estado como el conjunto mínimo de datos cambiantes que la aplicación necesita recordar.
  • Paso 4: Después de identificar los datos mínimos de estado de tu aplicación, debes identificar qué componente es responsable de cambiar este estado, o posee el estado.
  • Paso 5: Identifica el flujo de comunicación entre cada componente: padre a hijo o hijo a padre. Implementa la estrategia identificada tal como te sugiere el framework.

Frameworks / libraries

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published