# 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.