Primer prototipo

2026-05-20 14:05:55 +02:00
parent c2ab9a46d4
commit c06300833b
22 changed files with 1115 additions and 2 deletions
@@ -0,0 +1,51 @@
+# Casos de uso
+
+Este documento describe los casos de uso del prototipo. El objetivo es mantener
+el alcance acotado para minimizar el coste de mantenimiento.
+
+## Actores
+
+- **Visitante**: cualquier persona que accede a la aplicación. No requiere
+  autenticación. Puede consultar el mapa y contribuir con nuevas entradas.
+- **Revisor**: persona designada por la organización que aprueba o rechaza las
+  contribuciones. Su flujo está fuera del frontend del prototipo (ver
+  alternativas de implementación).
+
+## Casos de uso del prototipo
+
+### CU-01: Explorar negocios en el mapa
+- El visitante abre la aplicación.
+- Ve un mapa centrado en una ubicación por defecto con marcadores de los
+  negocios aprobados.
+- Puede hacer zoom y desplazarse libremente.
+
+### CU-02: Ver detalles de un negocio
+- El visitante selecciona un marcador en el mapa.
+- La barra lateral muestra los detalles del negocio: nombre, categoría,
+  dirección, descripción corta y enlace/contacto si existe.
+- Al seleccionar otro marcador, la barra lateral se actualiza.
+
+### CU-03: Contribuir con un nuevo negocio
+- El visitante abre el formulario de contribución desde la interfaz principal.
+- Rellena los campos mínimos: nombre, categoría, dirección, descripción y
+  contacto opcional. La ubicación se obtiene geocodificando la dirección o
+  haciendo clic en el mapa.
+- Envía el formulario. La entrada queda en estado "pendiente de revisión" y no
+  aparece en el mapa hasta ser aprobada.
+- El visitante recibe confirmación visual del envío.
+
+## Fuera de alcance del prototipo
+
+Decisiones tomadas para mantener el proyecto simple (ver
+`02-implementation-alternatives.md` para el razonamiento):
+
+- Autenticación de usuarios.
+- Panel de moderación dentro de la aplicación. La revisión se hace en el
+  backend (por ejemplo, en el dashboard del proveedor de datos elegido).
+- Edición o eliminación de negocios por el visitante.
+- Búsqueda avanzada, filtros complejos o categorías jerárquicas.
+- Comentarios, valoraciones, fotos múltiples o multimedia.
+- Internacionalización. El prototipo usa un único idioma.
+
+Estos casos pueden añadirse después si la comunidad lo pide, pero no forman
+parte del prototipo.