Skip to content
ImaMultiDevPublic

About

Plataforma web para la promoción del rock navarro: bandas, conciertos, festivales y escena local.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Nafarrock

Guía del rock en Nafarroa

Plataforma de referencia de la escena punk rock, rock urbano y alternativa en Navarra y Euskadi.

Características • Stack • Instalación • Estructura • Documentación


Descripción

Nafarrock es una aplicación web completa para descubrir, gestionar y promocionar la escena musical alternativa de Navarra y el País Vasco. Conecta bandas, salas, promotores, organizadores y festivales en un único hub con registro por roles, aprobación de contenidos, panel de administración y soporte bilingüe (español / euskera).


Características

🌐 Experiencia pública

Sección Descripción
Inicio Portada con hero, buscador global y secciones destacadas
Bandas Listado paginado con filtros (género, localidad, emergentes), fichas con biografía, miembros, enlaces (Spotify, Bandcamp, redes)
Eventos Agenda de conciertos paginada con filtros por fecha y tipo
Entradas Eventos con enlace directo a venta de entradas
Salas Espacios y venues con descripción, mapa y galería
Escena Hub de promotores, organizadores y festivales con enlaces a sus listados
Bolos Anuncios de búsqueda de músicos (bolos) con sistema de solicitudes
Buscar Búsqueda global en bandas, eventos, salas, festivales, promotores y organizadores

🌍 Internacionalización

  • Español y Euskera con next-intl
  • Rutas localizadas (/es/bandas, /eu/bandas)
  • Traducción asistida por IA para biografías en euskera

🔐 Autenticación y roles

  • Login por email/contraseña
  • Registro con múltiples roles
  • Verificación de email (Resend)
  • Sesiones con NextAuth.js
Rol Acceso
USUARIO Perfil personal
BANDA Mi banda (editar perfil, logo, galería, miembros, géneros, enlaces)
SALA Mi sala + crear eventos en su espacio
PROMOTOR Mi promotor + crear eventos
ORGANIZADOR Mi organizador + crear eventos
FESTIVAL Mi festival + crear eventos
ADMIN Panel de administración completo

📋 Creación de eventos

  • Salas, promotores, organizadores y festivales pueden crear eventos
  • Selección de sala, bandas, precio, URL de entradas, cartel
  • Límite anti-spam: 1 evento cada 5 días por creador
  • Aprobación manual antes de publicar

⚙️ Panel de administración

Módulo Funcionalidades
Bandas Listar, aprobar, crear, editar, importar CSV, descubrir (Spotify/MusicBrainz)
Salas Listar, aprobar, crear, editar
Eventos Listar, aprobar, crear, editar, descubrir (Ticketmaster)
Promotores / Organizadores / Festivales Listar y aprobar
Asociaciones Listar y aprobar
Usuarios Ver usuarios, roles y entidades pendientes
Bolos Gestionar anuncios y solicitudes
Reclamaciones Perfiles reclamados por bandas
Solicitudes Acceso a la escena pendiente

🤖 Integraciones y automatización

Integración Uso
Spotify Autofill de bandas (nombre, imagen, enlaces)
MusicBrainz Búsqueda de artistas para autofill
Ticketmaster Discovery API Descubrir eventos en Navarra y Euskadi
Cloudinary Subida de imágenes (logos, galerías, carteles)
Resend Verificación de email
OpenAI Traducción de biografías al euskera

📄 Otros

  • Paginación en todos los listados
  • Reclamación de perfiles de banda por usuarios
  • Manuales de uso por perfil en docs/manuales/

Stack tecnológico

Capa Tecnología
Framework Next.js 15 (App Router, TypeScript)
Base de datos PostgreSQL
ORM Prisma
Auth NextAuth.js (Credentials + OAuth preparado)
i18n next-intl
Imágenes Cloudinary
Email Resend
Estilo Tailwind CSS
Animaciones Framer Motion
Validación Zod
Tests Vitest, Playwright

Instalación

1. Dependencias

cd apps/nafarrock
npm install

2. Variables de entorno

Copia .env.example a .env y completa:

cp .env.example .env
Variable Descripción
DATABASE_URL Conexión PostgreSQL (Railway, Supabase, local)
NEXTAUTH_URL http://localhost:3000 en desarrollo
NEXTAUTH_SECRET openssl rand -base64 32
ADMIN_EMAIL Email del admin (obligatorio para seed)
ADMIN_PASSWORD Contraseña del admin (obligatorio para seed)
RESEND_API_KEY Verificación de email
CLOUDINARY_* Cloud, upload preset, API key/secret
SPOTIFY_CLIENT_ID / SPOTIFY_CLIENT_SECRET Autofill de bandas
TICKETMASTER_API_KEY Descubrir eventos
OPENAI_API_KEY Traducción al euskera

3. Base de datos

npm run db:push
npm run db:seed

4. Ejecutar

npm run dev

Abre http://localhost:3000.


Despliegue en Vercel

El build ejecuta el seed automáticamente. Si cambias ADMIN_EMAIL o ADMIN_PASSWORD en Vercel:

  1. Haz un nuevo deploy (push o redeploy manual).
  2. El seed actualizará el admin en la base de datos.
  3. Inicia sesión con las nuevas credenciales.

Estructura del proyecto

src/
├── app/
│   ├── [locale]/           # Rutas públicas (es/eu)
│   │   ├── bandas/        # Listado y fichas
│   │   ├── eventos/       # Agenda
│   │   ├── entradas/      # Eventos con venta
│   │   ├── salas/         # Venues
│   │   ├── escena/        # Promotores, organizadores, festivales
│   │   ├── bolos/         # Anuncios de músicos
│   │   ├── buscar/        # Buscador global
│   │   └── auth/          # Login, registro, verificación
│   ├── admin/             # Panel administración
│   │   ├── bandas/        # CRUD, descubrir, importar
│   │   ├── eventos/       # CRUD, descubrir
│   │   ├── salas/         # CRUD
│   │   └── ...
│   ├── dashboard/         # Panel por rol (banda, sala, promotor...)
│   └── api/               # Rutas API
├── components/            # UI reutilizables
├── lib/                   # Prisma, Auth, Ticketmaster, etc.
├── services/              # Lógica de negocio
└── i18n/                  # Configuración next-intl

docs/
└── manuales/              # Manuales por perfil

Scripts

Comando Descripción
npm run dev Desarrollo
npm run build Build producción
npm run start Servidor producción
npm run db:push Sincronizar schema con DB
npm run db:migrate Crear migración
npm run db:seed Ejecutar seed
npm run db:studio Prisma Studio
npm run lint ESLint
npm run test Tests unitarios (Vitest)
npm run test:e2e Tests E2E (Playwright)

Documentación

Documento Descripción
docs/manuales/MANUAL_USUARIO.md Usuario básico
docs/manuales/MANUAL_BANDA.md Perfil banda
docs/manuales/MANUAL_SALA.md Perfil sala
docs/manuales/MANUAL_PROMOTOR.md Perfil promotor
docs/manuales/MANUAL_ORGANIZADOR.md Perfil organizador
docs/manuales/MANUAL_FESTIVAL.md Perfil festival
docs/manuales/MANUAL_ADMIN.md Panel administración

Roles y aprobación

Rol Requiere aprobación Puede crear eventos
USUARIO — No
BANDA Sí (perfil) No
SALA Sí (perfil) Sí (solo en su sala)
PROMOTOR Sí (perfil) Sí
ORGANIZADOR Sí (perfil) Sí
FESTIVAL Sí (perfil) Sí
ADMIN — Sí (y aprobar todo)

Licencia

Proyecto privado — Nafarrock.

About

Plataforma web para la promoción del rock navarro: bandas, conciertos, festivales y escena local.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages