← Zurück zur App
Benutzerhandbuch: NutzeAlles – Dein smarter Küchenhelfer
Version: 1.3.0 (Nutzer-Version)
Status: Aktiv
Fokus: Voice-First, Resteverwertung, Google Gemini KI-Rezepte, Tierisches Lab & Ernährungsformen, High-Speed Filtering, SQLite & Offline-First
Inhaltsverzeichnis
- Einführung & Konzept
- Installation als App (PWA) & Instant-Updates
- Erste Schritte & Speicher-Modi (SQLite & LocalStorage)
- Die Vorratskammer verwalten (Pantry)
- Die Einkaufsliste verwalten
- KI-Koch, Rezepte & Ernährungsformen (Tierisches Lab)
- Einstellungen & Eigener Gemini-Schlüssel
- Sicherheit, Cybersecurity & Datenschutz
1. Einführung & Konzept
1.1. Was kann die WebApp?
NutzeAlles ist eine innovative, mobile-first Webapplikation, die als intelligenter Küchenhelfer konzipiert wurde. Das Hauptziel der App ist es, Lebensmittelverschwendung zu reduzieren und das Küchenmanagement zu vereinfachen.
Die fünf Säulen der WebApp:
- 🎙️ Sprachsteuerung (Voice-First): Erfasse oder verbrauche Lebensmittel einfach durch Sprechen.
- 🥗 Intelligente Resteverwertung: Lass die Google Gemini API aus deinen vorhandenen Zutaten (priorisiert nach Ablaufdatum) leckere Rezepte vorschlagen.
- 🧀 Ernährungsformen & Tierisches Lab: Verwalte vegane, vegetarische oder fleischhaltige Rezepte und kennzeichne Käse mit tierischem Lab (z.B. Parmesan, Pecorino, Gorgonzola) präzise.
- 📋 Mobiles Einkaufslisten-Management: Verwalte Einkäufe offline-fähig und lass gedruckte Bons oder handgeschriebene Zettel einfach per Kamera digitalisieren.
- 🔒 Datensouveränität & DSGVO-Konformität: Entscheide selbst, ob deine Daten lokal im Browser verbleiben oder verschlüsselt in die Cloud synchronisiert werden.
2. Installation als App (PWA) & Instant-Updates
NutzeAlles ist als Progressive Web App (PWA) konzipiert. Das bedeutet, du musst sie nicht aus dem Google Play Store oder Apple App Store herunterladen. Du kannst sie direkt aus dem Browser auf deinem Startbildschirm installieren.
2.1. Vorteile der Installation
- Offline-Fähigkeit: Die App startet und funktioniert auch ohne Internetverbindung (Speicherungen im lokalen Modus).
- Network-First Instant-Updates: Beim Start prüft die App im Hintergrund automatisch auf die neueste Version auf dem Server und aktualisiert sich nahtlos.
- Mehr Bildschirmfläche: Keine störenden Browser-Adressleisten.
- Schneller Zugriff: Ein Symbol auf deinem Homescreen wie bei einer nativen App.
2.2. Installationsanleitung
| Betriebssystem / Browser |
Vorgehensweise |
| Android (Google Chrome) |
1. Öffne die WebApp-URL im Chrome-Browser. 2. Es erscheint meist automatisch ein Banner am unteren Rand („App installieren“ oder „Zum Startbildschirm hinzufügen“). Tippe darauf. 3. Falls kein Banner erscheint: Tippe oben rechts auf die drei Punkte (Menü) und wähle „App installieren“ bzw. „Zum Startbildschirm hinzufügen“. |
| iOS / Apple iPhone (Safari) |
1. Öffne die WebApp-URL im Safari-Browser. 2. Tippe in der unteren Navigationsleiste auf das Teilen-Symbol (Quadrat mit Pfeil nach oben). 3. Scrolle nach unten und wähle „Zum Home-Bildschirm“. 4. Bestätige den Namen und tippe oben rechts auf „Hinzufügen“. |
3. Erste Schritte & Speicher-Modi (SQLite & LocalStorage)
Beim ersten Start von NutzeAlles wirst du gefragt, wie du deine Daten verwalten möchtest. Die App bietet zwei grundlegende Betriebsmodi:
3.1. Lokaler Modus (Offline / Standard)
- Alle erfassten Lebensmittel, Rezepte und Einkaufslisten werden ausschließlich im lokalen Speicher deines Browsers (LocalStorage) abgelegt.
- Keine Übertragung von Vorräten an einen Server.
- Keine Registrierung erforderlich.
- Wichtiger Hinweis: Wenn du den Browser-Cache löschst oder dein Smartphone wechselst, gehen deine Daten verloren.
3.2. Online-Modus (Mit Cloud-Backup & High-Speed SQLite)
- Registriere dich mit einer E-Mail-Adresse und einem Passwort.
- Deine Daten werden im Hintergrund verschlüsselt in einer hochperformanten SQLite-Datenbank (mit WAL-Modus) auf dem Server gesichert.
- Im Header signalisiert ein Wolkensymbol ☁️ die aktive Cloud-Sicherung.
HINWEIS: Die App ist Offline-First. Das bedeutet: Selbst im Online-Modus greift die App immer zuerst auf die lokalen Daten deines Geräts zu. So ist die App extrem schnell und läuft auch im Supermarkt oder Keller ohne Mobilfunknetz flüssig. Sobald wieder Empfang besteht, synchronisiert sie im Hintergrund.
4. Die Vorratskammer verwalten (Pantry)
Im Tab „Vorrat“ behältst du die Übersicht über all deine Lebensmittel.
4.1. Lebensmittel hinzufügen
A. Per Spracheingabe (Voice Add) 🎙️
- Tippe auf den großen Mikrofon-Button in der Fußzeile (oder auf das Mikrofon im Suchfeld). An der Tonwelle erkennst du, dass die Aufnahme läuft.
- Sprich deine Zutat im natürlichen Satzbau ein. Zum Beispiel:
- „Habe fünfhundert Gramm Nudeln eingekauft, haltbar bis Dezember.“
- „Drei Packungen Milch haltbar bis sechsundzwanzigsten Juli.“
- „Eine Salatgurke.“
- NutzeAlles verarbeitet den gesprochenen Text über Gemini und extrahiert Name, Menge, Einheit und Ablaufdatum automatisch.
TIPP - Automatische MHD-Schätzung: Wenn du beim Einsprechen kein Haltbarkeitsdatum nennst, schätzt Gemini ein realistisches Datum ab dem heutigen Tag. Zum Beispiel erhält Milch automatisch +5 Tage, Pasta +1 Jahr und Schokolade +6 Monate.
B. Per Barcode- / Produkt-Scan 📸
- Tippe auf den Barcode-Scanner-Button (neben dem Mikrofon in der Fußzeile).
- Wähle aus, ob du die Kamera nutzen oder ein Foto hochladen möchtest.
- Fotografiere den Barcode oder die Verpackung des Lebensmittels.
- Gemini analysiert das Bild, erkennt das Produkt, liest Gewicht und Einheit ab und schätzt/erkennt das MHD. Das Produkt wird direkt in deinen Vorrat eingetragen.
C. Manuelle Eingabe 📝
- Klicke im Vorrats-Tab auf das Plus-Symbol oder trage Lebensmittel direkt über das manuelle Formular ein.
- Trage Name, Menge, Einheit (g, ml, Stück, Pkg) und das Ablaufdatum (MHD) von Hand ein.
4.2. Verbrauch erfassen (Consume)
- Per Sprache: Tippe das Mikrofon an und sprich: „Ich habe zweihundert Gramm Nudeln verbraucht“ oder „Milch ausgetragen“. Die Bestände reduzieren sich automatisch.
- Per Klick: Jedes Lebensmittel besitzt Schnell-Verbrauch-Buttons (z. B.
-100g oder -1 Stück).
- Per Swipe (Wischen): Wische eine Lebensmittel-Karte nach links, um sie als komplett verbraucht zu markieren.
- Mengen-Editor: Klicke direkt auf die Zutat, um die Menge manuell im Editor-Modal anzupassen.
4.3. Haltbarkeits-Indikatoren (MHD)
- 🟢 Grün (Frisch): Noch lange haltbar.
- 🟡 Gelb (Mittel): Läuft in den nächsten 3 bis 7 Tagen ab.
- 🔴 Rot (Dringend / Abgelaufen): Läuft heute ab oder ist abgelaufen. Verbrauch dringend empfohlen!
4.4. Suchen, Sortieren und Teilen
- Suchen: Nutze das Suchfeld für blitzschnelle Filtersuche (mit Sprachsuche).
- Sortieren: Sortiere nach MHD, Hinzugefügt-Datum oder Alphabetisch.
- Teilen: Klicke auf das Teilen-Symbol, um deine Vorratsliste per Messenger oder E-Mail zu versenden.
5. Die Einkaufsliste verwalten
Das Tab „Einkaufsliste“ hilft dir beim nächsten Einkauf.
5.1. Artikel hinzufügen
- Tippen oder Sprechen: Gib deine Einkäufe ein (z. B. „3 Äpfel, Milch, Butter“) oder sprich sie ein.
- Zettel scannen (OCR-Scan) 📸: Fotografiere einen Kassenbon oder handgeschriebenen Zettel. Gemini extrahiert alle Artikel automatisch.
5.2. Einkaufen & Aufräumen
- Abhaken: Tippe beim Einkaufen auf Artikel, um sie durchzustreichen.
- Abgehakte löschen: Tippe auf „Abgehakte löschen“ (Mülltonne), um durchgestrichene Artikel auf einmal zu entfernen.
- Reihenfolge ändern: Verschiebe Artikel per Drag-and-Drop.
6.1. Rezepte generieren (KI-Koch) 🤖
- Tippe in der Navigation auf den bunten „KI-Koch“ (das Gemini-Stern-Symbol).
- Wähle Portionen, Kategorie und Sonderwünsche (z. B. „unter 30 Minuten“).
- Klicke auf „Rezepte vorschlagen“. Gemini priorisiert Zutaten, die bald ablaufen, und ordnet die Gerichte präzise ihrer Ernährungsform zu.
6.2. Ernährungsformen & "Tierisches Lab" 🧀🥛
Jedes Rezept wird automatisch oder manuell einer Ernährungsform zugeordnet:
- 🌱 Vegan: Keinerlei tierische Produkte.
- 🧀 Vegetarisch: Ohne Fleisch/Fisch und ohne tierisches Lab.
- 🥛 Tierisches Lab: Enthält Käsesorten, die traditionell mit tierischem Lab hergestellt werden (z. B. Parmesan, Grana Padano, Pecorino, Gorgonzola).
- 🥩 Fleischhaltig / Omnivor: Enthält Fleisch oder Fisch.
Rezept-Editor: Beim Erstellen oder Bearbeiten eines Rezepts kannst du die Ernährungsform über ein komfortables Dropdown-Menü festlegen sowie das Häkchen „Enthält tierisches Lab“ setzen.
6.3. Rezeptbuch & High-Speed Filterung 📖
- Filter-Chips: In der Filterleiste kannst du nach
🌱 Vegan, 🧀 Vegetarisch, 🥛 Tierisches Lab, 🥩 Fleischhaltig oder Speisenkategorien (Hauptspeisen, Backen, Snacks etc.) filtern.
- Filter-Kombinationen: Ernährungsformen und Speisenkategorien lassen sich frei miteinander kombinieren (z. B.
🌱 Vegan + Backen).
- Instant-Performance: Dank optimiertem Frontend-Caching reagiert das Auswählen von Filter-Chips in unter 1 Millisekunde absolut ohne Ruckler.
- Filter „Dringend“: Zeigt nur Rezepte, deren Zutaten du aktuell im Haus hast und die bald ablaufen.
7. Einstellungen & Eigener Gemini-Schlüssel
In den Einstellungen (Zahnrad-Symbol im Header) verwaltest du dein Profil und die technischen Optionen der App.
7.1. Gemini API-Schlüssel eintragen
NutzeAlles kann einen zentralen API-Schlüssel des Betreibers nutzen oder unbegrenzt über deinen eigenen, kostenlosen Google-Gemini-Key betrieben werden:
- Erstelle einen kostenlosen API-Key bei Google AI Studio (
ai.google.dev).
- Trage deinen Key in den Einstellungen ein und wähle das Modell (
gemini-3.5-flash).
- Nach dem Speichern zeigt der Header „Gemini aktiv“ (grün).
8. Sicherheit, Cybersecurity & Datenschutz
NutzeAlles wurde nach strengsten Sicherheitsrichtlinien (Secure by Design) entwickelt.
8.1. Datenschutz (DSGVO-konform)
- Keine Tracker / Werbe-Cookies: Absolute Datensparsamkeit.
- Kryptografischer Schutz: Passwörter werden im Backend mit SHA-256 und zufälligen Salts gesichert.
- Recht auf Löschen: Löschungsanfragen über das Menü oder formlos an info@nelke.com.
8.2. Abwehr von Cyber-Bedrohungen & SQLite-Sicherheit
- Schutz vor SQL-Injection: Die SQLite-Datenbank verwendet im Backend ausschließlich parametrisierte Abfragen (Prepared Statements mit Platzhaltern
?). Benutzereingaben werden niemals als SQL-Code ausgeführt.
- Schutz vor Prompt Injection: Systemprompts erzwingen striktes JSON-Format. Manipulationsversuche schlagen beim Backend-Parsing fehl.
- Schutz vor XSS: Ausgaben erfolgen über sichere DOM-Methoden.