Hilfezentrum
Erste Schritte, Alltag, Tutorial, Support und häufige Fragen an einem Ort.
Onboarding und Alltagshilfe für KH-Tool
Das Hilfezentrum führt neue Nutzer in wenigen Minuten zum ersten belastbaren Ergebnis und gibt später klare Antworten für Alltag, Familie und Support-Fälle.
Neben der In-App-Hilfe liegen ergänzende Markdown-Anleitungen für Support, FAQs und Screenshot-Produktion im Repo.
Neu hier
Konto, Einwilligung, erster Lookup und Ergebnis lesen.
Direkt öffnen02Im Alltag
Text, Foto, Barcode, Portionen, Push und Familienmodus sauber nutzen.
Direkt öffnen03Problem lösen
Push, Kamera, Barcode, Limits oder Consent schnell einordnen.
Direkt öffnenWichtige Produktgrenze
KH-Werte sind Schätzungen. Bei verpackten Produkten kann ein passender Barcode-Eintrag näher am Etikett liegen; Fotoergebnisse sind stärker von Bild und Portion abhängig. Bitte Portion, Produkt und Etikett selbst prüfen. Die App gibt keine Insulin- oder Therapieempfehlung.
Routine, Wiederverwendung und Tagesübergabe sind Organisationshilfen. Bei Unsicherheit Portion, Produkt oder Etikett selbst prüfen.
Neu hier
Ein sauberer Einstieg für neue Nutzer und für Support-Fälle beim ersten Setup.
App öffnen und Startpunkt setzen
Nach Login und Einwilligung ist die Startseite sofort nutzbar. Wähle bei Bedarf das richtige Profil, bevor du den ersten Lookup startest.
Den ersten belastbaren KH-Wert holen
Nutze bei verpackten Produkten zuerst den Barcode und gleiche den Treffer mit dem Etikett ab. Für klar benennbare Lebensmittel eignet sich Text. Foto hilft bei Tellergerichten, wenn Zutaten und Portion gut sichtbar sind.
Geführtes Tutorial
Die vier Kernschritte für neue Nutzer: vom ersten Konto bis zur stabilen Tagesroutine.
App öffnen und Startpunkt setzen
Nach Login und Einwilligung ist die Startseite sofort nutzbar. Wähle bei Bedarf das richtige Profil, bevor du den ersten Lookup startest.
Profile prüfenDen ersten belastbaren KH-Wert holen
Nutze bei verpackten Produkten zuerst den Barcode und gleiche den Treffer mit dem Etikett ab. Für klar benennbare Lebensmittel eignet sich Text. Foto hilft bei Tellergerichten, wenn Zutaten und Portion gut sichtbar sind.
Zum LookupErgebnisse im Tageskontext lesen
In der Übersicht wird aus einzelnen Lookups eine Tagesroutine. Dort erkennst du Verlauf, letzte Mahlzeiten und Wiederverwendung.
Übersicht öffnen
Push und Erinnerungen absichern
Wenn Foto- oder Textjobs im Hintergrund laufen, spart Push spürbar Reibung. Danach kann die Tageserinnerung aktiviert werden.
Push einrichten
Alltagsanleitungen
Kurze, belastbare Handlungsanleitungen statt langer Textwände.
Textsuche sauber nutzen
Am schnellsten für Einzel-Lebensmittel, Mengenangaben und einfache Kombinationen.
Wenn du das Lebensmittel kennst oder die Menge direkt eintippen kannst.
Ablauf
- Lebensmittel direkt mit Menge eingeben, zum Beispiel „Banane 120 g“ oder „2 Scheiben Toast“.
- Für mehrere Komponenten „und“ oder „+“ verwenden.
- Das Ergebnis auf Portion, Quelle und Konfidenz prüfen.
Support-Hinweise
- Text ist bei klar benennbaren Lebensmitteln oft leichter zu prüfen als ein Fotoergebnis.
- Bei sehr niedriger Konfidenz lieber plausibilisieren oder korrigieren.
Fotoanalyse sinnvoll einsetzen
Für Tellergerichte und Mischmahlzeiten, wenn kein Barcode vorhanden ist.
Wenn Form, Menge und Komponenten visuell besser erfassbar sind als per Text.
Ablauf
- Gericht möglichst einzeln, von oben und bei guter Beleuchtung fotografieren.
- Bei bekannter Menge optional Gramm ergänzen.
- Nach dem Ergebnis Plausibilität und Konfidenz prüfen.
Support-Hinweise
- Unklare oder dunkle Fotos lieber neu aufnehmen.
- Verpackte Produkte immer bevorzugt per Barcode scannen.
Barcode für verpackte Produkte
Der genaueste Weg bei Produkten mit EAN.
Bei Joghurt, Riegeln, Brotbeuteln, Getränken und anderen Verpackungen.
Ablauf
- Barcode-Modus öffnen und den Code ruhig in die Kamera halten.
- Auf passende Portion achten, nicht nur auf 100 g Werte.
- Wenn ein Produkt fehlt, Fehlermeldung lesen statt auf Foto ausweichen.
Support-Hinweise
- Barcode ist die erste Wahl, wenn du ein verpacktes Produkt im Alltag sauber prüfen willst.
- Unbekannte Produkte können in Open Food Facts fehlen.
Betreuung und Freigaben
Wichtig, wenn andere Personen je nach Rolle mitsehen oder im Alltag mithelfen sollen.
Wenn andere Personen Verlauf, Hinweise oder Alltagsfunktionen im selben Profil nutzen sollen, aber nicht alles verwalten dürfen.
Ablauf
- Freigabelink in den Einstellungen erstellen.
- Link an die Person senden.
- Passende Freigabestufe auswählen und nach Registrierung aktivieren.
Support-Hinweise
- Observer sehen nur mit und bekommen optional Hinweise.
- Helper dürfen Rezepte, Einkaufsliste und Wiederverwendung nutzen, aber keine KI-Lookups.
- Dependent ist für betreute Alltagsprofile gedacht und erlaubt Lookups, Routine, Rezepte und Einkaufsliste.
Support und Troubleshooting
Die häufigsten Fälle im Alltag, in der Betreuung und bei geteilten Profilen. Jeder Fall führt direkt zum passenden Bereich im Produkt oder im Hilfezentrum.
Diese Sprungmarken führen direkt zum Problemtyp, statt die gesamte Supportseite lesen zu lassen.
Push kommt nicht an
Prüfen: Browser unterstützt Push, PWA ist installiert, Berechtigung nicht blockiert, Ergebnisjob läuft wirklich asynchron.
App ist offline oder Queue hängt
Wenn das Gerät offline ist, werden Text-Lookups vorgemerkt und später synchronisiert. Das ist oft ein Netzwerk- oder Sync-Thema, nicht zwingend ein Datenfehler.
Browser fragt nach LAN-Zugriff
KH-Tool läuft auf einer privaten Server-VM. Chrome und Firefox fragen bei jeder Verbindung von einer öffentlichen Domain in ein privates Netz nach Erlaubnis — das ist eine Schutzmaßnahme deines Browsers, kein Fehler in der App. Die Erlaubnis dauerhaft erteilen ist sicher: die App spricht nur mit dem Server, mit dem du dich gerade verbindest, und nicht mit anderen Geräten in deinem Heimnetz.
Foto liefert keinen sinnvollen Wert
Unscharfe, dunkle oder überladene Bilder sollen lieber fail-closed enden. Kein spekulativer KH-Wert ist besser als ein falscher.
Barcode wird nicht erkannt
Nicht jeder Produktcode ist in Open Food Facts vorhanden. Das ist kein lokaler App-Fehler.
Limit erreicht oder Lookups fehlen
Häufige Ursachen sind fehlender Consent, ein Free-Limit oder das falsche aktive Profil.
Consent fehlt oder Lookups bleiben leer
Häufige Ursachen sind fehlende Consent, Free-Limit erreicht oder falsches aktives Profil.
Zusätzliche Repo-Doku
Neben der In-App-Hilfe liegen ergänzende Markdown-Anleitungen für Support, FAQs und Screenshot-Produktion im Repo.
docs/help-center/README.mddocs/help-center/support-playbook.mddocs/help-center/screenshots.mdWoher Lookup-Werte kommen
Jede Quelle hat eine andere Aufgabe. Ergebnisse sind Alltagsschaetzungen; Portion, Produkt und Etikett bitte selbst pruefen.
Open Food Facts
Barcode- und Produktsuche fuer verpackte Lebensmittel.
Open Food Facts wird fuer Barcode-Treffer und Produktsuche bei verpackten Lebensmitteln genutzt. Produktdaten und Bilder koennen je nach Eintrag, Land und Aktualitaet abweichen.
- Datenart
- Produktname, Barcode, Marke, Portionsangaben, Naehrwerte, Produktbilder
- Pruefung
- Gut bei eindeutigem Barcode, pruefpflichtig bei Texttreffern oder alten Etiketten.
USDA FoodData Central
Referenzdaten fuer Basislebensmittel und US-Lebensmitteldaten.
USDA FoodData Central dient als strukturierte Referenz fuer Zutaten, Basislebensmittel und ausgewaehlte Gerichte. Die Daten sind hilfreich fuer Alltagswerte, ersetzen aber nicht das konkrete Produktetikett.
- Datenart
- Lebensmittelbeschreibung, Naehrwerte, Datenbanktyp
- Pruefung
- Stabil fuer Basislebensmittel, bei Markenprodukten nur als Fallback geeignet.
CIQUAL / Anses
Franzoesische Naehrwertreferenz fuer Zutaten und Lebensmittelgruppen.
CIQUAL von Anses wird als weiterer Referenz-Fallback genutzt, wenn lokale und USDA-Daten keinen passenden Treffer liefern. Werte koennen von regionalen Produkten und Rezepturen abweichen.
- Datenart
- Lebensmittelgruppen, Naehrwerte, Referenznamen
- Lizenz
- Etalab Open License 2.0
- Pruefung
- Nuetzlich als Plausibilitaetsanker, nicht produktspezifisch.
Community- und private Etikettwerte
Manuell gepruefte Werte aus privaten oder oeffentlich freigegebenen Eingaben.
Private Barcodewerte bleiben profilgebunden. Oeffentliche Community-Werte werden nur nach expliziter Freigabe gespeichert und bleiben sichtbar pruefpflichtig, bis sie redaktionell oder durch weitere Signale bestaetigt sind.
- Datenart
- Barcode, Produktname, KH/100g, Portion, optional kcal
- Pruefung
- Alltagstauglich nach Etikettabgleich, bei Community-Treffern weiterhin pruefen.
Foto-KI
Erkennt sichtbare Lebensmittel und Portionen, liefert aber nur gesicherte Schätzungen.
Die Fotoanalyse erkennt Lebensmittel, Komponenten und Portionen. Wenn Foto, Portion oder Lebensmittel nicht klar genug sind, wird die KH-Schaetzung geschlossen abgelehnt und eine bessere Eingabe empfohlen.
- Datenart
- Erkannte Lebensmittel, Komponenten, Portion, Confidence
- Pruefung
- Nur fuer klare Fotos; bei Unsicherheit fail-closed statt Spekulation.
Häufige Fragen
Kurze Antworten für wiederkehrende Fragen aus Onboarding, Alltag und Support.
