NebenkossenCheck

Hinweis: Dieses Projekt ist vibe coded — also schnell und pragmatisch mit KI-Unterstützung (z. B. Cursor) entstanden, ohne Anspruch auf ausgereifte Architektur oder vollständige Produktreife. Für echte Nutzung bitte Code und Ergebnisse selbst prüfen.

Nebenkostenabrechnung hochladen, Ergebnis als Ampel-Hinweise (Fehler, Warnungen). Kostenlos, ohne Account.

Startseite (Landing)

Ergebnis (Beispiel: Einsparpotenzial und Hinweise)

---

So startest du

Voraussetzung: Node.js 18+ und npm.

1. Abhängigkeiten installieren

cd nebenkosten
npm install

(Wechsle in den Projektordner — nach git clone heißt der Ordner in der Regel nebenkosten.)

2. Anthropic API-Key

1. API-Key in der Anthropic Console erstellen.
2. Im Projektordner .env.local anlegen (wird nicht mit Git versioniert):

copy .env.example .env.local

3. In .env.local eintragen:

ANTHROPIC_API_KEY=sk-ant-api03-...dein-key...

Ohne gültigen Key schlägt die Prüfung nach dem Upload fehl; die App selbst startet trotzdem.

3. Entwicklungsserver

npm run dev

Im Browser http://localhost:3000 öffnen, PDF oder Bild der Abrechnung hochladen.

4. Produktionsbuild (optional)

npm run build
npm start

---

Häufige Probleme

Symptom	Vorgehen
Meldung zu fehlendem ANTHROPIC_API_KEY	.env.local prüfen, Entwicklungsserver neu starten (Strg+C, dann npm run dev).
Port 3000 belegt	Anderen Prozess beenden oder Port in der Next.js-Konfiguration ändern.
Lange Laufzeit / Timeout beim Upload	Kleinere Datei oder schärferes Bild testen; API-Kontingent und Netzwerk prüfen.

---

Funktionsweise (kurz)

Upload → Claude extrahiert Inhalt aus Bild/PDF → TypeScript-Regelwerk in lib/rules/ prüft u. a. BetrKV, HeizkostenV, Fristen und Plausibilität → Ausgabe als Hinweise, keine Rechtsberatung. Bei rechtlichen Fragen Mieterverein oder Fachanwalt einbeziehen.

---

Technische Übersicht

• Frontend: Next.js 14 (App Router), Tailwind
• API: /api/pruefen, /api/ergebnis/[id]
• Extraktion: Anthropic Claude (Vision, PDF)
• Regeln: lib/rules/ — fest codiert, kein LLM für die Rechtsprüfung

app/              Seiten und API-Routen
components/       UI-Komponenten
lib/ocr.ts        Extraktion via Claude
lib/rules/        Prüflogik

---

Rechtliches und Daten

Keine Rechtsberatung (RDG): Die Ausgaben sind automatisierte Hinweise zur eigenständigen Prüfung.

Daten: Im MVP werden Daten u. a. im Server-Arbeitsspeicher gehalten; für einen produktiven Betrieb gehören Aufbewahrungsfristen, Löschkonzept und Datenschutzerklärung dazu.

---

Weiterentwicklung (optional)

Mögliche nächste Schritte: PDF-Export, Widerspruchstext, dauerhafteres Storage mit TTL, Impressum/Datenschutz, Deployment (z. B. Vercel).