# Preisdatenbank Koblenz – Anwendungsbeschreibung
> Automatisches Sammeln und Vergleichen von Wochenangeboten deutscher Discounter für PLZ 56068 (Koblenz) via marktguru REST-API.
**Aufruf:** http://192.168.2.x:8765/
---
## Was die App macht
Jeden Nacht um 02:00 Uhr werden automatisch die aktuellen Wochenangebote von sieben Discountern importiert. Danach stehen alle Angebote zur Suche und zum Vergleich bereit.
Importierte Händler (Stand 2026-06): ALDI Nord, ALDI Süd, EDEKA, KAUFLAND, LIDL, PENNY, REWE
---
## Tab 1: Suche
Preisvergleich über alle Händler hinweg.
**Suchfelder:**
- **Freitext** – Suche in Produktname, Beschreibung und Kategorie (Beispiel: „Butter", „Käse")
- **Kategorie** – Dropdown, optional kombinierbar mit Freitext
- **Lebensmittelgruppe** – Dropdown (z.B. „🥛 Milch & Milchprodukte"), filtert automatisch die Kategorien
**Ergebnistabelle** (sortiert nach Normpreis aufsteigend):
- Lebensmittelgruppe (Emoji + Name)
- Produktname
- Angebotsbeschreibung
- Preis (mit Streichpreis wenn vorhanden)
- Normpreis (Preis/Einheit – Vergleichsbasis)
- Händler
- Gültigkeitszeitraum
- Treuekarte-Badge (wenn Angebot eine Treuekarte erfordert)
Non-Food-Artikel werden in der Suche automatisch ausgeblendet.
**Artikel in die Einkaufsliste aufnehmen:** „+"-Button am Ende jeder Zeile.
---
## Einkaufsliste (global, immer verfügbar)
- Floating-Bar am unteren Bildschirmrand zeigt Anzahl der Artikel
- Artikel aus Suche und Sparfuchs können aufgenommen werden
- Ansicht: nach Händler gruppiert, innerhalb alphabetisch sortiert
- Gesamtsumme aller Artikel wird angezeigt
- Einzelartikel entfernen oder alles löschen
- **Drucken:** Nur die Einkaufsliste wird gedruckt (Header und Navigation werden ausgeblendet)
---
## Tab 2: Sparfuchs
Zeigt für selbst definierte Produktgruppen oder für Lebensmittelgruppen automatisch die drei günstigsten Angebote (nach Normpreis), je Kategorie.
**Drei Sub-Views:**
1. **Ansicht (nach Gruppe):** Selbst konfigurierte Sparfuchs-Gruppen (z.B. „Frühstück", „Backen") — TOP 3 pro enthaltener Kategorie
2. **Nach Lebensmittelgruppe:** Auswahl einer Lebensmittelgruppe → TOP 3 je Kategorie
3. **Verwaltung:** Sparfuchs-Gruppen anlegen, Kategorien zuordnen, löschen
Jede Karte zeigt: Händler, Rang (🥇🥈🥉), Preis, Normpreis, Streichpreis, Treuekarte-Badge. „+ Zur Liste"-Button übernimmt den Artikel in die Einkaufsliste.
---
## Tab 3: Admin
Verwaltung der Konfiguration im Browser, ohne Zugriff auf den Server.
**5 Sub-Tabs:**
1. **🔤 Suchbegriffe** — Begriffe anlegen, aktivieren/deaktivieren, löschen. Letzte Import-Zeit und Trefferanzahl pro Begriff sichtbar. Der Importer verwendet nur aktive Begriffe.
2. **🏷 Kategorien** — Alle Kategorien anzeigen. Food/Non-Food-Flag setzen (Non-Food wird in der Suche ausgeblendet). Lebensmittelgruppe zuordnen.
3. **🌾 Lebensmittelgruppen** — Lebensmittelgruppen anlegen, Symbol und Sortierung festlegen, löschen.
4. **🖨 Übersicht (Druck)** — Hierarchische Liste: Lebensmittelgruppe → Kategorie → Artikel. Alphabetisch sortiert. Drucken-Funktion für komplette Produktliste.
5. **🏪 Händler** — Alle Händler mit Anzahl importierter Angebote. Händler per Klick aktivieren oder deaktivieren. Inaktive Händler werden vom Importer übersprungen.
---
## Import-Benachrichtigung
Nach jedem nächtlichen Import kommt eine E-Mail an
[email protected] mit:
- Datum, Dauer, Anzahl Suchbegriffe
- Neu/Geändert/Unverändert/Fehler-Statistik
- Liste neu aufgetauchter Kategorien (müssen ggf. als Food/Non-Food markiert werden)
- Liste neuer Produkte, gruppiert nach Kategorie
---
## Offene Erweiterungen (geplant)
- Einkaufsliste beim Drucken nach Lebensmittelgruppe sortieren
- Filialstandorte via Overpass/OSM anzeigen (Query fertig)
- iPhone App (SwiftUI + WireGuard VPN)
- Mac per SSH anbinden