📋 API Contract Index - MAS10 Backend

Índice centralizado de todos los Frontend Integration Packs disponibles.

Última actualización: 2025-02-02

---

🏗️ Arquitectura Multi-Backend

┌─────────────────────────────────────────────────────────────────────────────────┐
│                              MAS10 MOBILE APP                                    │
│                          (React Native / Flutter)                                │
└─────────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                           AWS API GATEWAY                                        │
│                      (Cognito JWT Authorization)                                 │
└─────────────────────────────────────────────────────────────────────────────────┘
          │              │              │              │              │
          ▼              ▼              ▼              ▼              ▼
    ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
    │ TORNEOS  │  │  PERFIL  │  │BACKOFFICE│  │  POSTS   │  │  OTROS   │
    │   API    │  │   API    │  │TOURNAMENT│  │   API    │  │  STACKS  │
    └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘
          │              │              │              │              │
          ▼              ▼              ▼              ▼              ▼
    ┌─────────────────────────────────────────────────────────────────────────────┐
    │                        AWS LAMBDA FUNCTIONS                                  │
    │                          (Python 3.9+)                                       │
    └─────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
    ┌─────────────────────────────────────────────────────────────────────────────┐
    │                    POSTGRESQL / DYNAMODB / S3                                │
    └─────────────────────────────────────────────────────────────────────────────┘

---

🔐 Autenticación Global

Componente	Valor
Provider	AWS Cognito
Token Type	Bearer JWT
Header	Authorization: Bearer <token>
Scope	aws.cognito.signin.user.admin

---

📦 Stacks Documentados

Stack	Carpeta Docs	Endpoints	Estado	Última Actualización
STACK_TORNEOS	docs/torneos/	36+	✅ Completo	2026-03-09
STACK_BACKOFFICE_TOURNAMENT	docs/backoffice-tournament/	11	✅ Completo	2025-02-02
STACK_BACKOFFICE	docs/backoffice/	1	✅ Completo	2026-03-10
STACK_PERFIL	docs/perfil/	17+	✅ Completo	2025-02-02
STACK_COLECTA	docs/colecta/	6	✅ Completo	2025-02-02
STACK_COMPLEXS	docs/complexs/	12	✅ Completo	2025-02-02
STACK_COMUNIDAD	docs/comunidad/	15+	✅ Completo	2025-02-02

---

📂 Estructura de Documentación por Stack

Cada stack documentado contiene:

docs/{stack-name}/
├── README_frontend.md          # Documentación principal
├── openapi.json                # OpenAPI 3.0 specification
├── postman_collection.json     # Colección Postman importable
└── examples/
    ├── curl_samples.sh         # Ejemplos cURL
    ├── requests_responses.json # Mock request/response
    └── ui_flows.md             # Mapeo UI → API

---

🎯 Acceso Rápido por Dominio

👤 Usuarios y Perfiles

Funcionalidad	Stack	Endpoint Principal
Gestión de perfil	STACK_PERFIL	/profile
Registro OAuth	STACK_PERFIL	/register
Idiomas	STACK_PERFIL	/languages
Ubicaciones	STACK_PERFIL	/location

⚽ Torneos y Partidos

Funcionalidad	Stack	Endpoint Principal
Listar torneos	STACK_TORNEOS	/tournament
Fixture/Partidos	STACK_TORNEOS	/match
Actualizar partido v2 ⚡	STACK_TORNEOS	/v2/match
Estadísticas	STACK_TORNEOS	/stats
Posiciones	STACK_TORNEOS	/positions
Goleadores	STACK_TORNEOS	/scorers

🏆 Backoffice Torneos

Funcionalidad	Stack	Endpoint Principal
Gestión ediciones	STACK_BACKOFFICE_TOURNAMENT	/edition
Categorías	STACK_BACKOFFICE_TOURNAMENT	/category
Equipos	STACK_BACKOFFICE_TOURNAMENT	/team
Jugadores	STACK_BACKOFFICE_TOURNAMENT	/players-link

📱 Social y Contenido

Funcionalidad	Stack	Endpoint Principal
Tips	STACK_PERFIL	/tips
Likes en notas	STACK_PERFIL	/like-note
Próximo partido	STACK_PERFIL	/next-play-by-user

💰 Colectas y Recaudación

Funcionalidad	Stack	Endpoint Principal
Listar/Detalle colectas	STACK_COLECTA	/fundraising
Crear/Editar colecta	STACK_COLECTA	/fundraising
Movimientos/Aportes	STACK_COLECTA	/fundraising/members/moviments

🏟️ Complejos Deportivos

Funcionalidad	Stack	Endpoint Principal
Buscar complejos	STACK_COMPLEXS	/complexs
Complejos de liga	STACK_COMPLEXS	/league-complexs
Complejos de torneo	STACK_COMPLEXS	/tournament-complexs
Complejos de fixture	STACK_COMPLEXS	/fixture-complexs
Formulario público	STACK_COMPLEXS	/form-complex

💬 Chat y Comunidad

Funcionalidad	Stack	Endpoint Principal
Canales/Grupos	STACK_COMUNIDAD	/channel
Miembros del canal	STACK_COMUNIDAD	/channel-membership
Unirse a canal	STACK_COMUNIDAD	/join-channel
Abandonar canal	STACK_COMUNIDAD	/leave-channel
Mensajes	STACK_COMUNIDAD	/message
Subir imágenes	STACK_COMUNIDAD	/chat-media
Notificaciones	STACK_COMUNIDAD	/screen-notification
Chat con agentes	STACK_COMUNIDAD	/channel (isAgent)

---

📊 Formato de Respuesta Estándar

Todos los endpoints siguen el mismo formato:

// Éxito
{
  "error": false,
  "data": { ... }
}

// Error
{
  "error": true,
  "error_msg": "Descripción del error"
}

---

🔗 URLs Base por Ambiente

Stack	Producción	Staging
STACK_TORNEOS	https://torneos.mas10.ar	https://torneos-stg.mas10.ar
STACK_PERFIL	https://perfil.mas10.ar	https://perfil-stg.mas10.ar
STACK_BACKOFFICE_TOURNAMENT	https://botournament.mas10.ar	https://botournament-stg.mas10.ar
STACK_COLECTA	https://colecta.mas10.ar	https://colecta-stg.mas10.ar
STACK_COMPLEXS	https://complexs.mas10.ar	https://complexs-stg.mas10.ar
STACK_COMUNIDAD	https://comunidad.mas10.ar	https://comunidad-stg.mas10.ar

---

📝 Cómo Agregar un Nuevo Stack

1. Usar el prompt en PROMPT_FRONTEND_INTEGRATION_PACK.md
2. Generar los 6 archivos del pack
3. Actualizar este índice agregando una fila en la tabla "Stacks Documentados"
4. Agregar entradas en "Acceso Rápido por Dominio" según corresponda

---

📞 Contacto

Para dudas sobre la documentación de APIs, contactar al equipo de Backend.