Recursos da Plataforma

Tudo o que gere no Mirox está organizado em três recursos aninhados — organização, carteira e parque — que, em conjunto, definem o que pode ver, quem lhe pode aceder e como os seus dados são agrupados para monitorização e relatórios. Compreender esta hierarquia é a base para trabalhar com a plataforma e as suas APIs.

Organização

A Organização é a entidade de nível superior que representa uma entidade empresarial que utiliza a plataforma Mirox.

Características principais

• Entidade empresarial principal: Representa uma empresa, instituição ou outra entidade empresarial
• Contentor de utilizadores: Contém os utilizadores que pertencem à organização
• Proprietária dos recursos: É proprietária das carteiras e dos seus recursos subjacentes
• Entidade de faturação: Serve como entidade para a faturação e a gestão de conta
• Limite de permissões: Define o limite de permissões do nível mais elevado

Estrutura da organização

As organizações têm normalmente os seguintes componentes:

• Membros: Utilizadores que pertencem à organização com diferentes funções e permissões
• Informação: Detalhes empresariais como nome, informações de contacto e tipo de negócio
• Definições: Definições e preferências ao nível de toda a organização
• Parceiros de cooperação: Outras organizações com as quais a organização colabora

Carteira

As carteiras são coleções de parques geridos como uma unidade. Representam agrupamentos lógicos de ativos de energia renovável.

Características principais

• Coleção de ativos: Agrupa múltiplos parques para fins de gestão
• Unidade organizacional: Representa uma unidade de negócio, um cliente ou uma região geográfica
• Nível de permissão: Permite o controlo de acessos ao nível da carteira
• Unidade de relatórios: Serve de base para relatórios agregados

Estrutura da carteira

As carteiras contêm normalmente:

• Parques: Os parques solares individuais ou outras instalações de energia renovável
• Contactos: Pessoas associadas à carteira que podem receber relatórios ou notificações
• Definições: Definições e configurações ao nível de toda a carteira
• Métricas de desempenho: Dados agregados de todos os parques contidos

Parque

Um Parque representa uma instalação de energia renovável individual, normalmente um parque solar.

Características principais

• Ativo físico: Representa uma instalação de energia renovável do mundo real
• Objeto de monitorização: Entidade principal cujo desempenho é monitorizado
• Fonte de dados: Gera dados de séries temporais sobre o seu funcionamento
• Entidade geográfica: Tem uma localização específica e características físicas

Estrutura do parque

Os parques incluem normalmente:

• Componentes: Os componentes físicos da instalação (inversores, strings, caixas de junção do gerador, contadores, sensores de irradiação, loggers, dispositivos de rede). A maioria dos componentes é detetada automaticamente a partir dos seus loggers e sincronizada de forma automática — pode revelá-los e refiná-los em vez de os introduzir manualmente.
• Detalhes técnicos: Especificações como a potência instalada, o limite do inversor, a orientação e os objetivos mensais de performance ratio.
• Informação de localização: Coordenadas geográficas e morada.
• Métricas de desempenho: Dados operacionais como produção de energia, rendimento específico e rácios de eficiência.
• Eventos: Sinais operacionais detetados por máquina, como cortes de rede, sobreprodução e alterações de disponibilidade de fontes.

Relações entre recursos

Estes recursos formam uma estrutura hierárquica:

1. Organização: A entidade de nível superior

   • Contém múltiplas carteiras
   • Contém membros da organização (utilizadores)

2. Carteira: A entidade de nível intermédio

   • Pertence a uma organização
   • Contém múltiplos parques
   • Tem contactos específicos da carteira

3. Parque: A entidade operacional de nível inferior

   • Pertence a uma carteira
   • Contém múltiplos componentes
   • Gera dados operacionais e eventos

Identificadores de recursos

Todos os recursos na plataforma Mirox são identificados por:

• UID: Uma cadeia hexadecimal única de 12 caracteres em maiúsculas (p. ex. "A1B2C3D4E5F6") que é atribuída na criação e não pode ser modificada. Este identificador estático é essencial para a automatização por scripts e para uma referenciação consistente em toda a plataforma.
• Nome: Um nome legível por humanos para fins de apresentação que pode ser alterado pelos utilizadores.

Recursos de apoio

Para além da hierarquia central, alguns recursos partilhados ajudam-no a descrever e documentar os seus ativos:

• Itens de ficha técnica: Fichas de especificações de fabricante reutilizáveis para inversores, painéis solares e armazenamento de baterias, caixas, módulos e células. Mantém-nas uma única vez ao nível da organização e associa-as aos componentes correspondentes em qualquer parque, para que as especificações dos equipamentos se mantenham consistentes em toda a sua frota.
• Armazenamento de documentos: Cada parque dispõe de um explorador de ficheiros para guardar documentos de apoio — relatórios de irradiação, contratos, fichas técnicas, fotografias e muito mais. Os ficheiros carregados são automaticamente etiquetados com a ajuda do Assistente de IA, tornando-os fáceis de encontrar mais tarde.

Operações comuns

Operações de organização

• Gestão de utilizadores (adicionar/remover utilizadores)
• Gestão das definições da organização
• Estabelecimento de parcerias de cooperação
• Gestão dos controlos de acesso ao nível de toda a organização

Operações de carteira

• Criação e gestão de parques
• Atribuição de parques a carteiras
• Relatórios ao nível da carteira
• Gestão de contactos da carteira

Operações de parque

• Monitorização do desempenho do parque
• Análise de eventos do parque
• Geração de relatórios do parque
• Gestão de componentes do parque

Modelo de permissões

A hierarquia de recursos também define o modelo de permissões:

• As permissões ao nível da organização concedem acesso a todas as carteiras e parques dentro da organização
• As permissões ao nível da carteira concedem acesso a todos os parques dentro da carteira
• As permissões ao nível do parque concedem acesso apenas a um parque específico

Este modelo de acesso hierárquico garante que os utilizadores só veem os recursos a que devem ter acesso. As funções e as regras de acesso granular sobrepostas a esta hierarquia são abordadas no Sistema de Permissões.

Funcionalidades relacionadas

• Sistema de Permissões — funções e regras de acesso em organizações, carteiras e parques
• Visão Geral da Instalação — o que cada parque monitoriza e como os seus dados estão estruturados
• Primeiros Passos — configure a sua organização, carteira e primeiro parque
• Assistente de IA e Assistentes Guiados — etiquetagem automática de documentos e integração guiada