# Cartelera Musicales - Guía de Proyecto e IA

> La cartelera de musicales más completa de España.
> Web: https://www.carteleramusicales.es

## Stack Técnico
- **Framework:** Laravel 11.
- **Frontend:** Tailwind CSS 3 y Livewire.
- **Admin:** Filament PHP.
- **Media:** Spatie Media Library con conversiones automáticas a WebP (posters, teatros, perfiles).
- **SEO:** Generación dinámica de sitemaps basada en la vigencia de eventos.

## Arquitectura de Datos (Modelos)
- **Obra:** Modelo central con metadatos artísticos, valoraciones y críticas. Posee relaciones con `Persona` y `Productora`.
- **Evento:** Instancia temporal de una obra. Si `gira = 1`, la ubicación real reside en el modelo `Gira`; si no, se vincula a un `Teatro`.
- **Geografía:** Jerarquía estricta `Provincia` -> `Localidad` -> `Teatro`.
- **Noticias:** Implementación polimórfica (`noticiable`) vinculada a Obras, Teatros, Localidades y Productoras.
- **Estadísticas:** Seguimiento de popularidad mediante el modelo `Visitamensual`.

## Reglas de Negocio Críticas
- **Visibilidad:** Filtrar siempre por el campo `visible` (boolean) en todas las consultas del frontend.
- **Criterio "En Cartel":** Una obra se considera activa si tiene eventos asociados con `fecha_final >= hoy` o marcados como `proximamente`.
- **Gestión de Giras:** Los eventos tipo gira requieren consultar la tabla `giras` para determinar la localidad específica.
- **Usuarios:** Gestión de roles (`es_admin`) y listas personales (vistos, favoritos, deseos).

## Recursos y Sitemaps de Referencia
- **Obras:** https://www.carteleramusicales.es/sitemap-obras.xml
- **Teatros:** https://www.carteleramusicales.es/sitemap-teatros.xml
- **Perfiles:** https://www.carteleramusicales.es/sitemap-perfiles.xml
- **Provincias:** https://www.carteleramusicales.es/sitemap-provincias.xml