{"openapi":"3.0.3","info":{"title":"BRAIN AWAKE — Cerebro API","version":"1.0.0","description":"API central de BRAIN AWAKE. Consume proveedores educativos externos y expone datos normalizados para Flutter, paneles administrativos y futuras plataformas."},"servers":[{"url":"/api/v1"}],"tags":[{"name":"Sistema"},{"name":"Autenticación"},{"name":"Proveedores"},{"name":"Planes"},{"name":"Suscripciones"},{"name":"Datos"},{"name":"Administración"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"string"},"code":{"type":"string"}}},"User":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"nombres":{"type":"string"},"es_admin":{"type":"boolean"},"is_premium":{"type":"boolean"},"premium_until":{"type":"string","nullable":true}}}}},"paths":{"/health":{"get":{"summary":"Estado del servicio","tags":["Sistema"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/auth/register":{"post":{"summary":"Registro de usuario central","tags":["Autenticación"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/auth/login":{"post":{"summary":"Login central","tags":["Autenticación"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/auth/refresh":{"post":{"summary":"Renovar access token","tags":["Autenticación"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/auth/logout":{"post":{"summary":"Cerrar sesión","tags":["Autenticación"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/auth/me":{"get":{"summary":"Perfil central, suscripción y proveedores","tags":["Autenticación"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/providers":{"get":{"summary":"Proveedores disponibles y vinculación","tags":["Proveedores"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/providers/links":{"get":{"summary":"Vinculaciones del usuario","tags":["Proveedores"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/providers/link":{"post":{"summary":"Vincular usuario con proveedor externo","tags":["Proveedores"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/providers/unlink/{id}":{"delete":{"summary":"Desvincular proveedor","tags":["Proveedores"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/providers/sync/{id}":{"post":{"summary":"Sincronizar un proveedor","tags":["Proveedores"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/plans":{"get":{"summary":"Planes disponibles","tags":["Planes"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/plans/{id}":{"get":{"summary":"Detalle de plan","tags":["Planes"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/subscriptions/me":{"get":{"summary":"Suscripción activa","tags":["Suscripciones"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/subscriptions/subscribe":{"post":{"summary":"Adquirir plan","tags":["Suscripciones"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/subscriptions/cancel":{"post":{"summary":"Cancelar suscripción","tags":["Suscripciones"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/subscriptions/history":{"get":{"summary":"Historial de suscripciones","tags":["Suscripciones"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/schedule":{"get":{"summary":"Horario normalizado","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/tasks":{"get":{"summary":"Tareas normalizadas","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/alarms":{"get":{"summary":"Alarmas normalizadas","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/planning":{"get":{"summary":"Planificación cruda del proveedor","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/agenda":{"get":{"summary":"Agenda consumible por la app","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/stats":{"get":{"summary":"Estadísticas locales","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/data/sync":{"post":{"summary":"Forzar sincronización","tags":["Datos"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/users":{"get":{"summary":"Listado de usuarios","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"post":{"summary":"Crear usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/users/{id}":{"get":{"summary":"Detalle de usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"put":{"summary":"Actualizar usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/users/{id}/subscriptions":{"get":{"summary":"Suscripciones de usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"post":{"summary":"Asignar plan a usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/users/{id}/providers":{"get":{"summary":"Proveedores de usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/stats/overview":{"get":{"summary":"KPIs globales","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/stats/users":{"get":{"summary":"Usuarios por fecha","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/stats/subscriptions":{"get":{"summary":"Suscripciones por plan","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/stats/revenue":{"get":{"summary":"Ingresos por mes","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/users/{id}/subscriptions/cancel":{"post":{"summary":"Cancelar suscripción de usuario","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/providers":{"get":{"summary":"Listar proveedores (admin)","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"post":{"summary":"Crear proveedor","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/providers/{id}":{"put":{"summary":"Actualizar proveedor","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"delete":{"summary":"Deshabilitar o eliminar proveedor","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/providers/{id}/toggle":{"post":{"summary":"Activar/desactivar proveedor","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/plans":{"get":{"summary":"Listar planes (admin)","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"post":{"summary":"Crear plan","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/plans/{id}":{"put":{"summary":"Actualizar plan","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}},"delete":{"summary":"Desactivar plan","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/subscriptions":{"get":{"summary":"Listar suscripciones","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}},"/admin/audit":{"get":{"summary":"Auditoría reciente","tags":["Administración"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Solicitud inválida"},"401":{"description":"No autorizado"}}}}}}