Hilfe & FAQ

Inhaltsverzeichnis

Allgemeine Fragen

Was ist MealMind?

MealMind ist eine intelligente Essensplanungsanwendung für Familien. Sie nutzt KI, um personalisierte wöchentliche Essensvorschläge zu generieren, unterstützt Familien bei der gemeinsamen Auswahl und erstellt automatisch Einkaufslisten, was den gesamten Planungsprozess vereinfacht.

Wie fange ich mit MealMind an?
  1. Registrieren: Erstelle ein Konto (mit E-Mail/Passwort, Google oder Apple).
  2. Familiengruppe einrichten: Erstelle eine neue Gruppe (und gib ihr optional einen Namen) oder tritt einer bestehenden Gruppe über einen Einladungslink bei.
  3. (Admin) Präferenzen festlegen: Definiere die Abneigungen (Blacklist) und allgemeinen Essenspräferenzen (z.B. Fleisch-/Fischtage, Zubereitungszeit) deiner Familie im Präferenzen-Modal (erreichbar über den Button auf der "Nächste Woche"-Seite oder der Kachel auf der Startseite). Dies verbessert die KI-Vorschläge erheblich.
  4. (Admin) Vorschläge generieren: Gehe zur Seite "Nächste Woche" und klicke auf "Vorschläge generieren". Die Generierung läuft im Hintergrund ab.
  5. Bewerten & Auswählen: Überprüft die KI-generierten Essensoptionen für die nächste Woche und bewertet sie (Skala 0-3). Admins wählen das endgültige Gericht für jeden Tag aus (die am besten bewertete Option ist meist vorausgewählt).
  6. (Admin) Plan anwenden: Sobald die Auswahl getroffen ist, wendet der Admin den Plan an. Dadurch werden der endgültige Essensplan ("Essensplan"-Seite) und die Einkaufsliste für diese Woche erstellt.
  7. (Optional, Admin) Mitglieder einladen: Admins können über die Kontoseite weitere Familienmitglieder einladen.
Ist MealMind kostenlos?

MealMind bietet derzeit während der Beta-Phase einen kostenlosen Service an. Du kannst dich anmelden und alle Kernfunktionen kostenlos nutzen. Zukünftige Pläne könnten unterschiedliche Kontotypen mit variierenden Limits (z.B. API-Nutzung) beinhalten.

Wie wechsle ich zwischen Dark- und Light-Modus?

Klicke auf das Sonnen-/Mond-Symbol in der oberen Navigationsleiste. Deine Einstellung wird automatisch für dein Konto gespeichert (wenn eingeloggt) oder über ein Cookie (wenn ausgeloggt).

Essensplanung

Wie werden die Essensvorschläge generiert?

Die Essensvorschläge ("Optionen") werden von einer KI (Google Gemini) basierend auf mehreren Faktoren generiert:

  • Familienpräferenzen: Die spezifischen Abneigungen (Blacklist) und allgemeinen Einstellungen (Fleisch-/Fischtage, gewünschte Zubereitungszeit pro Tag, Kocherfahrung, Soulfood-Tage, verfügbare Geräte, Einhaltung der DGE-Richtlinien) deiner Gruppe, die im Präferenzen-Modal festgelegt wurden.
  • Bewertungshistorie: Vergangene Bewertungen (Skala 0-3), die deine Familienmitglieder für frühere Mahlzeiten abgegeben haben, beeinflussen zukünftige Vorschläge stark.
  • Vielfalt: Die KI versucht, für Abwechslung bei Mahlzeitentypen und Zutaten über die Woche zu sorgen und kürzliche Wiederholungen zu vermeiden.
  • Asynchron: Der Prozess läuft im Hintergrund, damit du die Seite nicht offen halten musst. Du siehst einen Fortschrittsindikator.
Wofür ist die Seite "Nächste Woche"?

Die Seite "Nächste Woche" zeigt die KI-generierten Essensvorschläge für die kommende Woche an, bevor sie Teil deines offiziellen Essensplans werden. Hier kann deine Familie:

  • Jede vorgeschlagene Essensoption bewerten (0=Mag ich nicht, 1=Neutral, 2=Mag ich, 3=Favorit).
  • (Nur Admin) Das endgültige Gericht für jeden Tag auswählen (die am besten bewertete Option ist vorausgewählt).
  • (Nur Admin) Die Auswahl anwenden, um den endgültigen Essensplan und die Einkaufsliste für diese Woche zu erstellen.
  • (Nur Admin) Den KI-Generierungsprozess starten, falls noch keine Vorschläge vorhanden sind oder neue generiert werden sollen.
  • (Nur Admin) Die Essenspräferenzen der Familie konfigurieren.
Wie funktioniert die Essensbewertung (0-3 Skala)?

Du kannst Mahlzeiten auf einer Skala von 0 bis 3 bewerten:

  • 0 (): Mag ich nicht - Die KI wird stark vermeiden, dieses oder ähnliche Gerichte vorzuschlagen.
  • 1 (): Neutral - Es war okay, aber nicht großartig. Die KI behandelt es neutral.
  • 2 (): Mag ich - Es hat geschmeckt! Die KI wird eher ähnliche Gerichte vorschlagen.
  • 3 (): Favorit - Du hast es geliebt! Dies gibt das stärkste positive Signal an die KI. Deine Bewertungen, zusammen mit denen deiner Familienmitglieder, helfen dabei, zukünftige Vorschläge zu personalisieren. Du kannst Mahlzeiten auf der Vorschlagsseite "Nächste Woche" und auf der "Essensplan"-Seite bewerten.
Kann ich den Essensplan nach der Generierung anpassen?

Ja. Sobald ein Plan angewendet wurde und auf der "Essensplan"-Seite sichtbar ist, kannst du:

  • Tag ändern: Klicke auf das Tag-Tausch-Symbol ( Tag) auf einer Essenskarte, um die Mahlzeiten zwischen diesem und einem anderen Tag in dieser Woche zu tauschen.
  • Rezept ersetzen: Nutze das Rezept-Tausch-Symbol ( Rezept) auf einer Essenskarte, um nach einem anderen Rezept aus der Datenbank zu suchen und es für diesen speziellen Tag auszuwählen. Achtung: Das Ersetzen eines Rezepts aktualisiert nicht automatisch die Einkaufsliste für diese Woche.
Wie funktioniert die Einstellung 'Wochenstarttag'?

Familien-Admins können den Tag festlegen, an dem die Woche beginnt (z.B. Montag oder Sonntag), über das Präferenzen-Modal oder die Einstellung auf der "Nächste Woche"-Seite. Dies beeinflusst:

  • Die visuelle Reihenfolge der Tage in den "Nächste Woche"-Vorschlägen und im "Essensplan".
  • Den Datumsbereich, der für die Generierung der wöchentlichen Einkaufsliste verwendet wird.

Rezepte & Bewertungen

Wo kann ich alle verfügbaren Rezepte sehen?

Gehe zur Seite 'Rezepte'. Dort findest du eine Tabelle aller Rezepte. Du kannst die Tabelle durchsuchen, nach Mahlzeitentyp filtern und nach verschiedenen Kriterien wie Titel, Dauer oder Bewertung sortieren.

Wie sehe ich die Details eines Rezepts?

Klicke auf das Augensymbol () in der Aktionsspalte der Rezepttabelle oder auf den Button "Rezept anzeigen" auf einer Essenskarte (im Essensplan oder bei den Optionen). Es öffnet sich ein Fenster mit Zutaten, Zubereitungsschritten und Nährwertangaben.

Kann ich ein Rezept ausdrucken?

Ja. Klicke auf das Druckersymbol () in der Aktionsspalte der Rezepttabelle auf der 'Rezepte'-Seite. Dies öffnet eine druckerfreundliche Version des Rezepts.

Einkaufsliste

Wie wird die Einkaufsliste erstellt?

Die Einkaufsliste wird automatisch generiert, wenn ein Familien-Admin die ausgewählten Essensoptionen von der "Nächste Woche"-Seite anwendet, um den endgültigen Essensplan zu erstellen. Sie fasst alle notwendigen Zutaten der gewählten Mahlzeiten für diese spezifische Woche zusammen.

Wie benutze ich die Einkaufsliste?

Gehe zur Seite "Einkaufsliste". Du kannst:

  • Artikel nach Kategorien gruppiert anzeigen (z.B. Gemüse & Obst, Fleisch & Fisch, Trockenwaren).
  • Auf die Kachel eines Artikels klicken, um ihn als gekauft zu markieren (er wird ausgegraut und in den Abschnitt "Gekauft" am Ende verschoben). Erneutes Klicken macht die Markierung rückgängig.
  • Zwischen Einkaufslisten verschiedener Wochen über die Navigationsbuttons oben blättern.
Kann ich Artikel manuell zur Einkaufsliste hinzufügen oder bearbeiten?

Derzeit kannst du Artikel nur abhaken. Das manuelle Bearbeiten oder Hinzufügen von Artikeln direkt in MealMind wird in dieser Version nicht unterstützt.

Präferenzen & Blacklisting

Wie teile ich der KI mit, was meine Familie nicht mag (Blacklist)?

Familien-Admins können im Präferenzen-Modal (erreichbar über "Nächste Woche" oder die Startseiten-Kachel) Abneigungen definieren. Wähle spezifische Mahlzeitentypen, Küchenstile oder Zutaten aus, die vermieden werden sollen. Klicke auf ein Element, um zwischen ausgeschlossen (rotes ) und eingeschlossen (grünes ) zu wechseln. Die KI wird ausgeschlossene Elemente nicht vorschlagen.

Was sind 'Allgemeine Präferenzen' und wie beeinflussen sie Vorschläge?

Diese Einstellungen (auch im Präferenzen-Modal) leiten die KI über einfache Abneigungen hinaus:

  • Fleisch-/Fischtage: Maximale Anzahl pro Woche.
  • Portionen: Übliche Personenzahl.
  • Kocherfahrung: Dein Skill-Level (1-10).
  • Max. Zubereitungszeit: Zeitlimit (Minuten) pro Wochentag.
  • DGE-Richtlinien: Wie streng gesunde Ernährungsempfehlungen befolgt werden (Keine, Locker, Streng).
  • Soulfood-Tage: Tage für komfortableres, potenziell weniger "gesundes" Essen.
  • Küchenausstattung: Welche speziellen Geräte (AirFryer, Thermomix etc.) vorhanden sind. Diese Präferenzen helfen der KI maßgeblich dabei, relevantere Essensvorschläge zu generieren.

Konto & Familiengruppen

Wie verwalte ich meine Familiengruppe?

Gehe zur Seite "Konto" und wähle den Reiter "Familiengruppe".

  • Admins können: Gruppe umbenennen, neue Mitglieder einladen (Link generieren), Einladungen verwalten, Mitglieder verwalten (Adminrechte, entfernen), API-Tokens verwalten.
  • Alle Mitglieder können Gruppennamen und Mitgliederliste sehen.
  • Nicht-Admins können die Gruppe verlassen (wenn sie nicht der letzte Admin sind).
Wie funktionieren Einladungen?

Admins generieren einen einzigartigen Einladungslink für eine Person (Name & E-Mail nötig). Der Link kann kopiert und gesendet oder direkt per E-Mail verschickt werden. Er ist 30 Tage gültig. Der Empfänger nutzt den Link zur Registrierung/Anmeldung und kann die Einladung dann im Kontobereich annehmen/ablehnen.

Kann ich meine Anmeldemethode ändern (z.B. von Google zu E-Mail/Passwort)?

Nein, die primäre Anmeldemethode kann nach der Registrierung nicht geändert werden. Wer sich mit Google/Apple anmeldet, muss dies weiterhin tun und kann keine E-Mail/Passwort ändern. Wer sich mit E-Mail/Passwort registriert hat, kann beides auf der Kontoseite ändern.

Bleibe ich angemeldet, wenn ich den Browser schließe?

Ja, wenn du beim Login mit E-Mail/Passwort "Angemeldet bleiben" auswählst oder dich über Google/Apple anmeldest, bleibst du über Browsersitzungen hinweg angemeldet, bis du dich explizit über das Menü ausloggst.

KI & Vorschläge

Welche Künstliche Intelligenz (KI) verwendet MealMind?

MealMind verwendet Googles Gemini-Modellfamilie, um deine Präferenzen zu analysieren und kreative, vielfältige Essensvorschläge zu generieren.

Wie lernt die KI unseren Geschmack?

Die KI lernt hauptsächlich aus:

  1. Expliziten Präferenzen: Die vom Familien-Admin definierte Blacklist und die allgemeinen Einstellungen sind direkte Anweisungen.
  2. Bewertungen: Die 0-3-Bewertungen, die deine Familie für Mahlzeiten abgibt, liefern starkes Feedback.
  3. Essenshistorie: Die KI berücksichtigt zuvor geplante Mahlzeiten, um Wiederholungen zu vermeiden.
Warum dauert das Generieren von Vorschlägen manchmal etwas?

Das Erstellen personalisierter Essenspläne ist komplex. Die Anfrage wird asynchron (im Hintergrund) bearbeitet:

  1. Ein Admin startet die Generierung ("Nächste Woche"-Seite).
  2. Die Anfrage wird an die KI gesendet und verarbeitet.
  3. Die Webanwendung zeigt den Status an (Ausstehend -> Läuft -> Erfolgreich/Fehler) und fragt diesen regelmäßig ab.
  4. Nach Abschluss werden die Ergebnisse gespeichert und angezeigt. Dies kann je nach Auslastung einige Sekunden bis Minuten dauern. Du kannst den Fortschritt im Dialog verfolgen oder die Generierung im Hintergrund laufen lassen und die Seite später neu laden.

Datenschutz & Daten

Welche persönlichen Daten speichert MealMind?

MealMind speichert Ihre grundlegenden Kontoinformationen (E-Mail, Benutzername, verschlüsseltes Passwort, falls keine Google/Apple-Anmeldung verwendet wird), Details zu Ihrer Familiengruppe, Ihre Essenspläne, Bewertungen, definierten Präferenzen (Blacklist und allgemeine Einstellungen) und API-Tokens, falls Sie welche generieren. Wir legen Wert auf Datensicherheit und speichern nur das, was für die Funktionalität der App notwendig ist.

Welche Daten werden bei der Generierung von Essensvorschlägen an die KI gesendet?

Um personalisierte Vorschläge zu erstellen, senden wir anonymisierte Informationen an die KI. Dazu gehören:

  • Die Präferenzen Ihrer Familie: Dies beinhaltet die von Ihnen auf die Blacklist gesetzten Elemente (unerwünschte Mahlzeitentypen, Küchenstile, Zutaten) und Ihre allgemeinen Einstellungen (wie Fleisch-/Fischtage, Präferenzen zur Zubereitungszeit, Ausstattung usw.).
  • Essenshistorie & Bewertungen: Eine Liste der in den letzten ca. zwei Wochen geplanten Mahlzeiten, zusammen mit der durchschnittlichen Familienbewertung und einzelnen Bewertungen, die nur durch interne Benutzer-IDs identifiziert werden (z.B. "Benutzer [123] bewertet 2/3"). Wir senden Ihre Benutzernamen oder E-Mail-Adressen NICHT direkt im Prompt an die KI. Die KI verwendet diese Informationen ausschließlich zur Generierung relevanter Essensvorschläge für diese spezifische Anfrage und speichert sie nicht langfristig für andere Zwecke.
Werden meine persönlichen Daten (E-Mail, Name) an die KI gesendet?

Nein. Deine persönlichen Daten wie E-Mail-Adresse oder Benutzername werden nicht an die KI gesendet. Die an die KI übermittelten Informationen sind auf die Präferenzen und die Essenshistorie deiner Familiengruppe beschränkt und enthalten keine direkt identifizierbaren persönlichen Informationen. Es gibt keinerlei Möglichkeit für die KI, anhand der übermittelten Daten Rückschlüsse auf Dich, Deine Familienmitglieder oder andere persönliche Informationen zu ziehen.

Wer kann meine Essensbewertungen sehen?

Innerhalb Ihrer Familiengruppe können alle Mitglieder die durchschnittliche Bewertung für eine Essensoption oder ein geplantes Gericht sehen. Bei der Anzeige detaillierter Familienbewertungen (z.B. auf der Seite 'Nächste Woche') können Mitglieder sehen, welche Bewertung zu welchem Benutzer mit Benutzernamen gehört. Ihre individuellen Bewertungen werden auch (anonymisiert mit Benutzer-ID) an die KI gesendet, um Vorschläge zu verbessern.

Öffentliche API

Bietet MealMind eine öffentliche API für Entwickler an?

Ja, MealMind stellt eine grundlegende öffentliche API (v1) bereit. Derzeit bietet sie einen Endpunkt (GET /api/v1/mealplan), um den aktuellen wöchentlichen Essensplan der Familie des authentifizierten Benutzers abzurufen. Weitere Endpunkte könnten folgen.

Wie authentifiziere ich mich bei der öffentlichen API?

Die Authentifizierung erfordert einen API-Token. Familien-Admins können diese auf der Kontoseite ("API-Tokens"-Tab) generieren. Füge den Token deinen Anfragen hinzu:

  • Bevorzugt: Authorization: Bearer DEIN_API_TOKEN Header.
  • Alternativ: ?api_token=DEIN_API_TOKEN Query-Parameter.
Gibt es ein Rate Limiting für die API?

Ja, API-Anfragen sind ratenbegrenzt (Standardlimit: 60 Anfragen/Stunde, kann je nach zukünftigem Kontotyp variieren). Bei Überschreitung gibt es einen 429-Fehler. Standard X-RateLimit-*-Header informieren über dein Limit.

Wo finde ich weitere API-Details?

Eine grundlegende Dokumentation findest du weiter unten auf dieser Hilfeseite im Abschnitt "Public API".

Fehlerbehebung

Ich bekomme keine Essensvorschläge für nächste Woche. Warum?

Stelle sicher, dass du Mitglied einer Familiengruppe bist und dass ein Gruppen-Admin den Button 'Vorschläge generieren' (verfügbar auf der Seite 'Nächste Woche' oder im Onboarding auf der Startseite) geklickt hat. Es kann manchmal ein oder zwei Minuten dauern, bis die KI Optionen generiert. Wenn das Problem weiterhin besteht, überprüfe deine Familienvorlieben - vielleicht sind zu viele Dinge auf der Blacklist oder die allgemeinen Präferenzen sind zu restriktiv.

Die Einkaufsliste ist leer oder falsch.

Die Einkaufsliste wird basierend auf dem finalisierten Essensplan für die ausgewählte Woche generiert. Stelle sicher, dass ein Plan mit dem Button 'Plan anwenden' auf der Seite 'Nächste Woche' angewendet wurde. Wenn du Gerichte manuell auf der 'Wochenplan'-Seite geändert hast, wird die Einkaufsliste nicht automatisch aktualisiert. Navigiere zur korrekten Woche auf der 'Einkaufsliste'-Seite.

Ich kann mein Passwort/meine E-Mail nicht ändern.

Wenn du dich über Google oder Apple registriert oder angemeldet hast, verwaltest du dein Passwort und deine primäre E-Mail über deren jeweilige Dienste, nicht direkt in MealMind.

Ich erreiche mein API-Anfragenlimit (Rate Limit).

Die öffentliche API hat ein Anfragenlimit (z.B. 60 Anfragen pro Stunde), um Missbrauch zu verhindern. Wenn du das Limit überschreitest, musst du warten, bis das Zeitfenster zurückgesetzt wird. Die Antwortheader (X-RateLimit-Remaining, X-RateLimit-Reset) geben Auskunft über deinen aktuellen Status. Zukünftig könnten höhere Limits verfügbar sein.

API Dokumentation

Wir bieten eine API, die den Zugang zu den MealMind-Daten des eigenen Accounts in ihre eigenen Anwendungen integrieren möchten (z.B HomeAssistant). Unten findest du die aktuelle Dokumentation:

MealMind Public API Documentation

This document describes the public API endpoints available for external applications to integrate with MealMind.

Authentication

All API requests require authentication using an API token. You can generate API tokens in the MealMind application under Account Settings > API Tokens.

API tokens should be included in the request using one of these methods:

  1. Authorization Header (preferred):
Authorization: Bearer YOUR_API_TOKEN
  1. Query Parameter:
?api_token=YOUR_API_TOKEN

API Endpoints

Currently there is only one API endpoint availablable. More endpoints will be provided at a later time.

Get Current Meal Plan

Retrieves the current meal plan for the authenticated user's family group.

Endpoint:

GET /api/v1/mealplan

Example Request:

GET /api/v1/mealplan
Authorization: Bearer YOUR_API_TOKEN

Example Response:

{
    "status": "success",
    "data": {
        "week_start": "2025-04-05",
        "week_end": "2025-04-11",
        "week_start_day": 6,
        "meals": [
            {
                "id": 11,
                "date": "2025-04-05",
                "day_of_week": 6,
                "meal_id": 284,
                "title": "Fisch-Tacos (Seelachs) mit Krautsalat und Avocado-Limetten-Creme",
                "type": "fish",
                "nutrition_info": {
                    "kcal": 600,
                    "protein": 35,
                    "fat": 28,
                    "carbs": 55
                },
                "prep_duration": 25,
                "cook_duration": 5,
                "total_duration": 30,
                "overall_rating": 2,
                "user_rating": 2
            },
            {
                "id": 12,
                // Meal for day 2
            },
            // ... meals for the rest of the week
        ],
        "today": "2025-04-09"
    }
}

Error Responses

401 Unauthorized:

{
  "status": "error",
  "message": "Unauthorized"
}

400 Bad Request:

{
  "status": "error",
  "message": "No family group found for this user"
}

429 Rate Limit Exceeded:

{
  "status": "error",
  "message": "API rate limit [for this endpoint] exceeded. Try again later."
}

500 Internal Server Error:

{
  "status": "error",
  "message": "Database error"
}

Rate Limiting

API requests are limited. If you exceed this limit, you will receive a 429 Too Many Requests response. The current default limit is 60 requests per hour. We will be introducing different tiers on API rate limits in the future.

Support

For API support or to request additional endpoints, please contact the MealMind team.

EOF