Relatórios de Erros e Funcionalidades

O Dreame Vacuum Card funciona como parte da integração dreame_vacuum Home Assistant e não mantém um repositório separado. Todos os relatórios de erros, pedidos de funcionalidades e discussões vão para o repositório principal da integração.

Títulos de Problemas

Os títulos dos problemas devem indicar claramente a relação com o Dreame Vacuum Card, como [Card] Map is not loading. Isto distingue problemas específicos do cartão de problemas gerais da integração.

Verificar Atualizações

Verificar no HACS garante que a versão mais recente da integração dreame_vacuum está a ser utilizada antes de abrir um problema. Um bug reportado ou uma funcionalidade solicitada pode já existir numa versão recente.

Abrir um Problema no GitHub

Solicitar uma Funcionalidade

Novas ideias de funcionalidades e melhorias são sempre bem-vindas.

É necessária uma descrição clara da ideia, da razão da sua utilidade e da funcionalidade prevista. Esboços, rascunhos ou exemplos de outras apps, como a app oficial Dreame, facilitam pedidos de alterações visuais ou comportamentais.

Reportar um Bug

Fornecer informações claras e detalhadas quando ocorre um comportamento inesperado acelera o processo de resolução.

Evidência Visual

É necessário um screenshot completo ou gravação de ecrã mostrando o problema no painel de controlo para este componente de interface visual.

Obter Logs do Home Assistant

A resolução de problemas de falhas na UI, botões quebrados ou falhas de carregamento requer a análise dos erros do frontend que acontecem nos bastidores. O Home Assistant captura e regista automaticamente erros do navegador e do frontend de forma nativa. Estes logs são obtidos diretamente do sistema Home Assistant.

Capturar logs do frontend do Home Assistant:

1. Reproduzir primeiro o problema, como clicar no botão avariado ou atualizar a página se o cartão não carregar, garante que o erro seja capturado imediatamente antes de verificar os registos.
2. Navegar até Definições, seguido de Sistema e depois Registos na barra lateral do Home Assistant.
3. Clicar no botão Transferir Registo Completo na parte inferior da página guarda o ficheiro homeassistant.log localmente.
4. Usar a opção Mostrar registos completos ou o menu de transbordamento (três pontos) no canto superior direito exibe os registos brutos diretamente no navegador.
5. Filtrar o ficheiro de registos transferido, ou copiar as mensagens de erro relevantes, prepara-as para serem anexadas à questão no GitHub.

Proteger Dados Sensíveis

O ficheiro completo homeassistant.log contém informações sensíveis, como palavras-passe, tokens ou identificadores pessoais de outras integrações. Extrair e partilhar apenas as partes relacionadas com frontend ou dreame_vacuum protege estes dados. Todo o ficheiro de registo nunca deve ser carregado publicamente sem rever o seu conteúdo.