Shoppy ist eine mobile Einkaufshilfe für den Supermarkt. Nutzerinnen und Nutzer scannen Produkte per Smartphone-Kamera oder Barcode, erhalten direkt eine persönliche Einschätzung und treffen dadurch bessere Kaufentscheidungen.

Die Bewertung berücksichtigt Zutaten, Preis, Nachhaltigkeitsmerkmale und individuelle Ziele wie Allergien, Ernährung, Budget und Nachhaltigkeit.

Zielgruppe

Die App richtet sich an Privatpersonen, die im Supermarkt schnell bessere Kaufentscheidungen treffen möchten. Besonders relevant ist Shoppy für Menschen mit Allergien oder Unverträglichkeiten, ernährungsbewusste Käuferinnen und Käufer, Studierende und Familien mit Budgetfokus sowie Konsumentinnen und Konsumenten mit Nachhaltigkeitsanspruch.

Wichtigste Funktionen

Produkte per Barcode-Scan erfassen
Produktdaten direkt im Laden auswerten
Persönliche Empfehlung anzeigen: kaufen, prüfen oder meiden
Nutzerprofil mit Allergien, Ernährungszielen, Budget und Nachhaltigkeitspräferenzen
Kurze Begründung zur Bewertung und mögliche Alternativhinweise
Manuelle Produktsuche, falls der Barcode nicht erkannt wird
Lokale Einkaufsliste mit Menge, Preis, Abhaken und Löschen
Manuelle Preiseingabe, wenn Open Food Facts keinen Artikelpreis liefert
Lokaler Produktcache und Offline-Modus für gespeicherte Produkte
Produktdaten per Barcode aus der Open-Food-Facts-API
Später geplant: erweiterte Profile, Budgettracking, Nachhaltigkeitsfilter und Rezeptvorschläge

Der One-Pager aus Aufgabe 6.1 beschreibt das Go-to-Market-Konzept:

Projekt: Smart Shopping Companion - Mobile App mit React Native
Kernidee: Produkte im Supermarkt per Smartphone scannen, direkt bewerten und bessere Kaufentscheidungen treffen
Unique Value Proposition: Produktdaten werden direkt am Regal in eine klare persönliche Empfehlung übersetzt
Preisstrategie: Freemium mit kostenlosen Basisfunktionen und optionalen Premium-Funktionen
Distribution: Apple App Store, Google Play Store und zusätzliche Sichtbarkeit über QR-Codes, Hochschulen, Fitnessstudios, Nachhaltigkeits-Communities und lokale Supermärkte

Geplanter Tech-Stack

Expo
React Native
JavaScript
Smartphone-Kamera und Barcode-Scanner
Open Food Facts API für Barcode-Produktdaten
Lokale Speicherung persönlicher Präferenzen
GitHub oder GitLab für Versionsverwaltung und Abgabe

Ordnerstruktur

Shoppy/
|-- assets/
|-- src/
|   |-- assets/
|   |-- components/
|   |   `-- PrimaryButton.js
|   `-- screens/
|       `-- HomeScreen.js
|-- App.js
|-- app.json
|-- babel.config.js
|-- package.json
`-- README.md

Beispiel-Screen

Die App enthält jetzt einen MVP-Flow mit Bottom-Tabs:

Home: Startseite und letzte Scans
Scan: Kamera-Scanner mit Open Food Facts, Beispiel-Barcodes und manuelle Suche
Produktdetail: Ampelbewertung nach Allergien, Budget, Ernährung und Nachhaltigkeit
Alternativen: bessere Produktvorschläge aus dem lokalen Beispieldatensatz
Einkaufsliste: Produkte hinzufügen, abhaken, löschen und Gesamtsumme sehen
Profil: Präferenzen, Allergien, Budget mit Zeitraum, Bio-Vorliebe und Offline-Modus verwalten

Beispiel-Barcodes für Tests über Open Food Facts:

3017620422003 - Nutella
737628064502 - Open-Food-Facts-Beispielprodukt

Die App nutzt für Barcodes https://world.openfoodfacts.org/api/v2/product/{barcode}.json. Wenn ein Produkt bereits lokal gespeichert ist oder der Offline-Modus aktiv ist, wird zuerst der lokale Cache verwendet.

Runbook

Automatischer Android-Build mit Gitea Actions

Der Workflow in .gitea/workflows/android-release.yml startet bei jedem Push in ein Gitea-Repository. Er installiert die Abhängigkeiten mit npm ci, erzeugt das nicht versionierte Android-Projekt per Expo und kompiliert mit Gradle eine Release-APK. Die APK ist im jeweiligen Gitea-Actions-Lauf als Artefakt shoppy-android-release-<Laufnummer> herunterladbar.

Voraussetzungen: Gitea Actions ist für das Repository aktiviert und ein Linux-Runner mit dem Label ubuntu-latest ist registriert. Der Runner benötigt Netzwerkzugang für npm, Gradle und das Android SDK sowie ausreichend Speicher für einen Android-Build. origin zeigt auf das Gitea-Repository; der Workflow startet, sobald die Änderungen dorthin gepusht werden.

Die APK wird derzeit im Release-Modus mit dem von Expo erzeugten Debug-Schlüssel signiert. Sie eignet sich zum Testen, aber nicht als Store-Release. Für eine Veröffentlichung muss ein eigener Release-Schlüssel sicher in Gitea hinterlegt und die Android-Signierung entsprechend konfiguriert werden.

Projekt installieren:

npm install

Projekt starten:

npm start

Alternativ direkt mit Expo:

npx expo start

Danach kann die App mit Expo Go auf einem Smartphone oder in einem Emulator gestartet werden.

Für den Barcode-Scan muss die Kamera-Berechtigung erlaubt werden. Auf Web oder ohne Kamera kann der Scanner über die Beispiel-Barcodes und die manuelle Suche getestet werden.

Repository teilen

Repository-Link für den Kursleiter:

https://git.bachmannj.ch/Fretux/Shoppy