Skip to content

README.md

Latest commit

 

History

History
122 lines (93 loc) · 3.68 KB

README.md

File metadata and controls

122 lines (93 loc) · 3.68 KB
Raw

GolManager

Sistema de gestión para equipos de fútbol amateur con arquitectura multi-tenant.

Características

  • Multi-Tenant: Múltiples equipos/organizaciones con aislamiento completo de datos
  • Gestión de Jugadores: Roster con posiciones, estadísticas, fotos y contacto
  • Partidos: Programación, resultados, asistencia y alineaciones
  • Pagos: Control de cuotas mensuales, pagos de campeonatos y otros pagos
  • Importación Liga Hesperides: Análisis de capturas de pantalla con IA para importar datos
  • Panel de Administración: Gestión de organizaciones, usuarios y base de datos

Tecnologías

  • Frontend: React, TypeScript, Tailwind CSS, shadcn/ui
  • Backend: Node.js, Express, TypeScript
  • Base de Datos: PostgreSQL con Drizzle ORM
  • Autenticación: Email/password con sesiones seguras
  • Almacenamiento: Object Storage compatible con S3

Requisitos

  • Node.js 20+
  • PostgreSQL 14+
  • (Opcional) S3-compatible storage para archivos

Instalación Local

# Clonar repositorio
git clone https://github.com/tu-usuario/golmanager.git
cd golmanager

# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus valores

# Ejecutar migraciones
npm run db:push

# Iniciar servidor de desarrollo
npm run dev

Despliegue en VPS

Ver DEPLOY.md para instrucciones completas de despliegue con Docker.

Estructura del Proyecto

├── client/              # Frontend React
│   ├── src/
│   │   ├── components/  # Componentes reutilizables
│   │   ├── pages/       # Páginas de la aplicación
│   │   ├── hooks/       # Custom hooks
│   │   └── lib/         # Utilidades
├── server/              # Backend Express
│   ├── routes.ts        # API endpoints
│   ├── storage.ts       # Capa de acceso a datos
│   └── auth.ts          # Autenticación
├── shared/              # Código compartido
│   └── schema.ts        # Esquema de base de datos y tipos
└── docker-compose.yml   # Configuración Docker

API Endpoints

Autenticación

  • POST /api/auth/login - Iniciar sesión
  • POST /api/auth/register - Registrar usuario
  • POST /api/auth/logout - Cerrar sesión
  • GET /api/auth/me - Usuario actual

Jugadores

  • GET /api/players - Listar jugadores
  • POST /api/players - Crear jugador
  • PATCH /api/players/:id - Actualizar jugador
  • DELETE /api/players/:id - Eliminar jugador

Partidos

  • GET /api/matches - Listar partidos
  • POST /api/matches - Crear partido
  • PATCH /api/matches/:id - Actualizar partido
  • DELETE /api/matches/:id - Eliminar partido

Pagos

  • GET /api/monthly-payments - Pagos mensuales
  • GET /api/championship-payments - Pagos de campeonatos
  • GET /api/other-payments - Otros pagos

Administración

  • GET /api/admin/organizations - Listar organizaciones
  • GET /api/admin/database/stats - Estadísticas de BD
  • GET /api/admin/database/export - Exportar backup

Variables de Entorno

Variable Descripción
DATABASE_URL URL de conexión PostgreSQL
SESSION_SECRET Secreto para sesiones (generar con openssl rand -hex 32)
S3_ENDPOINT Endpoint de almacenamiento S3
S3_ACCESS_KEY Clave de acceso S3
S3_SECRET_KEY Clave secreta S3
S3_BUCKET Nombre del bucket

Contribuir

  1. Fork del repositorio
  2. Crear rama feature (git checkout -b feature/nueva-funcionalidad)
  3. Commit cambios (git commit -am 'Añadir nueva funcionalidad')
  4. Push a la rama (git push origin feature/nueva-funcionalidad)
  5. Crear Pull Request

Licencia

MIT - Ver LICENSE