Pesca Asturias — Repositorio
Nombre provisional del proyecto. Plataforma de información, comunidad y actividad pesquera para el Principado de Asturias, preparada para expandirse a otras comunidades autónomas.
Este README describe el repositorio. La documentación de producto vive en docs/ y las referencias visuales en imagenes/. El plan de ejecución completo está en docs/14_PLAN_MAESTRO_EJECUCION.md.
Estructura
docs/ documentación funcional y técnica de producto (numerada, 00-14)
imagenes/ referencias visuales de la línea estética esperada
governance/ gobierno del proyecto: convenciones, entornos, checklist, ADRs
src/ aplicación Next.js (App Router, TypeScript, Tailwind)
supabase/ migraciones, seed y configuración de la base de datos (PostgreSQL/PostGIS)
Base de datos
El proyecto usa Supabase, con un proyecto de desarrollo real vinculado (supabase link) además del stack local para pruebas seguras antes de tocar el remoto.
supabase start # levanta Postgres/PostGIS, Auth, Storage y Studio en local
supabase db reset # aplica migraciones + seed de desarrollo desde cero, en local
supabase stop # detiene el stack local
supabase db push # aplica migraciones pendientes al proyecto de desarrollo vinculado
supabase db push --include-seed # además aplica supabase/seed.sql al remoto
Las migraciones viven en supabase/migrations/, numeradas y aplicadas en orden. El seed de desarrollo (supabase/seed.sql) carga datos de prueba, nunca el catálogo real. Antes de aplicar una migración nueva al proyecto de desarrollo real, validarla primero contra el stack local.
Variables de entorno (frontend)
Copiar .env.example a .env.local (nunca versionado) y rellenar:
NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY: del proyecto Supabase de desarrollo.NEXT_PUBLIC_MAPTILER_API_KEY: clave pública de MapTiler, usada por MapLibre GL para las teselas del mapa. Restringir por dominio en entornos desplegados.
Antes de trabajar en cualquier fase
- Leer
docs/14_PLAN_MAESTRO_EJECUCION.md para identificar el alcance exacto de la fase.
- Leer
governance/00_GOBIERNO_DEL_PROYECTO.md para las convenciones vigentes.
- Revisar
governance/01_CHECKLIST_SEGURIDAD_Y_PRIVACIDAD.md antes de cerrar la fase.
- Registrar cualquier decisión relevante como ADR en
governance/adr/.
Principios irrenunciables
- Toda la aplicación y documentación se mantiene en español de España.
- El contenido público principal (mapa, zonas, normativa, condiciones, valoraciones) es gratuito.
- Las acciones sociales (comentar, valorar, subir fotos, registrar capturas, check-in) requieren autenticación.
- Nunca se publica la posición GPS exacta de un pescador; solo actividad agregada por zona.
- No existe tracking continuo de usuarios.
