Recursos de la plataforma

Todo lo que gestionas en Mirox se organiza en tres recursos anidados — organización, portfolio y parque — que en conjunto definen qué puedes ver, quién puede acceder a ello y cómo se agrupan tus datos para la monitorización y los informes. Comprender esta jerarquía es la base para trabajar con la plataforma y sus APIs.

Organización

La organización es la entidad de nivel superior que representa a una entidad de negocio que utiliza la plataforma Mirox.

Características clave

• Entidad de negocio principal: Representa una empresa, institución u otra entidad de negocio
• Contenedor de usuarios: Contiene a los usuarios que pertenecen a la organización
• Propietaria de recursos: Posee los portfolios y los recursos subyacentes
• Entidad de facturación: Actúa como entidad para la facturación y la gestión de la cuenta
• Límite de permisos: Define el límite de permisos del nivel más alto

Estructura de la organización

Las organizaciones suelen tener los siguientes componentes:

• Miembros: Usuarios que pertenecen a la organización con diferentes roles y permisos
• Información: Datos de negocio como el nombre, la información de contacto y el tipo de negocio
• Ajustes: Ajustes y preferencias para toda la organización
• Socios de cooperación: Otras organizaciones con las que colabora la organización

Portfolio

Los portfolios son colecciones de parques gestionados como una unidad. Representan agrupaciones lógicas de activos de energía renovable.

Características clave

• Colección de activos: Agrupa varios parques con fines de gestión
• Unidad organizativa: Representa una unidad de negocio, un cliente o una región geográfica
• Nivel de permisos: Permite el control de acceso a nivel de portfolio
• Unidad de informes: Sirve de base para los informes agregados

Estructura del portfolio

Los portfolios suelen contener:

• Parques: Los parques solares individuales u otras instalaciones de energía renovable
• Contactos: Personas asociadas al portfolio que pueden recibir informes o notificaciones
• Ajustes: Ajustes y configuraciones para todo el portfolio
• Métricas de rendimiento: Datos agregados de todos los parques que contiene

Parque

Un parque representa una instalación individual de energía renovable, normalmente un parque solar.

Características clave

• Activo físico: Representa una instalación de energía renovable del mundo real
• Sujeto de monitorización: Entidad principal cuyo rendimiento se monitoriza
• Fuente de datos: Genera datos de series temporales sobre su funcionamiento
• Entidad geográfica: Tiene una ubicación específica y características físicas

Estructura del parque

Los parques suelen incluir:

• Componentes: Los componentes físicos de la instalación (inversores, strings, cajas de conexiones del generador, contadores, sensores de irradiación, loggers, dispositivos de red). La mayoría de los componentes se detectan automáticamente a partir de tus loggers y se sincronizan de forma automática — tú los sacas a la luz y los refinas en lugar de introducirlos a mano.
• Detalles técnicos: Especificaciones como la potencia instalada, el límite del inversor, la orientación y los objetivos mensuales de performance ratio.
• Información de ubicación: Coordenadas geográficas y dirección.
• Métricas de rendimiento: Datos operativos como la producción de energía, el rendimiento específico y los ratios de eficiencia.
• Eventos: Señales operativas detectadas por la máquina, como cortes de red, sobreproducción y cambios en la disponibilidad de fuentes.

Relaciones entre recursos

Estos recursos forman una estructura jerárquica:

1. Organización: La entidad de nivel superior

   • Contiene varios portfolios
   • Contiene miembros de la organización (usuarios)

2. Portfolio: La entidad de nivel intermedio

   • Pertenece a una organización
   • Contiene varios parques
   • Tiene contactos específicos del portfolio

3. Parque: La entidad operativa de nivel más bajo

   • Pertenece a un portfolio
   • Contiene varios componentes
   • Genera datos operativos y eventos

Identificadores de recursos

Todos los recursos de la plataforma Mirox se identifican mediante:

• UID: Una cadena hexadecimal única de 12 caracteres en mayúsculas (p. ej., "A1B2C3D4E5F6") que se asigna en el momento de la creación y no se puede modificar. Este identificador estático es esencial para la automatización mediante scripts y para una referencia coherente en toda la plataforma.
• Nombre: Un nombre legible para humanos con fines de visualización que los usuarios pueden cambiar.

Recursos de apoyo

Más allá de la jerarquía principal, unos cuantos recursos compartidos te ayudan a describir y documentar tus activos:

• Elementos de hoja de datos: Fichas técnicas reutilizables del fabricante para inversores, paneles solares y almacenamiento en baterías, cajas, módulos y celdas. Las mantienes una sola vez a nivel de organización y las vinculas a los componentes correspondientes de cualquier parque, de modo que las especificaciones de los equipos se mantengan coherentes en toda tu flota.
• Almacenamiento de documentos: Cada parque dispone de un explorador de archivos para guardar documentos de apoyo — informes de irradiación, contratos, hojas de datos, fotos y mucho más. Los archivos subidos se etiquetan automáticamente con la ayuda del Asistente de IA, lo que facilita encontrarlos más adelante.

Operaciones habituales

Operaciones de organización

• Gestión de usuarios (añadir/eliminar usuarios)
• Gestión de los ajustes de la organización
• Establecimiento de asociaciones de cooperación
• Gestión de los controles de acceso para toda la organización

Operaciones de portfolio

• Creación y gestión de parques
• Asignación de parques a portfolios
• Informes a nivel de portfolio
• Gestión de contactos del portfolio

Operaciones de parque

• Monitorización del rendimiento del parque
• Análisis de los eventos del parque
• Generación de informes del parque
• Gestión de los componentes del parque

Modelo de permisos

La jerarquía de recursos también define el modelo de permisos:

• Los permisos a nivel de organización conceden acceso a todos los portfolios y parques de la organización
• Los permisos a nivel de portfolio conceden acceso a todos los parques del portfolio
• Los permisos a nivel de parque conceden acceso únicamente a un parque específico

Este modelo de acceso jerárquico garantiza que los usuarios solo vean los recursos a los que deberían tener acceso. Los roles y las reglas de acceso de grano fino que se superponen a esta jerarquía se tratan en el Sistema de permisos.

Funciones relacionadas

• Sistema de permisos — roles y reglas de acceso en organizaciones, portfolios y parques
• Resumen de la planta — qué monitoriza cada parque y cómo se estructuran sus datos
• Primeros pasos — configura tu organización, tu portfolio y tu primer parque
• Asistente de IA y asistentes guiados — etiquetado automático de documentos e incorporación guiada