84b9987c49
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>
57 lines
3.6 KiB
Markdown
57 lines
3.6 KiB
Markdown
# 🚀 Goal-Prompt für den autonomen Build
|
||
|
||
Kopiere diesen gesamten Block und führe ihn mit dem Slash-Command `/goal` aus:
|
||
|
||
```markdown
|
||
/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 1–3 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.0–1.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.
|
||
```
|