La API PlantCare Enterprise se basa en una arquitectura Nativa de la Nube y Sin Estado, diseñada para manejar cargas masivas de IoT con tiempo de inactividad cero.

1. Seguridad en el Borde (Edge) y Mediciones

Cada solicitud a nuestros puntos finales Enterprise es interceptada por un Middleware de Seguridad de alto rendimiento que aplica políticas de seguridad y cuotas de uso en el borde antes de que se ejecute cualquier lógica de negocio.

sequenceDiagram participant Client as "Cliente" participant Edge as "Middleware de Seguridad" participant DB as "Almacén de Cuotas/Auditoría" participant API as "Servicio de Análisis" Client->>Edge: "Solicitud (con Token API)" Edge->>Edge: "Validar Tamaño de Carga (<10MB)" Edge->>Edge: "Verificar Formato de Token (API2)" Edge->>DB: "Consultar Cuota y Rol (RBAC)" alt "Cuota Excedida" Edge-->>Client: "429 Demasiadas Solicitudes" else "Autorizado" Edge->>DB: "Registrar Pista de Auditoría" Edge->>API: "Reenviar Solicitud" API-->>Client: "Resultado del Análisis" end

2. Entrega de Webhooks Confiable

Nuestro sistema de webhooks está desacoplado del ciclo de vida de la solicitud principal mediante Google Cloud Pub/Sub. Esto garantiza que, incluso si su punto final no está disponible temporalmente, reintentaremos la entrega con un retroceso exponencial (exponential backoff).

sequenceDiagram participant API as "Servicio de Análisis" participant Topic as "Tema Pub/Sub" participant Worker as "Trabajador Webhook" participant Hub as "URL del Cliente" API->>Topic: "Publicar: análisis completado" API-->>API: "HTTP 202 Aceptado" Topic->>Worker: "Disparar: Nuevo Evento" Worker->>Worker: "Firmar Carga (HMAC-SHA256)" Worker->>Hub: "POST (con PlantCare-Signature)" alt "Punto Final Caído (5xx/4xx)" Hub-->>Worker: "Error" Worker->>Worker: "Reintentar con Retroceso Exponencial" else "Éxito (2xx)" Hub-->>Worker: "200 OK" end

3. Escalabilidad Sin Estado

El Servicio de Análisis es puramente sin estado (stateless). Esto permite que la plataforma pueda:

  • Auto-escalar: Maneje picos repentinos de tráfico generando cientos de instancias en segundos.
  • Auto-sanar: Si una instancia falla, otra toma su lugar de inmediato sin perder el estado de la sesión.
  • Alcance Global: Implemente código en múltiples regiones de GCP simultáneamente para un acceso de baja latencia.