Files
scan-receipts/PROMPT_GOAL.md
Timo 84b9987c49 Add full application: receipt scanning, auth, billing, and account deletion
Brings the working codebase (Next.js app, auth system, Stripe billing,
Docker/deploy config, tests, docs) into version control on top of the
placeholder initial commit, and adds account self-deletion (Danger Zone
in Settings, password + typed-email confirmation, cascading DB cleanup,
Stripe cancellation) per GDPR right-to-erasure.

Excludes local build caches, node_modules, and internal agent scratch
files; .gitignore hardened to keep those out going forward.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-19 20:59:04 +02:00

3.6 KiB
Raw Permalink Blame History

🚀 Goal-Prompt für den autonomen Build

Kopiere diesen gesamten Block und führe ihn mit dem Slash-Command /goal aus:

/goal Baue die vollständige Web-App und hochkonvertierende Landingpage für das Projekt „Receipt Scanner to Excel“ gemäß den Spezifikationen im Blueprint `receipt_scanner_to_excel_blueprint.md` und den Beschlüssen aus der Grill-Me Session.

### 🎯 Kernziel
Ein vollständiges, produktionsbereites MVP (Next.js 15 App Router, TypeScript, Tailwind CSS / Modern Design Tokens), das Kassenbons & Rechnungen per Kamera oder Datei-Upload via KI ausliest, mathematisch validiert, in einer interaktiven Tabelle darstellt und als formatiertes Excel (.xlsx) oder CSV exportiert.

---

### 📋 Fixierte Architektur & Anforderungen

1. **Onboarding & User Flow (Instant Drop & Go):**
   - Gäste können sofort 13 Belege ohne Login/Registrierung im Hero-Bereich hochladen oder fotografieren.
   - Speicherung via Hybrid Local-First (IndexedDB im Browser) + 24h PostgreSQL Gast-Session.
   - Paywall-Modal öffnet sich ab dem 4. Scan oder beim Auslösen des vollen Downloads.

2. **Backend & Beleg-Pipeline (Node.js Server):**
   - `/api/scan`: Bildvorverarbeitung mit `sharp` (Auto-Rotate/EXIF-Korrektur, Kontrast-Boost für Thermopapier, Skalierung auf max. 1600px) + SHA-256 Hash zur Duplikaterkennung.
   - Extraktions-Router via Vercel AI SDK (`ai` mit `generateObject`): Primär **DeepSeek V4 Flash** ($0,0679 / $0,168 pro 1M) mit striktem Zod-Schema inkl. Confidence-Scores (0.01.0), `taxBreakdown` (7% & 19%) und `lineItems`. Automatischer Vision-Fallback bei unklarem Bild.
   - Mathematischer Plausibilitäts-Check: Netto + MwSt = Brutto und Summe(Items) = Brutto.

3. **Frontend UI & Interaktion:**
   - Hero Dropzone mit Kamera-Trigger & Multi-File Drag-and-Drop.
   - Interaktive Live-Tabelle: Direkte Zell-Korrektur (Excel-like).
   - Confidence-Highlighter: Unsichere Felder werden gelb markiert.
   - Micro-Prompt Bar: 1-Klick-Bestätigung bei unklaren Feldern (z. B. *„Datum 14.08.2026? [Ja] [Ändern]“*).
   - Zweisprachig: DE (DACH) & EN (US/Global) mit automatischem Browser-Detect und Umschalter oben rechts.

4. **Excel- & CSV-Export Engine (`exceljs`):**
   - Dual-Sheet `.xlsx`: 
     - Sheet 1: Monatsübersicht mit formatierten Beträgen, Steuerspalten (7% & 19%) und dynamischen Excel-Summenformeln (`=SUMME(...)`).
     - Sheet 2: Detaillierte Einzelpositionen (Line Items).
   - DATEV-kompatibler CSV-Export (UTF-8 mit BOM, Semikolon-getrennt).

5. **Monetarisierung & Discord Sales Alert:**
   - 3-Stufen-Paywall: 4,99 € / Woche (3 Tage Trial) | 39,99 € / Jahr | 59,99 € Lifetime.
   - Stripe Checkout Endpunkt (`/api/checkout`).
   - Discord Webhook Alert (`/api/webhooks/stripe`): Sendet bei jedem erfolgreichen Kauf sofort einen Alert mit Betrag und Plan in den Discord-Kanal.

6. **Datenbank (PostgreSQL / Drizzle ORM):**
   - Schema für `users` und `receipts` mit Indizes für User-Datum, Duplikat-Check und Hash.

---

### 🚀 Arbeitsablauf für den Agenten
1. Initialisiere das Projekt im aktuellen Ordner.
2. Installiere alle benötigten Packages (`next`, `react`, `drizzle-orm`, `pg`, `sharp`, `ai`, `@ai-sdk/openai`, `@ai-sdk/google`, `zod`, `exceljs`, `lucide-react`, `stripe`, `idb`).
3. Setze die Backend-Pipeline, das Zod-Schema, den Sharp-Bildprozessor und die KI-Router-Logik auf.
4. Implementiere die Dual-Sheet ExcelJS- und CSV-Generierung.
5. Baue das vollständige Frontend: Hero-Landingpage, Dropzone, Live-Tabelle mit Confidence-Highlighting, Micro-Prompt und Paywall.
6. Implementiere die Stripe- und Discord-Webhook-Logik.
7. Teste die Pipeline und starte den Dev-Server zur Validierung.