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.