INVICTA
Plataforma de gestión y descubrimiento de torneos de fútbol amateur.
Documentación
La fuente de verdad del producto vive en docs/:
Ante cualquier duda sobre una regla de negocio, manda docs/documentacion/06-reglas-negocio-y-decisiones-pendientes.md.
Stack
Next.js (TypeScript, App Router) + PostgreSQL, monolito con una capa de servicios separada de la interfaz — un servicio por caso de uso, agrupados por dominio (docs/documentacion/10-especificacion-tecnica.md, sección 2.1).
src/
services/ un archivo por caso de uso, en carpetas por dominio — nunca importa de app/
db/ cliente de base de datos
lib/ contexto, firma de servicio, utilidades
app/ rutas de Next.js — la única capa que puede importar servicios
db/migrations/ migraciones versionadas (node-pg-migrate)
Desarrollo
cp .env.example .env # completar DATABASE_URL (Postgres local o Supabase)
npm install
npm run migrate:up # aplica el esquema
npm run dev
Comandos útiles:
npm run verify — formato, lint, tipos, tests unitarios y tests de integración en un solo paso.npm test — solo los tests unitarios (mockean la base; no necesitan Postgres levantado).npm run test:integracion — la suite de integración: recrea una base de pruebas efímera (<nombre-de-tu-base>_test), le aplica todas las migraciones y corre contra ella de verdad — nunca contra la base de desarrollo. El rol de DATABASE_URL necesita permiso CREATEDB para poder crearla y borrarla (ALTER ROLE <rol> CREATEDB;, una sola vez).npm run migrate:create -- nombre — crea una migración nueva.npm run migrate:up / migrate:down — aplica / revierte migraciones.
