Armador de Equipos

Aplicación web para organizar partidos y armar equipos de forma sencilla. Permite gestionar usuarios, crear partidos, registrar jugadores, cargar resultados y visualizar estadísticas básicas.

Índice

• Tecnologías principales
  • Frontend
  • Backend
• Funcionalidades
• Estructura del proyecto
• Scripts desde la raíz
• Contribuciones
• Futuras mejoras

Tecnologías principales

Frontend

• React.js
• Vite
• Tailwind CSS

Backend

• Node.js
• MongoDB

Funcionalidades

• Creación de equipos balanceados por habilidad
• Autenticación de usuarios
• Almacenamiento de partidos
• Carga de resultados y detalles
• Visualización de estadísticas

Estructura del proyecto

/backend
  /src
    /error
    /config
    /models
    /routes
    /services
    /middleware
    /controllers
    /repositories

/frontend
  /public
  /src
    /css
    /hooks
    /utils
    /pages
    /routes
    /context
    /components

Scripts desde la raíz

Desde la raíz se pueden correr los mismos comandos en backend y frontend:

npm run install:all   # instala dependencias de ambos
npm run all           # format + lint:fix en ambos
npm run lint          # lint en ambos
npm run lint:fix
npm run format
npm run build
npm run dev:backend   # levanta solo el backend
npm run dev:frontend  # levanta solo el frontend

Contribuciones

Este proyecto está en desarrollo activo y cualquier ayuda para mejorarlo es altamente valorada, ya sea en forma de código, ideas, documentación o reportes de errores.

Cómo contribuir

1. Forkeá el repositorio

2. Creá una rama

Trabajá siempre sobre una rama descriptiva:

git switch -c nueva-funcionalidad

3. Implementá tus cambios

4. Hacé commit y abrí un Pull Request: Explicá qué problema resuelve o qué funcionalidad agrega tu PR.

Qué se puede contribuir

• Nuevas funcionalidades (ver sección Futuras mejoras)
• Mejoras de UI/UX
• Corrección de bugs
• Documentación (README, comentarios, ejemplos de uso)
• Lo que sea viene bien

Futuras mejoras

• Agrupar partidos en colecciones ("futbol de los lunes")
• Sección armador de fixture (liga/torneo)
• Compartir partidos para que tus amigos no tengan que escribirlos a mano
• Goles de cada jugador