FarmerZone
Regionale Lebensmittel direkt vom Bauern — eine digitale Vermittlungsplattform im Pilotbetrieb.
Was kann die App?
| Bereich | Feature |
|---|
| Öffentliche Hof-Seite | Produkte anzeigen, Warenkorb, Abholzeit wählen, Online- oder Vor-Ort-Zahlung |
| Bestellabwicklung | Stripe-Zahlung, E-Mail-Bestätigungen (Kunde + Bauer), Abholbestätigung |
| Farmer-Dashboard | Bestellübersicht, Produkt- und Bestandsverwaltung, Direktverkauf eintragen |
| Auswertung | Umsatz nach Zeitraum, Verkaufskanal-Vergleich |
| Einstellungen | Hof-Profil, Abholzeiten, Stripe Connect, Pause/Urlaub |
Tech-Stack
- Framework: Next.js 16 (App Router, Turbopack)
- Datenbank: PostgreSQL via Supabase + Prisma 7 (PrismaPg Adapter)
- Auth: Better Auth 1.6
- Zahlungen: Stripe Connect Express + Webhooks
- E-Mail: Resend + react-email
- Styling: Tailwind CSS 4
- Upload: Vercel Blob
- Deployment: Vercel
Lokales Setup (Schritt für Schritt)
Voraussetzungen
- Node.js 22 (wie in der CI)
- pnpm 10 (
corepack enable oder npm install -g pnpm) — nie npm oder yarn im Projekt
- Stripe CLI (für lokales Webhook-Testing)
- Supabase-Konto mit PostgreSQL-Datenbank
1. Repository klonen
git clone <repo-url>
cd bauern-plattform
pnpm install
2. Umgebungsvariablen einrichten
cp .env.example .env.local
Fülle alle Felder in .env.local aus (Supabase, Stripe, Resend, etc.).
3. Datenbank einrichten
# Alle Migrationen einspielen (nie `prisma db push` — siehe DEVELOPMENT.md, „Schema-Änderungen")
pnpm exec dotenv -e .env.local -- prisma migrate deploy
# Testdaten laden: 37 erfundene Höfe im Innviertel, Produkte in allen Kategorien,
# Bestellungen, Kostenposten, Meldungen. Der Seed nennt am Ende alle Zugänge
# (Passwort überall test1234) und je Hof einen Satz, was dort zu testen ist.
pnpm db:seed
Der Seed läuft nur gegen die Dev-Datenbank (farmerzone-dev), nie gegen Produktion.
4. Dev-Server starten
pnpm dev
App läuft auf http://localhost:3000.
5. Stripe Webhooks lokal testen
# In separatem Terminal:
stripe listen --forward-to localhost:3000/api/stripe/webhook
Den ausgegebenen whsec_...-Secret als STRIPE_WEBHOOK_SECRET in .env.local eintragen.
Deployment auf Vercel
1. Vercel-Projekt anlegen
vercel
Oder über vercel.com importieren.
2. Umgebungsvariablen setzen
Alle Variablen aus .env.example im Vercel Dashboard unter Settings → Environment Variables eintragen.
Wichtig für Produktion:
BETTER_AUTH_URL = https://deine-domain.atNEXT_PUBLIC_APP_URL = https://deine-domain.atSTRIPE_SECRET_KEY = Live-Key (sk_live_...) — nur für Production; ein Live-Schlüssel (sk_live_/rk_live_) startet Stripe nur bei VERCEL_ENV=production (Modus-Wache, Register Z2): nicht in Vorschau, Tests und lokal mit next dev. Lokal mit next start startet er, sobald VERCEL_ENV=production gesetzt ist (etwa nach vercel env pull --environment=production)- „Automatically expose System Environment Variables" eingeschaltet lassen: Ohne
VERCEL_ENV zur Laufzeit sperrt die Modus-Wache Stripe mit Live-Schlüssel auch in der Produktion
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY = Live-Key (pk_live_...), ebenfalls nur für ProductionEMAIL_FROM = Adresse von verifizierter Resend-Domain
Die Umstellung von Test auf Live Schritt für Schritt: docs/betrieb/stripe-live.md.
Die Testumgebung (Branch staging unter einer eigenen Adresse, Entwicklungsdatenbank, Stripe-Test) mit ihren Branch-Variablen NEXT_PUBLIC_APP_URL, BETTER_AUTH_URL, STRIPE_WEBHOOK_SECRET und TEST_EMPFAENGER sowie NEXT_PUBLIC_TESTUMGEBUNG_URL für Production: docs/betrieb/testumgebung.md.
3. Stripe Webhook für Produktion
Im Stripe Dashboard einen neuen Webhook anlegen:
- URL:
https://deine-domain.at/api/stripe/webhook
- Events:
payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled, refund.failed, charge.refund.updated, account.updated — ohne canceled wird eine abgebrochene Zahlung nie storniert und ihre Ware bleibt reserviert; ohne die beiden Erstattungs-Ereignisse bleibt eine später gescheiterte Erstattung unbemerkt.
- Den Signing Secret als
STRIPE_WEBHOOK_SECRET in Vercel eintragen.
Dazu einen zweiten Endpunkt für die verbundenen Höfe („Events von verbundenen Konten“ / Connect):
- URL: dieselbe,
https://deine-domain.at/api/stripe/webhook
- Events:
account.updated — hält „Online-Zahlung bereit“ aktuell, wenn Stripe ein Hof-Konto sperrt oder wieder freigibt.
- Dessen Signing Secret als
STRIPE_CONNECT_WEBHOOK_SECRET in Vercel eintragen — das Live-Secret nur für Production, ein Test-Secret für Preview. Die Route prüft gegen beide Secrets.
4. Cron-Job einrichten
vercel.json enthält bereits die Cron-Jobs (einmal täglich, mehr erlaubt der Hobby-Tarif nicht):
Reservierungs-Bereinigung, Freigabe verwaister Bestellungen (/api/cron/verwaiste-bestellungen)
und den Wochenlauf des Briefkastens. CRON_SECRET muss in Vercel gesetzt sein — ohne bleiben
alle Cron-Routen gesperrt.
Go-Live-Checkliste (Pilot-Start)
Infrastruktur
Stripe
E-Mail
Impressum & Datenschutz
Hof-Setup
Qualitätssicherung
Nach dem Launch
Bekannte Einschränkungen (Pilotbetrieb)
- Kundinnen bestellen ohne Konto; ein Konto per Magic-Link (
/account) dient nur der Verwaltung von Benachrichtigungen
- Höfe registrieren sich selbst und werden vom Betreiber unter
/admin freigeschaltet
- Vercel Hobby: der Cron läuft einmal täglich — Fristen gelten deshalb beim Lesen, nie durch den Cron
- Foto-Upload erfordert Vercel Blob Token
Lizenz
Proprietär — Pilotprojekt, nicht für die Öffentlichkeit freigegeben.
