Skip to content

Laura9426/BOG005-social-network

 
 

Repository files navigation

MUSIC BOOK

Índice

1. Preámbulo

Music Book es un red social dedicada a todos los amantes de la música, que quieran compartir sus experencias o acordes. Diseñado para que las personas que esten interesadas en este tema puedan socializar sus diferentes opiniones.

2. Investigación UX

Empezamos con el diseño en figma y tuvimos feedback de compañeras y familiares; los cuales nos hicieron cambiar los estilos de los botones y algunos colores. Despues de las recomendaciones el diseño final quedo asi;

Link a Figma

2. Historias de usuario

Historia 1.1

Yo como usuario quiero crear una cuenta en la red social MUSIC BOOK por correo electrónico para poder tener acceso a la red social

Criterios de aceptación:

Se permita el acceso al usuario con correos electrónicos valido Que con un correo electrónico exista solo una cuenta La contraseña debe ser oculta cuando se escriba Definición de terminado: • Debe ser una SPA. • Debe ser responsive. • Deben haber recibido code review de al menos una compañera de otro equipo. • Hicieron los test unitarios • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras. • Commit en Git hub.

Historia 1.2

Yo como usuario quiero crear una cuenta en la red social MUSIC BOOK por Google para poder tener acceso a la red social.

Criterios de aceptación:

Se permita el acceso al usuario con correos electrónicos valido Que con un correo electrónico exista solo una cuenta La contraseña debe ser oculta cuando se escriba Definición de terminado: • Debe ser una SPA. • Debe ser responsive. • Deben haber recibido code review de al menos una compañera de otro equipo. • Hicieron los test unitarios • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras. • Commit en Git hub.

Historia 2.1

Yo como usuario quiero iniciar sesión en music book por medio del correo electrónico para poder entrar en la red social

Criterios de aceptación:

Se permita el acceso al usuario con correos electrónicos valido Que con un correo electrónico exista solo una cuenta La contraseña debe ser oculta cuando se escriba Definición de terminado: • Debe ser una SPA. • Debe ser responsive. • Deben haber recibido code review de al menos una compañera de otro equipo. • Hicieron los test unitarios • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras. • Commit en Git hub.

Historia 2.2

Yo como usuario quiero iniciar sesión en music book por medio de Google para poder entrar en la red social

Criterios de aceptación:

Se permita el acceso al usuario con correos electrónicos valido Que con un correo electrónico exista solo una cuenta La contraseña debe ser oculta cuando se escriba Definición de terminado: • Debe ser una SPA. • Debe ser responsive. • Deben haber recibido code review de al menos una compañera de otro equipo. • Hicieron los test unitarios • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras. • Commit en Git hub.

Historia 3

Yo como usuario quiero poder publicar en el muro de la red social para que otras personas lo vean

-Prototipo del muro en Figma -Estructura en HTML con estilos -Que sea responsive

Criterios de aceptación:

Que el muro se pueda visualizar Que se pueda escribir en un input Que pueda por medio de un botón publicar

Definición de terminado: • Debe ser una SPA. • Debe ser responsive. • Deben haber recibido code review de al menos una compañera de otro equipo. • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras.

Historia 4

Yo como usuario quiero poder borrar una publicación que hice en el muro de la red social para que otras personas no lo vean

Criterios de aceptación:

• Que el muro se pueda visualizar • Que se pueda seleccionar el boton para borrar la publicación • Que salga una alerta para asegurar que se quiere borrar la publicación • Que se borre la publicación

Definición de terminado: • Que cumpla el funcionamiento. • Deben haber recibido code review de al menos una compañera de otro equipo. • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras.

Historia 5

Yo como usuario quiero poder editar las publicaciones que ya hice para que se puedan visualizar en el muro los cambios

Criterios de aceptación:

• Que el muro se pueda visualizar • Que se pueda seleccionar el boton para editar • Que salga en el muro el texto editado

Definición de terminado: • Que cumpla el funcionamiento. • Deben haber recibido code review de al menos una compañera de otro equipo. • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras.

Historia 6

Yo como usuario quiero poder dar like a las publicaciones para que se puedan visualizar en el muro.

Criterios de aceptación:

• Que en el muro se pueda visualizar • Que se pueda seleccionar el boton para dar like • Que salga en el muro la cantidad de likes

Definición de terminado: • Que cumpla el funcionamiento. • Deben haber recibido code review de al menos una compañera de otro equipo. • Testearon manualmente buscando errores e imperfecciones simples. • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras.

Link a Tablero de project Git hub

##Responsive Empezamos con un dieño de escritorio y por medio de media query fuimos adaptando a mobile.

Diseño Escritorio Escritorio 1

Escritorio 1

Escritorio 1

Diseño mobile

Mobile 1

Mobile 2


Índice

1. Preámbulo

Instagram, Snapchat, Twitter, Facebook, Twitch, Linkedin, etc. Las redes sociales han invadido nuestras vidas. Las amamos u odiamos, y muchos no podemos vivir sin ellas.

adem-ay-Tk9m_HP4rgQ-unsplash

Hay redes sociales de todo tipo y para todo tipo de intereses. Por ejemplo, en una ronda de financiamiento con inversionistas, se presentó una red social para químicos en la que los usuarios podían publicar artículos sobre sus investigaciones, comentar en los artículos de sus colegas, y filtrar artículos de acuerdo a determinadas etiquetas o su popularidad, lo más reciente, o lo más comentado.

2. Resumen del proyecto

En este proyecto construirás una Red Social sobre lo que decidan tú y tu equipo. Podría ser, por ejemplo, sobre alimentación saludable, feminismo, educación, salud, energías renovables, amantes de las Empanadas o de los Tacos de Canasta, de la Feijoada, o de lo que sea.

Tu Red Social tendrá que permitir a cualquier usuario crear una cuenta de acceso y loguearse con ella; crear, editar, borrar y "likear" publicacciones.

El objetivo principal de aprendizaje de este proyecto es construir una Single-page Application (SPA) responsive (con más de una vista / página) en la que podamos leer y escribir datos.

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

Web APIs

JavaScript

  • Uso de linter (ESLINT)

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

  • Diferenciar entre expresiones (expressions) y sentencias (statements)

  • Callbacks

    Links

Control de Versiones (Git y GitHub)

  • 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: Creación de cuenta y repos, configuración de llaves SSH

  • GitHub: Despliegue con GitHub Pages

    Links

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

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

user-centricity

  • Diseñar un producto o servicio poniendo a la usuaria en el centro

product-design

  • Crear prototipos de alta fidelidad que incluyan interacciones

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

research

Firebase

4. Consideraciones generales

  • Este proyecto se debe trabajar en equipos de tres.

  • La lógica del proyecto debe estar implementada completamente en JavaScript (ES6+), HTML y CSS 😃. Para este proyecto no está permitido utilizar frameworks o librerías de CSS y JS.

  • La división y organización del trabajo debe permitir, sin excepciones, que cada integrante del equipo practique el aprendizaje de todo lo involucrado en cada historia. No se dividan el trabajo como en una fábrica.

    • ¿Hasta acá has avanzado en tus proyectos con cierta fluidez y sin mayores problemas? Sé generosa con tus compañeras, permíteles aprender y practicar sin restricciones, aunque tome un poco más de tiempo. Aproveha de coachearlas, de hacer pair programming, una de las mejores maneras de aprender es explicando verbalmente.

    • ¿Se te está haciendo difícil y te cuesta un poco más avanzar? No te quedes con las partes "fáciles" del proyecto, conversa, negocia, exige tu oportunidad para practicar y aprender lo que se te hace más difícil.

  • Solamente pueden trabajar en una única historia por vez, no pueden avanzar a la siguiente sin haber completado la anterior. La historia se completa cuando se cumplen todos sus Criterios de Aceptación + toda su Definición de Terminado.

Para comenzar tendrás que hacer un fork y clonar este repositorio.

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

5.1 Boilerplate

Este proyecto no incluye un boilerplate, así es que tendrás que definir la estructura de carpetas y escribir tus propias Pruebas Unitarias (tests). Para hacerlo, puedes guiarte de los proyectos anteriores.

5.2 Definición del producto

En el README.md cuéntanos brevemente cómo descubriste las necesidades de los usuarios y cómo llegaste a la definición final de tu producto. Es importante que detalles:

  • Quiénes son los principales usuarios de producto.
  • Qué problema resuelve el producto / para qué le servirá a estos usuarios.

5.3 Historias de usuario

Una vez que entiendas las necesidades de tus usuarixs, escribe las Historias de Usuario que representen todo lo que necesitan hacer/ver en la Red Social. Cada una de tus Historias de Usuario debe tener:

  • Criterios de Aceptación: todo lo que debe ocurrir para satisfacer las necesidades del usuario.

  • Definición de terminado: todos los aspectos técnicos que deben cumplirse para que, como equipo, sepan que esa historia está terminada y lista para publicarse. Todas tus Historias de Usuario (salvo excepciones), deben incluir estos aspectos en su Definición de Terminado (más todo lo que necesiten agregar):

    • Debe ser una SPA.
    • Debe ser responsive.
    • Deben haber recibido code review de al menos una compañera de otro equipo.
    • Hicieron los test unitarios
    • Testearon manualmente buscando errores e imperfecciones simples.
    • Hicieron pruebas de usabilidad e incorporaron el feedback de los usuarios como mejoras.
    • Desplegaron su aplicación y etiquetaron la versión (git tag).

5.4 Diseño de la Interfaz de Usuario (prototipo de baja fidelidad)

Debes definir cuál será el flujo que seguirá el usuario dentro de tu aplicación y, con eso, diseña la Interfaz de Usuario (UI por sus siglas en inglés) que siga este flujo.

5.5 Responsive

Debe verse bien en dispositivos de pantallas grandes (computadoras/es, laptops, etc.) y pequeñas (tablets, celulares, etc.). Te sugerimos seguir la técnica de mobile first (más detalles sobre esta técnica al final).

5.6 Consideraciones del comportamiento de la interfaz de usuario (UI)

Estas consideraciones te ayudarán a escribir las Definiciones de Terminado de tus H.U.:

Creación de cuenta de usuario e inicio de sesión

  • Login con Firebase:
    • Para el login y las publicaciones en el muro puedes utilizar Firebase
    • Creación de cuenta de acceso y autenticación con cuenta de correo y contraseña, y también con una cuenta de Google.
  • Validaciones:
    • Solamente se permite el acceso a usuarios con cuentas válidas.
    • No pueden haber usuarios repetidos.
    • La cuenta de usuario debe ser un correo electrónico válido.
    • Lo que se escriba en el campo (input) de contraseña debe ser secreto.
  • Comportamiento:
    • Al enviarse el formulario de registro o inicio de sesión, debe validarse.
    • Si hay errores, se deben mostrar mensajes descriptivos para ayudar al usuario a corregirlos.

Muro/timeline

  • Validaciones:
    • Al publicar, se debe validar que exista contenido en el input.
  • Comportamiento:
    • Al recargar la aplicación, se debe verificar si el usuario está logueado antes de mostrar contenido.
    • Poder publicar un post.
    • Poder dar y quitar like a una publicación. Máximo uno por usuario.
    • Llevar un conteo de los likes.
    • Poder eliminar un post específico.
    • Pedir confirmación antes de eliminar un post.
    • Al dar click para editar un post, debe cambiar el texto por un input que permita editar el texto y luego guardar los cambios.
    • Al guardar los cambios debe cambiar de vuelta a un texto normal pero con la información editada.
    • Al recargar la página debo de poder ver los textos editados.

5.7 Consideraciones técnicas Front-end

  • Separar la manipulación del DOM de la lógica (Separación de responsabilidades).
  • Contar con múltiples vistas. Para esto, tu aplicación debe ser una Single Page Application (SPA)
  • Alterar y persistir datos. Los datos que agregues o modifiques deberán persistir a lo largo de la aplicación. Te recomendamos que uses Firebase para eso también.

Pruebas unitarias (unit tests)

  • Recuerda que no hay un setup de tests definido, dependerá de la estructura de tu proyecto. Algo que no debes de olvidar es pensar en éstas pruebas, te pueden ayudar a definir la estructura y nomenclatura de tu lógica.

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

5.8 Consideraciones técnicas UX

  • Hacer al menos 2 entrevistas con usuarios.
  • Hacer un prototipo de baja fidelidad.
  • Asegurarte de que la implementación en código siga los lineamientos del diseño.
  • Hacer sesiones de testing de usabilidad con el producto en HTML.

6. Hacker edition

Las secciones llamadas Hacker Edition son opcionales. Si terminaste con todo lo anterior y te queda tiempo, intenta completarlas. Así podrás profundizar y/o ejercitar más sobre los objetivos de aprendizaje del proyecto.

  • Permite crear posts con imágenes.
  • Permite buscar usuarios, agregar y eliminar "amigos".
  • Permite definir la privacidad de los posts (público o solamente para amigos).
  • Permite ver su muro de cualquier usuario "no-amigo" (solamente los posts públicos).
  • Permite comentar o responder una publicación.
  • Permite editar perfil.

7. Entrega

El proyecto será entregado subiendo tu código a GitHub (commit/push) y la interfaz será desplegada usando GitHub pages u otro servicio de hosting que puedas haber encontrado en el camino.


8. Pistas, tips y Lecturas complementarias

Mobile first

El concepto de mobile first hace referencia a un proceso de diseño y desarrollo donde partimos de cómo se ve y cómo funciona la aplicación en un dispositivo móvil primero, y más adelante se ve como adaptar la aplicación a pantallas progresivamente grandes y características específicas del entorno desktop. Esto es en contraposición al modelo tradicional, donde primero se diseñaban los websites (o webapps) para desktop y después se trataba de arrugar el diseño para que entre en pantallas más chicas. La clave acá es asegurarse de que desde el principio diseñan usando la vista responsive de las herramientas de desarrollador (developer tools) del navegador. De esa forma, partimos de cómo se ve y comporta la aplicación en una pantalla y entorno móvil.

Múltiples vistas

En proyectos anteriores nuestras aplicaciones habían estado compuestas de una sola vista principal (una sóla página). En este proyecto se introduce la necesidad de tener que dividir nuestra interfaz en varias vistas o páginas y ofrecer una manera de navegar entre estas vistas. Este problema se puede afrontar de muchas maneras: con archivos HTML independientes (cada uno con su URL) y links tradicionales, manteniendo estado en memoria y rederizando condicionalmente (sin refrescar la página), manipulando el historial del navegador con window.history. En este proyecto te invitamos a explorar opciones y decidir una opción de implementación.

Escritura de datos

En los proyectos anteriores hemos consumido (leído) datos, pero todavía no habíamos escrito datos (salvar cambios, crear datos, borrar, ...). En este proyecto tendrás que crear (salvar) nuevos datos, así como leer, actualizar y modificar datos existentes. Estos datos se podrán guardar de forma remota usando Firebase.

Otras:

Únete al canal de Slack #project-social-network

About

Music Book - Una red social para compartir todas tus ideas de covers de alguna cancion, o tus acordes. Recomienda y da consejos a las personas que estan aprendiendo sobre musica.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 77.3%
  • CSS 19.4%
  • HTML 3.3%