semana3 - UDFJDC-ProgramacionAvanzada/PA_202510_G83_E4_Front GitHub Wiki

Detallar de historias de usuario

Detalla: [Didier Stiveen Torres Gil]


HU01 - Búsqueda de productos

Elemento Descripción
Búsqueda de productos Como comprador, quiero buscar productos por nombre o categoría para encontrarlos fácilmente.

Criterios de aceptación

  • El sistema debe permitir ingresar texto en una barra de búsqueda.
  • Los resultados deben coincidir con el nombre, categoría o descripción.
  • Debe mostrar resultados relevantes de forma rápida.
  • El buscador debe estar disponible en todas las páginas principales.

HU02 - Filtros de búsqueda

Elemento Descripción
Filtros de búsqueda Como comprador, quiero aplicar filtros a los resultados de búsqueda para encontrar productos que se ajusten a mis necesidades.

Criterios de aceptación

  • Deben incluirse filtros como precio, categoría, calificación y disponibilidad.
  • El usuario debe poder aplicar varios filtros a la vez.
  • Los resultados deben actualizarse automáticamente.
  • Debe existir una opción para limpiar los filtros aplicados.

HU03 - Vista detallada de productos

Elemento Descripción
Vista detallada de productos Como comprador, quiero ver la información detallada de un producto para tomar una decisión de compra informada.

Criterios de aceptación

  • La página debe mostrar imágenes, descripción, precio, disponibilidad y valoraciones.
  • Debe incluir información del vendedor y opciones de envío.
  • El usuario debe poder agregar el producto al carrito desde esta vista.
  • Debe ser accesible desde los resultados de búsqueda o la lista de productos.

HU04 - Registro de vendedores

Elemento Descripción
Registro de vendedores Como usuario, quiero registrarme como vendedor para poder publicar mis productos.

Criterios de aceptación

  • El formulario de registro debe solicitar información básica y datos del negocio.
  • El sistema debe validar que el correo no esté registrado previamente.
  • Se debe enviar una confirmación por correo electrónico.
  • El vendedor debe poder completar su perfil después del registro.

HU05 - Publicación de productos

Elemento Descripción
Publicación de productos Como vendedor, quiero publicar productos con sus detalles para que los compradores puedan verlos y comprarlos.

Criterios de aceptación

  • El sistema debe permitir cargar nombre, imágenes, precio, stock y categoría.
  • El vendedor debe poder editar o eliminar productos publicados.
  • El producto debe mostrarse en el catálogo tras su publicación.
  • Se debe validar que todos los campos requeridos estén completos antes de publicar.

Detalla: [Julian Esteban Valencia Vargas]

HU06 - Registro de usuario

Elemento Descripción
Registro de usuario Como usuario, quiero registrarme en la plataforma para poder comprar productos.

Criterios de aceptación

  • El sistema debe permitir el ingreso de datos básicos (nombre, correo electrónico, contraseña).
  • El sistema debe validar que el correo no esté registrado previamente.
  • El usuario debe recibir una notificación de registro exitoso.
  • La contraseña debe tener al menos 8 caracteres.

HU07 - Chat entre compradores y vendedores

Elemento Descripción
Chat entre compradores y vendedores Como usuario, quiero enviar mensajes a los vendedores para resolver dudas.

Criterios de aceptación

  • El sistema debe permitir iniciar una conversación desde la vista del producto.
  • Los mensajes deben mostrarse en tiempo real.
  • El historial de conversación debe guardarse por usuario y producto.
  • Solo usuarios registrados pueden utilizar el chat.

HU08 - Filtrado y ordenamiento de productos

Elemento Descripción
Filtrado y ordenamiento de productos Como comprador, quiero filtrar y ordenar productos para encontrar lo que necesito más rápido.

Criterios de aceptación

  • El sistema debe permitir filtrar por categorías, precios y disponibilidad.
  • El sistema debe permitir ordenar por precio, nombre y valoración.
  • Los filtros deben poder combinarse.
  • El listado de productos debe actualizarse sin necesidad de recargar la página.

HU09 - Búsqueda de productos

Elemento Descripción
Búsqueda de productos Como comprador, quiero buscar productos por categoría para encontrar lo que necesito.

Criterios de aceptación

  • El sistema debe mostrar una barra de búsqueda accesible en todo momento.
  • Debe permitir sugerencias mientras se escribe.
  • La búsqueda debe ser funcional por nombre y categoría.
  • Los resultados deben mostrarse ordenados por relevancia.

HU10 - Calificación de productos

Elemento Descripción
Calificación de productos Como comprador, quiero calificar productos para ayudar a otros compradores.

Criterios de aceptación

  • Solo usuarios que hayan comprado pueden calificar.
  • El sistema debe permitir calificar con estrellas (1 a 5) y comentarios.
  • Las calificaciones deben mostrarse públicamente en la página del producto.
  • Se debe calcular y mostrar el promedio de calificaciones.

Detalla: [Dominic Felipe Robayo Devia]


HU11 - Carrito persistente

Elemento Descripción
Carrito persistente Como comprador, quiero que los productos añadidos al carrito se conserven aunque recargue la página, para no perder mi selección.

Criterios de aceptación

  • El carrito debe guardar los productos en localStorage.
  • El contenido debe mantenerse visible incluso tras recargar la página.
  • Debe poder modificar la cantidad o eliminar productos.
  • Al volver al sitio, el carrito debe cargarse con los datos previos.

HU12 - Valoración de productores

Elemento Descripción
Valoración de productores Como comprador, quiero calificar y dejar comentarios en los perfiles de los productores para compartir mi experiencia.

Criterios de aceptación

  • Se debe permitir seleccionar entre 1 y 5 estrellas.
  • El sistema debe permitir escribir un comentario.
  • La calificación debe guardarse en localStorage.
  • La UI debe reflejar visualmente la calificación elegida.

HU13 - Página de presentación institucional

Elemento Descripción
Página “¿Quiénes somos?” Como visitante, quiero conocer la misión, visión y valores de Kapchy Market para comprender su propósito.

Criterios de aceptación

  • La página debe incluir una imagen, título, misión, visión y valores.
  • Debe integrarse al Navbar bajo el enlace "¿Quiénes somos?".
  • El contenido debe adaptarse al idioma del navegador.
  • Debe respetar la estética del resto del sitio.

HU14 - Navegación entre páginas

Elemento Descripción
Navegación en la plataforma Como usuario, quiero acceder fácilmente a las secciones del sitio desde la barra de navegación.

Criterios de aceptación

  • El Navbar debe estar presente en todas las páginas.
  • Debe tener enlaces a Tienda, Productores, Registro, Login, Carrito y ¿Quiénes somos?
  • Al hacer clic, se debe redirigir correctamente a la ruta correspondiente.
  • Los enlaces deben estar internacionalizados.

HU15 - Visualización de productores

Elemento Descripción
Galería de productores Como usuario, quiero ver una galería de productores con su foto, nombre y ubicación para conocer quiénes ofrecen los productos.

Criterios de aceptación

  • Debe mostrarse una tarjeta por productor con su foto, nombre y ubicación.
  • La tarjeta debe tener un botón para calificar al productor.
  • Debe incluir una barra de búsqueda para filtrar por nombre o ubicación.
  • Cada tarjeta debe tener enlace a su detalle.

HU16 - Internacionalización del sitio

Elemento Descripción
Soporte multilenguaje Como usuario, quiero que el sitio muestre la información en mi idioma según la configuración del navegador.

Criterios de aceptación

  • Todos los textos deben usar <FormattedMessage />.
  • El idioma debe seleccionarse automáticamente usando navigator.language.
  • Debe haber archivos es.json y en.json para los textos.
  • El idioma debe cambiar dinámicamente en toda la UI.