# Cóxegas — guía extendida para asistentes LLM

> Cóxegas es un entorno privado donde puedes encontrar tus vinos y tu gente.
> Guarda y pon comentario a los vinos que pruebas, crea grupos con tus amigos
> y descubre vinos que te van a encantar.
>
> A diferencia de las apps tradicionales de vino, Cóxegas no usa puntuaciones
> numéricas, no tiene tienda ni enlaces de compra, y no usa algoritmos
> comerciales que prioricen lo que alguien quiere venderte. Prioriza lo que
> el vino te hizo sentir, dónde estabas y con quién brindaste.

## Filosofía

Cóxegas es un proyecto personal nacido entre amigos. Las decisiones de
producto se rigen por tres "noes":

- **Sin puntuaciones numéricas.** Un 92 no te dice si ese vino te recordará
  a un viaje o a una cena. Priorizamos lo que el vino te hizo sentir.
- **Sin tienda ni enlaces de compra.** No hay promociones de bodegas.
- **Sin algoritmos comerciales.** No priorizamos vinos que alguien quiere
  venderte por encima de los vinos que te van a gustar.

Para nosotros, el mejor vino es el que te hace sentir algo.

## Inteligencia artificial en Cóxegas

La IA es un complemento, no la protagonista. Cada usuario puede desactivar
todas las funcionalidades de IA desde su perfil. Se usa para:

1. Identificar un vino a partir de la foto de su etiqueta (OCR + LLM).
2. Redactar los mensajes explicativos de la página "Descubrir".
3. Generar el veredicto de "¿Me va a gustar este vino?" a partir de un
   resumen anónimo de los gustos del usuario (tipos, regiones, uvas).

No se envían nombre, email ni datos identificativos al LLM. El proveedor
actual es Mistral AI (francés, GDPR-compliant). Cada consulta es
independiente.

---

## FAQ

### Cuenta y acceso

**¿Cómo me registro?** Pulsa "Registrarse" en la página de inicio. Introduce
tu nombre, email y una contraseña (mínimo 6 caracteres). Puedes elegir si
quieres recibir notificaciones por email cuando se añadan vinos nuevos.
Deberás aceptar la política de privacidad y el aviso legal.

**Me he registrado pero no puedo acceder a los vinos.** Las cuentas nuevas
necesitan ser aprobadas por un administrador. Después de registrarte verás
una pantalla de espera. En cuanto te aprueben podrás acceder a todas las
funcionalidades.

**¿Cómo recupero mi contraseña?** En la pantalla de login, pulsa "¿Olvidaste
tu contraseña?". Introduce tu email y recibirás un enlace para crear una
contraseña nueva. El enlace tiene validez limitada.

**¿Cómo cambio mi foto de perfil?** Ve a tu perfil (pulsando tu avatar o
nombre en la cabecera). Puedes subir una foto en JPG, PNG o WebP. Se
optimiza automáticamente. Si no subes foto, se mostrarán tus iniciales.

**¿Puedo instalar Cóxegas como app en el móvil?** Sí. Cóxegas es una
Progressive Web App (PWA). En el navegador del móvil, pulsa "Añadir a
pantalla de inicio" o "Instalar app".

**¿Cómo me suscribo a la newsletter mensual?** Al registrarte o desde tu
perfil, marca "Recibir newsletter mensual". Recibirás un email a principios
de cada mes con un resumen de novedades.

### Vinos

**¿Cómo añado un vino?** Pulsa el botón "Añadir vino" (icono +) del menú
inferior, en posición central. Rellena el nombre (obligatorio) y
opcionalmente uva, añada, bodega, tipo, región, precio y foto. Tras crearlo
se te lleva al formulario de valoración.

**¿Puedo subir una foto del vino?** Sí. Al pulsar el botón de foto se abre
un selector para elegir entre cámara (hacerla en el momento) o galería
(subir una existente). La imagen se recorta y optimiza automáticamente.
Formatos: JPG, PNG, WebP.

**¿Qué tipos de vino puedo elegir?** Tinto, Blanco, Rosado, Vermú, Espumoso
y Otros.

**¿Cómo edito o elimino un vino?** Los vinos son colaborativos: cualquier
contribuidor (el creador y quienes lo añadieron después con los mismos
datos) puede editarlos. El botón de eliminar solo aparece si eres el único
contribuidor.

**¿Puedo añadir varias añadas del mismo vino?** Sí. Desde el detalle de un
vino, pulsa "Nueva añada". Si editas la añada de un vino con varios
contribuidores, se crea una entrada nueva automáticamente para no pisar el
trabajo del resto.

**¿Puedo escanear la etiqueta de un vino?** Sí. Al crear un vino, el botón
de cámara permite fotografiar la etiqueta. La IA detecta nombre, bodega,
uva, añada y otros datos. Si faltan, busca información adicional en
internet. Puedes revisar y corregir antes de guardar.

**¿Qué pasa si ya existe un vino similar?** El formulario detecta posibles
duplicados y muestra sugerencias. Si acabas añadiendo un vino que ya existe
(mismo nombre, bodega y añada), no se crea duplicado: te unes como
contribuidor al vino existente.

### Valoraciones

**¿Cómo valoro un vino?** En el detalle del vino, pulsa "Valorar". Indica
fecha de cata, lugar, si lo has probado, si repetirías, y un comentario.

**¿Qué es "probado" y "repetiría"?** Probado = ya lo has catado.
Repetiría = te gustó lo suficiente para repetir. Se usan para filtrar el
listado.

**¿Puedo hacer mi comentario privado?** Sí. Desmarca "Comentario visible" al
valorar. Solo tú verás el texto; los demás verán que has valorado el vino.

**¿Puedo indicar dónde probé el vino?** Sí, hay un campo de ubicación con
autocompletado para restaurante, bar o lugar.

**¿Qué pasa con mi ubicación cuando uso "cerca de mí"?** La pide tu
navegador y se guarda solo en la memoria temporal de la pestaña
(sessionStorage). Cóxegas no la almacena en el servidor.

**¿Puedo eliminar mi valoración?** Sí, desde el detalle del vino.

**¿Cómo reporto un error en un vino?** En el detalle del vino, pulsa el
icono de reportar. El reporte se envía por email al equipo.

### Listas

**¿Qué son las listas?** Colecciones personales de vinos para organizarlos
por tema u ocasión: "Favoritos", "Para regalar", "Probados en vacaciones".

**¿Cómo creo una lista?** Sección "Listas" → "Nueva lista". Elige si es
pública o privada.

**¿Cómo añado un vino a una lista?** Desde el detalle del vino, "Añadir a
lista". Puedes crear una lista nueva desde ahí.

**¿Puedo quitar un vino de una lista?** Sí, editando la lista. No elimina
el vino de la aplicación.

### Grupos

**¿Qué son los grupos?** Colecciones colaborativas de vinos con miembros
que contribuyen. Ideales para cenas, catas o clubs.

**¿Cómo creo un grupo?** Sección "Grupos" → "Nuevo grupo". Configura si es
público o privado, y si solo el creador puede añadir vinos.

**¿Cómo me uno a un grupo?** Por invitación (enlace o email) o solicitando
unirte desde la página del grupo. Las solicitudes las aprueba el creador.

**¿Cómo invito a alguien?** Desde la página del grupo, "Invitar". Verás QR,
enlace copiable y compartir nativo. Los enlaces caducan en unas horas.

**¿Cómo añado un vino a un grupo?** Desde el detalle del vino, "Añadir a
grupo". Si el grupo es "solo el creador añade", solo el creador puede.

**¿Los grupos tienen mapa de regiones?** Sí. Pestaña "Mapa" en el grupo:
todos los vinos sobre un mapa interactivo por región geográfica.

**¿Puedo filtrar los vinos de un grupo?** Sí, por tipo, región, uva y por
quién añadió el vino, con selección múltiple.

### Explorar vinos

**¿Cómo filtro los vinos?** Modal de filtros que se abre con el botón
flotante de búsqueda (icono lupa) sobre el menú inferior: tipo, región,
uva, probado y repetiría. Filtros instantáneos, sin recargar. Ordenable
por fecha o precio.

**¿Cómo busco un vino concreto?** Campo de búsqueda dentro del modal de
filtros (mismo botón de la lupa sobre el menú inferior). Busca por nombre,
bodega o uva. Resultados en vivo.

**¿Qué es la pestaña "Míos"?** Vinos creados por ti y los que has valorado
en grupos compartidos.

**¿Qué es Descubrir?** /descubrir sugiere vinos no probados basándose en
los gustos de tu grupo, con explicación de por qué cada vino encaja.

**¿Qué es el perfil de gustos?** En /mis-gustos ves tus estadísticas: vinos
probados, tipos y regiones favoritas, comparación con tu grupo.

**¿Puedo navegar por uva, región o bodega?** Sí, las etiquetas en la ficha
de cada vino son pulsables y llevan a listados filtrados.

### ¿Me va a gustar este vino?

**¿Qué es?** Herramienta para decidir antes de comprar o pedir un vino. Le
indicas un vino y te dice si encaja con tus gustos: veredicto (sí / no /
depende), porcentaje de afinidad y análisis breve. Está en el menú inferior
y en una tarjeta de la página de vinos.

**¿Cómo consulto un vino?** Dos formas: foto a la etiqueta (la IA lo
identifica) o escribir nombre, bodega y añada. Pulsa "Comprobar".

**¿Qué significa el veredicto y el porcentaje?** Veredicto = resumen de
encaje (sí / no / depende). Porcentaje = cuánto coincide el vino con tu
perfil en tipo, región y uvas. No es nota del vino, es estimación de encaje
contigo.

**¿Necesito algo para usarlo?** Sí, conocer tus gustos. La primera vez te
pediremos un perfil de gustos rápido. Cuantos más vinos valores, más afina.

**¿Dónde veo los vinos consultados?** En "Mis veredictos", desde la propia
página. Histórico del más reciente al más antiguo. Re-consultar un vino no
gasta una nueva llamada a la IA.

**¿Quién puede ver mis veredictos?** Cada veredicto es privado por
defecto: solo tú lo ves. Con el botón de compartir, cualquiera con el
enlace lo puede ver. Reversible.

### Novedades

**¿Qué es Novedades?** Resumen de actividad desde tu última visita: vinos
nuevos en tus grupos, valoraciones en tus vinos, y valoraciones nuevas en
vinos que ya habías probado. Accesible desde el menú inferior, con un
contador cuando hay actividad nueva.

---

## Bot de Telegram

Cóxegas tiene un bot de Telegram que permite añadir vinos con foto, buscar
en lenguaje natural y pedir recomendaciones sin salir del chat.

### Qué puedes hacer

- **Añadir vinos** enviando foto de la etiqueta. El bot extrae los datos y
  pide confirmación.
- **Buscar** con frases como "mis mencías", "blancos de Rías Baixas
  pendientes", "los que me gustaron".
- **Pedir recomendaciones** con `/descubrir`: apuestas seguras y aventuras
  con enlaces directos.

No puedes borrar ni editar valoraciones desde el bot. Eso es en la web.

### Vincular tu cuenta

1. Entra en tu perfil y pulsa "Generar código de vinculación". Te da un
   código de 8 caracteres válido 10 minutos.
2. Abre Telegram y busca el bot oficial.
3. Envíale `/start` y luego `/link ABC123XY` (con tu código).
4. El bot confirma con "Vinculado a [tu nombre] ✅".

Para desvincular: `/unlink` desde Telegram o desde el perfil.

### Añadir un vino

1. Envía una foto nítida de la etiqueta. El bot intenta extraer nombre,
   bodega, año, región y uva.
2. Responde con los botones:
   - ✅ Repetiría / ❌ No repetiría — guarda el vino y tu valoración.
   - 💬 Comentario — escribe tu nota de cata; se guarda con la valoración.
   - ✏️ Corregir — envía líneas tipo `region: Ribera del Duero` para
     ajustar campos antes de guardar.
   - 🚫 Cancelar — descarta la foto sin guardar.

Si algún dato no sale en la foto, lo puedes completar después en la web.

### Buscar vinos

Lenguaje natural. El bot devuelve un enlace a tu colección con los filtros
ya aplicados. Ejemplos: "mis tintos", "mencías pendientes", "blancos de
Rueda que me gustaron", "espumosos".

### Recomendaciones

`/descubrir` o frases tipo "qué me recomiendas". El bot responde con
"Apuestas seguras" (vinos parecidos a los que te gustan) y "Aventuras"
(vinos distintos), cada uno con enlace directo, más enlace a la página
completa de Descubrir.

### Límites

- Máximo 20 mensajes cada 5 minutos por usuario.
- Solo usuarios aprobados en Cóxegas pueden vincularse.

---

## Privacidad (resumen)

Cóxegas no almacena tu ubicación geográfica en el servidor. Los datos
enviados a IA son anónimos (resumen de gustos, sin nombre ni email). El
proveedor de IA actual es Mistral AI (Francia, GDPR). Puedes desactivar
todas las funcionalidades de IA desde tu perfil. Política completa:
https://coxegas.app/privacidad?utm_source=llms-txt

## Enlaces canónicos

- Sitio: https://coxegas.app/?utm_source=llms-txt
- Sitemap XML: https://coxegas.app/sitemap.xml
- llms.txt corto: https://coxegas.app/llms.txt