Fouten- en Functierapportage

De Dreame Vacuum Card werkt als onderdeel van de dreame_vacuum Home Assistant-integratie en onderhoudt geen afzonderlijke repository. Alle foutmeldingen, functieverzoeken en discussies gaan naar de hoofdrepository van de integratie.

Titels van Issues

Issue-titels moeten duidelijk aangeven dat ze betrekking hebben op de Dreame Vacuum Card, zoals [Card] Map is not loading. Dit onderscheidt kaart-specifieke issues van algemene integratie-issues.

Controleren op Updates

Het controleren van HACS zorgt ervoor dat de absoluut nieuwste versie van de dreame_vacuum-integratie draait voordat een issue wordt geopend. Een gemelde fout of aangevraagde functie kan al bestaan in een recente release.

Open een Issue op GitHub

Een Functie Aanvragen

Nieuwe functie-ideeën en verbeteringen zijn altijd welkom.

Een duidelijke beschrijving van het idee, de reden achter het nut ervan en de beoogde functionaliteit is vereist. Mockups, schetsen of voorbeelden van andere apps, zoals de officiële Dreame-app, vergemakkelijken visuele of gedragsveranderingsverzoeken.

Een bug rapporteren

Het verstrekken van duidelijke en gedetailleerde informatie wanneer onverwacht gedrag optreedt, versnelt het oplossingsproces.

Visueel bewijs

Een volledige screenshot of schermopname die het probleem op het dashboard laat zien, is vereist voor dit visuele UI-component.

Home Assistant-logboeken ophalen

Het oplossen van UI-fouten, kapotte knoppen of laadproblemen vereist het bekijken van de frontend-fouten die zich achter de schermen voordoen. Home Assistant legt automatisch browser- en frontend-fouten native vast en logt deze. Deze logboeken worden rechtstreeks opgehaald vanuit het Home Assistant-systeem.

Frontend-logboeken van Home Assistant vastleggen:

1. Het probleem eerst reproduceren, zoals het klikken op de kapotte knop of het vernieuwen van de pagina als de kaart niet laadt, zorgt ervoor dat de fout wordt vastgelegd vlak voordat de logs worden gecontroleerd.
2. Navigeren naar Instellingen, gevolgd door Systeem en daarna Logs in de zijbalk van Home Assistant.
3. Het klikken op de Download volledige log knop onderaan de pagina slaat het bestand homeassistant.log lokaal op.
4. Het gebruik van de Volledige logs tonen optie of het overflow-menu (drie puntjes) rechtsboven toont de ruwe logs direct in de browser.
5. Het filteren van het gedownloade logbestand, of het kopiëren van de relevante foutmeldingen, bereidt ze voor om als bijlage bij het GitHub-issue toe te voegen.

Bescherm gevoelige gegevens

Het volledige homeassistant.log-bestand bevat gevoelige informatie, zoals wachtwoorden, tokens of persoonlijke identificatoren van andere integraties. Alleen de gedeelten die betrekking hebben op frontend of dreame_vacuum extraheren en delen, beschermt deze gegevens. Het gehele logbestand mag nooit openbaar worden geüpload zonder het te hebben gecontroleerd.