06 1 contexto y alcance - lfnavarroj1/sport-app-platform GitHub Wiki

Contexto y alcance

Problema que atiende SportApp

SportApp apoya la salud, el bienestar, el entrenamiento, la alimentación y la participación en eventos deportivos de personas no profesionales en Latinoamérica. También permite que organizadores y proveedores publiquen y administren eventos o servicios complementarios.

La solución responde principalmente a:

  • personalizar entrenamiento y alimentación según características demográficas, fisiológicas y culturales;
  • registrar prácticas deportivas e indicadores de rendimiento;
  • planear y operar eventos deportivos masivos;
  • conectar servicios profesionales e integraciones externas sin acoplarlas a los clientes.

Actores

Actor Objetivo principal
Deportista no profesional Gestionar perfil, planes, sesiones, alimentación, eventos, indicadores, afiliación y servicios.
Organizador de eventos Crear, publicar, tarifar y administrar eventos e inscritos.
Profesional o empresa de servicios Publicar servicios, disponibilidad, planes y tarifas.
Administrador de SportApp Gestionar acceso, terceros, contratos y operación de la plataforma.
Dispositivo de medición Enviar métricas durante una sesión deportiva.
Strava Intercambiar actividades mediante una API externa.

Diagrama de contexto

flowchart LR
    ATH[Deportista]
    ORG[Organizador de eventos]
    PRO[Proveedor de servicios]
    ADM[Administrador]
    DEV[Dispositivo de medición]
    WEB[Aplicación web SportApp]
    MOB[Aplicación móvil SportApp]
    SYS[Sistema SportApp]
    STR[API de Strava]
    TP["TrainingPeaks<br/>no confirmado"]

    ATH --> WEB
    ATH --> MOB
    ORG --> WEB
    PRO --> WEB
    ADM --> WEB
    DEV --> MOB
    WEB --> SYS
    MOB --> SYS
    SYS <--> STR
    SYS -. fuera de la línea base .-> TP
Loading

Capacidades por dominio

Dominio Capacidades principales
Usuarios Registro, autenticación, perfil, datos demográficos y fisiológicos, hábitos y permisos.
Afiliación Planes, suscripciones y estado de cuenta funcional.
Entrenamientos y alimentación Planes, sesiones, historial, indicadores, recomendaciones y monitoreo.
Eventos masivos Creación, publicación, tarifas, calendario, inscripción y consulta de participantes.
Servicios complementarios Proveedores, catálogo, disponibilidad, contratación y tarifas.
Terceros Vinculación con Strava y transformación del modelo externo.
Notificaciones Hidratación, alimentación, motivación, riesgos y cambios de eventos.

Alcance de la primera solución

El MVP debe demostrar como mínimo registro de usuarios, selección de afiliación, servicios de terceros, plan y calendario de entrenamiento, inicio y fin de una sesión móvil, integración cliente–BFF–servicios, backend y persistencia en la nube y evidencia de atributos de calidad.

No se consideran confirmados para la primera solución TrainingPeaks, MongoDB, caché distribuida, sharding, operación productiva continua ni SLO demostrados.

Volver a Arquitectura de la solución

⚠️ **GitHub.com Fallback** ⚠️