Geração e Consumo de Energia

CP-ENERGY 1.0.0 — primeira versão comercial

O módulo Energia passou a fazer parte da integração unificada CloudPelizzon, sem criar uma integração separada no Home Assistant.

• Arquitetura interna em modules/energy.
• CloudPelizzon permanece como única integração visível.
• CP-ENERGY é tratado como SKU/licença dentro da plataforma.
• Dashboard Malha Energética V54 internalizado no módulo.

Configuração comercial por cliente

A versão comercial foi estruturada para não depender de marcas, modelos ou nomes fixos de entidades.

• Wizard de configuração no primeiro acesso.
• Autodetecção de sensores de potência e energia.
• Correção manual das sugestões antes de salvar.
• Quantidade dinâmica de fontes de geração.
• Quantidade dinâmica de quadros e cargas monitoradas.
• Concessionária, número de fases e medidores configuráveis.
• Inversores, microinversores e medidores de diferentes fabricantes podem ser mapeados por função energética.

Sensores normalizados CloudPelizzon

O CP-ENERGY cria uma camada própria de sensores para desacoplar o dashboard dos dispositivos físicos de cada instalação.

• Geração instantânea e acumulada.
• Consumo instantâneo e acumulado.
• Potência líquida da rede.
• Importação e exportação instantâneas e acumuladas.
• Potência e energia por fonte de geração.
• Potência e energia por quadro.
• Entidades padronizadas sensor.cloudpelizzon_energy_*.

Cálculos automáticos

• Consumo total pela soma dos quadros quando necessário.
• Geração total pela soma das fontes.
• Potência líquida = consumo − geração.
• Importação = máximo(potência líquida, 0).
• Exportação = máximo(-potência líquida, 0).
• Integração de potência em energia acumulada quando não existe acumulador nativo.
• Persistência dos acumuladores após reinicializações.

Dashboard e experiência visual

• Malha Energética V54 preservada como camada operacional.
• Fluxo em tempo real entre geração, residência e concessionária.
• Abas para Visão Geral, Geração, Consumo, Rede, Quadros, Histórico, Análises e Configuração.
• Cards de geração, inversor, microinversor, consumo, importação, exportação, saldo e pico.
• Indicadores de autoconsumo, autossuficiência e balanço energético.
• Ranking de consumidores e leitura por quadro.
• Showcase comercial com telas reais do módulo.

Integração com a Visão Geral CloudPelizzon

• CP-ENERGY incluído no catálogo de módulos da plataforma.
• Card comercial disponível antes da contratação.
• Card licenciado passa para a área de experiências ativas.
• Padronização do tamanho do card ativo com os demais cards do ecossistema.
• Imagem principal definida como Fluxo de Energia em Tempo Real.
• Vitrine completa permanece acessível por detalhes/carrossel.

Licenciamento dinâmico

• License Server evoluído para permitir edição de uma licença existente.
• Inclusão e exclusão de módulos sem emitir uma nova licença.
• Revisão da licença incrementada a cada alteração.
• Validade da licença passou a fazer parte da edição.
• CP-ENERGY passou a participar do mesmo fluxo de autorização dos demais módulos.
• Menu superior Energia deve ser exibido somente quando o SKU CP-ENERGY estiver autorizado.

License Server — melhorias de interface

• Layout responsivo para diferentes resoluções e níveis de zoom.
• Restauração da tabela de licenças na aba Licenças.
• Botão de edição consolidado como Editar.
• Edição conjunta de módulos e validade.
• Favicon de licenciamento revisado para seguir a identidade visual CloudPelizzon.

Correções e hotfixes

R4.1 — carregamento do frontend

• Corrigido erro JavaScript Invalid or unexpected token.
• Restaurado o contrato de entidades do dashboard.
• Atualizados identificadores de cache.
• Instalador-fonte corrigido para evitar recorrência.

R5.x — showcase e experiência comercial

• Inclusão de telas reais do módulo na vitrine.
• Remoção de preview incorreto.
• Carrossel reservado para a tela de detalhes.
• Card principal da Visão Geral convertido para preview fixo.
• Card licenciado reduzido ao padrão visual dos demais módulos.

R5.4 — licenciamento e navegação

• Implementado sincronismo de direitos para exibição do menu Energia.
• Roteamento do botão Abrir módulo ajustado para o painel operacional do CP-ENERGY.
• Preview principal alterado para a tela Fluxo de Energia em Tempo Real.

R5.4.1 / R5.4.2 — estabilidade do shell

• Identificado ciclo de renderização entre Core e shell após sincronismo reativo de direitos.
• Hotfix de estabilização preparado para eliminar o carregamento infinito do Control Center.
• Sincronismo passa a utilizar atualização pontual dos direitos, sem ciclo recursivo de eventos.
• O fechamento da revisão depende de validação final no Home Assistant.

Segurança de implantação

• Backup antes das alterações.
• Rollback nos instaladores e hotfixes.
• Validação Python e JSON.
• Validação estrutural de JavaScript.
• ha core check antes de reinicializações controladas.

Versões relacionadas

Regra de documentação

A partir desta versão, uma entrega do CP-ENERGY somente deve ser considerada concluída quando a alteração estiver registrada nesta página oficial de notas de versão e também no RELEASE_NOTES.md distribuído com o módulo.

Configuração assistida R4

• Primeiro acesso passa a executar detecção automática da instalação.
• Classificação por confiança substitui a criação fixa de várias fontes e quadros.
• Sensores normalizados do próprio CloudPelizzon são ignorados.
• Telemetrias auxiliares recebem menor prioridade.
• Consumo total é preferido; quadros são usados como fallback.
• Rede elétrica pode ser derivada automaticamente quando não há medidor adequado.
• Campos técnicos foram movidos para Configuração avançada.
• Fluxo padrão reduzido a detecção, revisão e salvamento.

Configuração assistida R5

• Mapa de instalação removido da parte superior do dashboard e centralizado no fluxo de configuração.
• Detecção automática passou a reduzir CTs, fases e telemetrias auxiliares como fontes principais.
• Busca por entidades de energia foi ajustada para priorizar medições operacionais do período, reduzindo risco de usar valores de vida útil em cards de “hoje”.
• Links de documentação do Update Center corrigidos para CP-CORE 0.13.0 e CP-ENERGY 1.0.0.
• Navegação da documentação recebeu padronização visual com ícones azuis.

Padronização visual R5.1

• Datas exibidas no módulo e na documentação seguem DD-MM-AAAA.
• Ícones de navegação da documentação foram normalizados visualmente.