MIVA, una escuela de fútbol formativo, busca un desarrollador Full-Stack para llevar su MVP a una versión operativa y lista para producción. El objetivo principal es digitalizar los procesos comerciales y académicos, incluyendo la captación de leads, la agenda de pruebas, las fichas de alumnos, el control de asistencia, la generación de reportes y el seguimiento de KPIs.
Avances ya realizados:
- Mockups de pantallas principales para leads, agenda, fichas, reportes y KPIs.
- Backend desarrollado con FastAPI, incluyendo endpoints básicos para leads (listar, crear, mover, editar).
- Autenticación JWT ya configurada.
- Base de datos PostgreSQL con esquema (
schema.sql) y datos iniciales (
seed.sql).
- Configuración de Docker Compose con servicios para la base de datos, API, frontend y Adminer.
- Frontend desarrollado con
Next.js, conectado al backend para funcionalidades de login y gestión de leads.
Trabajo pendiente:
Backend:
- Implementar los endpoints restantes para Trials, Alumnos, Ficha Inicial, Reportes Mensuales, Asistencias y KPIs.
- Añadir migraciones de base de datos utilizando Alembic.
- Desarrollar un middleware robusto para la gestión de roles y permisos (admin, gestor, profesor, marketing).
- Implementar logging y validaciones de datos avanzadas.
Frontend:
- Conectar todas las vistas de los mockups existentes a los endpoints reales del backend.
- Desarrollar formularios completos con validaciones de datos para todas las secciones.
- Crear un dashboard interactivo de KPIs con gráficas.
- Implementar el manejo completo de la sesión de usuario (login, logout, refresh de tokens).
- Asegurar que el diseño sea completamente responsive para diferentes dispositivos.
Infraestructura:
- Preparar el despliegue de la aplicación en plataformas como Railway, Render, Heroku o un VPS.
- Configurar HTTPS para asegurar la comunicación y establecer un sistema de backups para la base de datos.
- Documentar el proceso de instalación y el flujo de desarrollo, incluyendo el uso de un Makefile.
Integraciones (fase siguiente, pero a considerar en la arquitectura):
- Integración con Meta/Facebook/Instagram Leads para la ingesta automática de datos en el embudo.
- Conexión con WhatsApp Business API para el envío de recordatorios a los padres.
- Sincronización con Google Calendar para la gestión de pruebas y entrenamientos.
Entregables esperados:
- Un repositorio de código completo que incluya el backend y el frontend, totalmente conectado a la base de datos.
- Archivos de migraciones y seeds para la base de datos.
- Una colección Postman generada a partir de la especificación OpenAPI del backend.
- Una demo funcional de la plataforma en un entorno de staging.
- Documentación básica que cubra la configuración del proyecto, el proceso de despliegue y la descripción de los roles de usuario.
Plazo de Entrega: No definido