Mush2 Docs

Appearance

Capability Catalog — Mush2 ​

Documento vivo: Catálogo oficial de capacidades, recursos, cuotas y políticas de la plataforma. Cada entrada sigue la clasificación definida en ADR-016.

Leyenda ​

SímboloSignificado
✅Implementado
🚧En desarrollo
📋Planeado

1. API ​

api.requests.per_month ​

CampoValor
TipoCuota
DescripciónLímite de llamadas API por período mensual por usuario
Costo operacionalMedio
EnforcementsubscriptionRateLimit.js — retorna 429 al exceder el límite
ResetAutomático al inicio de currentPeriodEnd
Estado✅
PlanLímite
FREE1,000 / mes
BASIC10,000 / mes
PREMIUM100,000 / mes

Disposición al cancelar: Se congela el contador. El acceso a la API se bloquea al final del período facturado.

api.keys ​

CampoValor
TipoCapacidad
DescripciónGeneración y gestión de API keys para integración programática
Costo operacionalBajo
Enforcementauth.js — autenticación dual JWT + API Key
Estado✅
PlanDisponible
FREE✅
BASIC✅
PREMIUM✅

api.rate_limit.minute ​

CampoValor
TipoCuota
DescripciónLímite de requests por minuto por API key
Costo operacionalBajo
Enforcementexpress-rate-limit global + por key vía ApiKey.rateLimit
Estado✅
PlanLímite por key
FREE100 / min
BASIC300 / min
PREMIUM1000 / min

2. Datos & Almacenamiento ​

data.retention.days ​

CampoValor
TipoCuota
DescripciónDías que se retienen telemetría, eventos, alarmas y audit logs por usuario
Costo operacionalAlto (almacenamiento en disco)
EnforcementdataRetentionJob.js — purge cada 60 minutos vía Subscription.dataRetentionDays
Estado✅
PlanRetención
FREE30 días
BASIC90 días
PREMIUM365 días

Disposición al cancelar: Todos los datos del usuario se purgan al final del período facturado. No hay período de gracia.

storage.telemetry.gb ​

CampoValor
TipoRecurso
DescripciónAlmacenamiento total de telemetría por usuario
Costo operacionalAlto
EnforcementNo implementado — actualmente limitado por data.retention.days
Estado📋
PlanLímite
FREE1 GB
BASIC10 GB
PREMIUM100 GB

3. Dispositivos ​

devices.max ​

CampoValor
TipoRecurso
DescripciónCantidad máxima de dispositivos IoT registrables por usuario
Costo operacionalMedio
EnforcementNo implementado — se valida en POST /devices contra Subscription
Estado📋
PlanLímite
FREE1 dispositivo
BASIC5 dispositivos
PREMIUMIlimitado

devices.users_per_device ​

CampoValor
TipoRecurso
DescripciónCantidad de usuarios con acceso compartido por dispositivo vía UserChamberAccess
Costo operacionalBajo
EnforcementNo implementado
Estado📋
PlanLímite
FREE1 (solo propietario)
BASIC3 usuarios
PREMIUM10 usuarios

devices.firmware.ota ​

CampoValor
TipoCapacidad
DescripciónActualización OTA del firmware del dispositivo desde la plataforma
Costo operacionalMedio (ancho de banda, almacenamiento de binarios)
EnforcementPor implementar en otaService.js
Estado📋
PlanDisponible
FREE❌
BASIC✅
PREMIUM✅

4. Automatización ​

automation.recipes ​

CampoValor
TipoCapacidad
DescripciónCreación y aplicación de recetas de cultivo con parámetros por fase
Costo operacionalBajo
EnforcementNo implementado — actualmente disponible para todos
Estado📋
PlanDisponible
FREE✅
BASIC✅
PREMIUM✅

automation.rules.active ​

CampoValor
TipoCuota
DescripciónCantidad de reglas de automatización personalizadas activas simultáneamente
Costo operacionalMedio (CPU de control engine)
EnforcementNo implementado
Estado📋
PlanLímite
FREE3 reglas
BASIC10 reglas
PREMIUMIlimitado

automation.cycles.concurrent ​

CampoValor
TipoCuota
DescripciónCiclos de cultivo activos concurrentes por usuario
Costo operacionalMedio (control engine evalúa cada ciclo cada 60s)
EnforcementNo implementado
Estado📋
PlanLímite
FREE1 ciclo
BASIC3 ciclos
PREMIUM10 ciclos

5. Calidad de Servicio (QoS) ​

qos.dashboard.refresh ​

CampoValor
TipoPolítica
DescripciónFrecuencia de actualización automática del dashboard
Costo operacionalMedio (requests, ancho de banda)
EnforcementUserPreference.refreshFrequency + validación contra plan
Estado📋
PlanFrecuencia
FREE30 segundos
BASIC10 segundos
PREMIUM1 segundo

qos.telemetry.streaming ​

CampoValor
TipoPolítica
DescripciónEntrega de telemetría en tiempo real vía WebSocket/SSE
Costo operacionalAlto (conexiones persistentes, ancho de banda)
EnforcementNo implementado — actualmente disponible para todos
Estado📋
PlanStreaming
FREEPolling cada 30s (sin WebSocket)
BASICWebSocket con datos cada 5s
PREMIUMWebSocket streaming continuo (< 1s)

6. Notificaciones ​

notifications.telegram ​

CampoValor
TipoCapacidad
DescripciónNotificaciones vía bot de Telegram para alarmas y eventos
Costo operacionalBajo
EnforcementTelegramDeviceConfig — disponible si el usuario vincula su chat
Estado✅
PlanDisponible
FREE✅ (solo CRITICAL y HIGH)
BASIC✅ (todas las severidades)
PREMIUM✅ (todas las severidades + alertas configurables)

notifications.push ​

CampoValor
TipoCapacidad
DescripciónNotificaciones push vía navegador (Web Push API)
Costo operacionalMedio (servicio de push)
EnforcementNo implementado
Estado📋
PlanDisponible
FREE❌
BASIC✅
PREMIUM✅

7. Analítica & Reportes ​

analytics.dashboard.custom ​

CampoValor
TipoCapacidad
DescripciónDashboards personalizables con widgets seleccionables
Costo operacionalBajo
EnforcementNo implementado
Estado📋
PlanDisponible
FREE❌ (dashboard fijo)
BASIC✅ (hasta 3 vistas)
PREMIUM✅ (vistas ilimitadas)

analytics.exports ​

CampoValor
TipoCapacidad
DescripciónExportación de datos (CSV, JSON, PDF)
Costo operacionalMedio (procesamiento, almacenamiento temporal)
EnforcementNo implementado
Estado📋
PlanDisponible
FREE❌
BASIC✅ (CSV, 1000 filas)
PREMIUM✅ (CSV, JSON, PDF — sin límite de filas)

analytics.predictions ​

CampoValor
TipoCapacidad
DescripciónPredicciones de comportamiento ambiental basadas en histórico (ML)
Costo operacionalAlto (cómputo, inferencia)
EnforcementNo implementado
Estado📋
PlanDisponible
FREE❌
BASIC❌
PREMIUM✅

8. Integraciones ​

integrations.mqtt.bridge ​

CampoValor
TipoCapacidad
DescripciónAcceso al bridge MQTT para integrar sistemas externos
Costo operacionalMedio (conexiones broker, mensajes)
EnforcementNo implementado — actualmente disponible para todos
Estado📋
PlanDisponible
FREE❌
BASIC✅ (solo lectura)
PREMIUM✅ (lectura y escritura)

integrations.webhooks ​

CampoValor
TipoCapacidad
DescripciónWebhooks salientes para eventos de la plataforma
Costo operacionalMedio (requests salientes, reintentos)
EnforcementNo implementado
Estado📋
PlanDisponible
FREE❌
BASIC✅ (hasta 2 webhooks)
PREMIUM✅ (hasta 10 webhooks)

integrations.thingspeak ​

CampoValor
TipoCapacidad
DescripciónSincronización bidireccional con ThingSpeak
Costo operacionalBajo
EnforcementDevice.thingSpeakEnabled + IntegrationCredentials
Estado✅
PlanDisponible
FREE✅
BASIC✅
PREMIUM✅

9. Organización ​

organization.users ​

CampoValor
TipoRecurso
DescripciónCantidad de usuarios miembros de una organización
Costo operacionalMedio (procesamiento de autenticación, autorización por tenant)
EnforcementNo implementado
Estado📋
PlanLímite
FREE1 usuario
BASIC3 usuarios
PREMIUM10 usuarios

10. Resumen por Plan ​

CapacidadFREEBASICPREMIUM
api.requests.per_month1,00010,000100,000
api.keys✅✅✅
api.rate_limit.minute100/min300/min1,000/min
data.retention.days3090365
storage.telemetry.gb 📋1 GB10 GB100 GB
devices.max 📋15Ilimitado
devices.users_per_device 📋1310
devices.firmware.ota 📋❌✅✅
automation.recipes 📋✅✅✅
automation.rules.active 📋310Ilimitado
automation.cycles.concurrent 📋1310
qos.dashboard.refresh 📋30s10s1s
qos.telemetry.streaming 📋Polling 30sWebSocket 5sStreaming <1s
notifications.telegram ✅CRITICAL/HIGHTodasTodas + config
notifications.push 📋❌✅✅
analytics.dashboard.custom 📋❌3 vistasIlimitado
analytics.exports 📋❌CSV 1000CSV/JSON/PDF
analytics.predictions 📋❌❌✅
integrations.mqtt.bridge 📋❌Solo lecturaFull
integrations.webhooks 📋❌2 webhooks10 webhooks
integrations.thingspeak ✅✅✅✅
organization.users 📋1310

Mush2 — Sistema IoT de control ambiental

MIT License