# Ranking de Alfajores - LLM Info

> Ranking de Alfajores (https://alfajor.com.ar) es la plataforma comunitaria líder en Argentina para calificar, reseñar y descubrir los mejores alfajores del país.

## Documentación Completa para LLMs
Para una especificación detallada del algoritmo Bayesiano, estructura de datos y catálogo completo, consultar:
- **LLM Specification Extended:** https://alfajor.com.ar/llms-full.txt

## Soporte para Agentes de IA
- **Format negotiation:** Realizar cualquier petición HTTP a nuestras URLs añadiendo el encabezado `Accept: text/markdown` para obtener la respuesta limpia en formato Markdown sin HTML.
- **Acceso a API Pública:** `https://alfajor.com.ar/api/alfajores` y `https://alfajor.com.ar/api/brands/all`.
- **Precio e historial de precios:** `https://alfajor.com.ar/api/alfajores/:id/price-history?granularity=month` devuelve la serie histórica de precio promedio reportado por la comunidad para un alfajor (parámetros `granularity`: day/week/month, `since`: fecha ISO opcional). La ficha de cada alfajor (`/alfajores/:id/:slug`) incluye el precio promedio actual y un resumen de la evolución del precio, tanto en HTML como en la respuesta Markdown.

## Estructura de la web
- `/ranking`: El top de los mejores alfajores de Argentina.
- `/ranking?categories=:slug`: Ranking filtrado dinámicamente por categoría (ej: `/ranking?categories=fruta`, `/ranking?categories=dulce-de-leche`).
- `/marcas`: Catálogo de marcas (Guaymallén, Havanna, Cachafaz, Jorgito, Balcarce, etc.).
- `/alfajores/:id/:slug`: Página de detalle del producto, puntajes, ingredientes, precio promedio, historial de precios y reseñas de usuarios.
- `/marcas/:id/:slug`: Catálogo de alfajores por marca y su puntuación media.
- `/tierlist`: Creador interactivo de tierlists de alfajores.
- `/informacion`: Centro de información -- índice de las secciones informativas y legales del sitio.
- `/perfil/:username/logros`: Logros e insignias desbloqueadas por el usuario.
- `/perfil/:username/progreso`: XP, nivel y progreso de gamificación del usuario.
- `/perfil/:username/deseados`: Lista pública de deseos.
- `/perfil/:username/lista-personal`: Lista pública de alfajores personales.

## Participación de usuarios

- Los usuarios autenticados pueden publicar, editar y eliminar sus reseñas.
- Cada reseña admite reacciones efectivas de apoyo o desacuerdo; cambiar una
  reacción no genera XP infinito.
- Las acciones válidas de participación pueden activar logros, XP y niveles.