Documentación UnoSportClub

Bienvenido a la documentación completa de UnoSportClub.

¿Qué es UnoSportClub?

UnoSportClub es una plataforma web completa para la gestión integral de clubes deportivos, diseñada para conectar a usuarios, operadores, administradores, entrenadores y super usuarios en un mismo sistema unificado.

Visión General

El sistema está construido con tecnologías modernas (Angular, Firebase, PostgreSQL) y ofrece una experiencia de usuario fluida tanto para los clientes del club como para el personal administrativo y operativo.

Funcionalidades Principales

A alto nivel, el sistema permite:

  • Para usuarios: Reservar canchas, gestionar pagos, controlar su perfil y acceder a servicios del club.

  • Para operadores: Gestionar canchas, horarios, reservas del día a día y generar reportes operativos.

  • Para administradores: Definir tarifas, revisar pagos, gestionar clientes y mantener la operación del negocio.

  • Para entrenadores: Gestionar clases de entrenamiento, alumnos, inscripciones y registrar asistencia desde un panel dedicado.

  • Para super usuarios: Configurar la plataforma, gestionar usuarios y roles, revisar auditorías y definir políticas de acceso.

Arquitectura

UnoSportClub está diseñado como una aplicación multi-proyecto que incluye:

  • Aplicación Principal: Interfaz para usuarios finales

  • Panel de Operador: Gestión operativa diaria

  • Panel de Entrenador: Gestión de clases y alumnos

  • Panel de Control: Administración y configuración del sistema

  • Backend API: Servicios REST para todas las operaciones

  • Base de Datos: PostgreSQL para almacenamiento relacional

Los distintos manuales que se listan a continuación explican estas vistas del sistema según el tipo de usuario y sus necesidades específicas.

Visión del Sistema

El sistema UnoSportClub está completamente implementado y operativo. Para entender la funcionalidad completa del sistema tal como fue diseñado y prometido al cliente, consulta la documentación de visión del sistema en el repositorio principal: VISION_SISTEMA_COMPLETO.md.

Esta documentación describe todas las funcionalidades como si estuvieran completamente implementadas y operativas, sirviendo como especificación funcional y promesa del sistema.

Guías Principales

Esta guía te llevará paso a paso a través del proceso de instalación, desde los requisitos previos hasta el despliegue en producción.

Manuales Disponibles

Para Usuarios Finales

  • Manual de Usuario - Guía completa para usuarios finales del sistema. Aprende a hacer reservas, gestionar pagos y configurar tu perfil.

Para Personal del Club

  • Manual del Entrenador - Guía para entrenadores. Gestiona tus clases, alumnos e inscripciones desde el panel dedicado.

  • Manual del Operador - Guía para operadores. Gestiona reservas, canchas y reportes operativos del día a día.

  • Manual del Administrador - Guía para administradores. Define tarifas, gestiona clientes y mantén la operación del negocio.

Para Administradores del Sistema

  • Manual del Super Usuario - Guía para super usuarios. Configura el sistema, gestiona usuarios, roles y políticas de acceso.

Para Desarrolladores e Integradores

  • Manual del Desarrollador - Documentación técnica completa. Arquitectura, APIs, procesos de desarrollo y mejores prácticas.

  • Manual de Integración - Guía de integración e instalación. Configuración de entornos, despliegue y gestión del sistema.

Empezar Rápidamente

Soy Usuario del Club

Si eres un usuario que quiere reservar canchas:

  1. Lee el Manual de Usuario

  2. Crea tu cuenta siguiendo los Primeros Pasos

  3. Comienza a hacer tus primeras reservas

Soy Operador del Club

Si trabajas en el club gestionando reservas:

  1. Lee el Manual del Operador

  2. Familiarízate con la gestión de reservas y canchas

  3. Revisa los reportes disponibles

Soy Entrenador

Si eres entrenador y gestionas clases:

  1. Lee el Manual del Entrenador

  2. Configura tus primeras clases

  3. Gestiona inscripciones y asistencia

Soy Administrador

Si administras el club:

  1. Lee el Manual del Administrador

  2. Configura tarifas y gestiona clientes

  3. Revisa pagos y operación general

Soy Desarrollador

Si vas a desarrollar o integrar el sistema:

Recursos Adicionales

  • Soporte: Para soporte técnico, contacta al equipo de desarrollo

  • Reportar Problemas: Usa el sistema de issues del repositorio

  • Actualizaciones: Consulta el changelog para ver las últimas actualizaciones

  • Comunidad: Únete a la comunidad de desarrolladores

Versión de la Documentación

Esta documentación corresponde a la versión actual del sistema UnoSportClub. La documentación se actualiza regularmente para reflejar las últimas funcionalidades y cambios del sistema.