Power Flow Card Plus

No início de 2023, comecei a trabalhar num cartão personalizado para o Home Assistant para acompanhar a distribuição de energia em minha casa. Reparei que já existia um cartão oficial que mostrava a distribuição de energia, mas eu queria saber o fluxo de energia em tempo real em minha casa.

Processo

Abordei este projeto com uma mentalidade code-first. Comecei logo por analisar o código-fonte original do cartão oficial de distribuição de energia e comecei a criar um cartão personalizado com base nele. Depois de ter um clone funcional do cartão original, mudei todas as unidades para potência e comecei a trabalhar na lógica do fluxo de energia. A seguir, melhorei alguns pequenos detalhes de UI, como o alinhamento das linhas.

Iteração

Depois de estar satisfeito com as funcionalidades principais do cartão, comecei a trabalhar em funcionalidades mais entusiasmantes, como dispositivos individuais. Era uma funcionalidade muito pedida pela comunidade e também foi muito bem recebida por muita gente. Criei também, de raiz, um editor visual para uma melhor UX, especialmente para pessoas que não estão familiarizadas com programação. O editor visual está dividido em várias secções, incluindo rede, solar, bateria, não-fóssil e dispositivos individuais. Isto torna a edição e a personalização do cartão muito mais fáceis.

Estado atual

A versão atual do cartão inclui várias funcionalidades avançadas, incluindo a personalização de etiquetas, cores e unidades. O cartão inclui também um editor visual para uma personalização fácil. Com mais de 530k downloads, considero este projeto um grande sucesso. Gosto de manter o cartão atualizado com as versões mais recentes do Home Assistant e de acrescentar novas funcionalidades regularmente.

Novidades

O cartão vive agora dentro do flixlix/flixlix-cards, um monorepo que aloja o Power Flow Card Plus juntamente com dois cartões irmãos para o Home Assistant. Cálculos partilhados, primitivas de renderização e textos de i18n ficam num pacote comum, por isso as melhorias chegam a toda a família de uma só vez.

Este repositório existe agora sobretudo para manter estável a distribuição via HACS. Issues, discussões e pull requests acontecem todos no monorepo, e a documentação completa está em cards.flixlix.com.