Control económico de clubes
Aplicación para gestionar contabilidad, nóminas, movimientos bancarios, subvenciones y conciliación por club. Está construida con Next.js, React, TypeScript y Supabase.
Funcionalidad
- Autenticación y selección de club activo.
- Separación de datos por club mediante permisos y políticas RLS.
- Contabilidad con filtros, exportaciones, documentos y edición tipo Excel.
- Nóminas con importación de costes, informes PDF y resumen mensual.
- Banco con importación Excel, búsqueda global y asignación masiva.
- Conciliación bancaria manual 1 a 1.
- Gestión de personal, proveedores, programas, conceptos, miembros y roles.
- Seguimiento de la ejecución de subvenciones.
Flujos principales
Contabilidad
El listado se muestra en modo lectura de forma predeterminada. El botón Modo edición (Excel) activa la edición directa de las filas.
Cada asiento puede abrirse en un panel lateral. Desde el panel se puede:
- Guardar el asiento.
- Duplicarlo y abrir la copia para editar.
- Arrastrar y soltar documentos, o seleccionarlos pulsando la zona de carga.
- Descargar o eliminar documentos.
- Eliminar el asiento y sus documentos.
Los documentos admitidos son PDF, JPG y PNG, con un máximo de 1 MB por archivo.
Banco
El buscador global filtra sobre fechas, texto, referencias, importes, saldo, orden, programa y concepto. No distingue mayúsculas ni acentos y admite varias palabras.
La asignación masiva permite:
- Activar el modo de asignación.
- Marcar filas individualmente o seleccionar todas las visibles desde la cabecera.
- Elegir cualquier campo bancario permitido.
- Asignar el nuevo valor a los movimientos seleccionados.
Desde el panel de edición se puede guardar y duplicar un movimiento. El original y la copia quedan enlazados mediante referencia_1, y ambos muestran una etiqueta Duplicado bajo la fecha.
Nóminas
El resumen mensual trabaja sobre las nóminas filtradas. Todas sus cabeceras son ordenables y la fila final muestra los totales de nóminas, bruto, coste empresarial, Seguridad Social, total e imputado.
Ejecución de subvenciones
Al filtrar por un programa concreto en Contabilidad, Banco o Nóminas se muestra:
- Subvención concedida.
- Ingresos bancarios.
- Importe ejecutado.
- Importe pendiente.
- Porcentaje de ejecución.
- Fecha límite.
Tecnologías
- Next.js 16
- React 19
- TypeScript
- Supabase Auth, PostgreSQL y Storage
- ESLint
Desarrollo
npm install
npm run dev
Variables requeridas en .env.local:
NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
No debe subirse .env.local al repositorio.
Mantener activo Supabase
El workflow .github/workflows/supabase-keep-alive.yml realiza una consulta de
solo lectura a Supabase cada 12 horas y también se puede ejecutar manualmente.
Para activarlo, crea estos secretos en GitHub desde Settings > Secrets and
variables > Actions > New repository secret:
SUPABASE_URL: el mismo valor que NEXT_PUBLIC_SUPABASE_URL.SUPABASE_ANON_KEY: el mismo valor que NEXT_PUBLIC_SUPABASE_ANON_KEY.
No uses SUPABASE_SERVICE_ROLE_KEY: el workflow solo necesita la clave pública
anon. Después, abre Actions > Supabase keep-alive > Run workflow para
probarlo. La ejecución debe terminar en verde.
Aviso: GitHub desactiva los workflows programados de repositorios públicos
tras 60 días sin actividad en el repositorio. Si ocurre, vuelve a habilitarlo
desde Actions; este límite no se aplica del mismo modo a repositorios
privados.
Verificación
npm run lint
npm run build
Tipos de Supabase
Para generar los tipos TypeScript desde el proyecto remoto:
$env:SUPABASE_ACCESS_TOKEN="tu-token"
npm run supabase:types
El resultado se genera en src/lib/supabase/database.types.ts. El token debe mantenerse únicamente como variable de entorno local.
Base de datos
Las migraciones y auditorías están en database/. El estado y los pendientes de normalización se describen en database/NORMALIZATION.md.
Historial
Las entregas funcionales relevantes se documentan en CHANGELOG.md.
