4.4 KiB
4.4 KiB
Memory — C-Stone Invoice Check
Aktuelles Projekt: C-Stone Invoice Check
- Typ: SaaS-App
- Gestartet: 2026-07-24
- DSGVO-relevant: nein
- Beschreibung: Email-Filter für Rechnungen mit PDF-Scanning, lokale Ablage auf Evo-X2, Excel-Dokumentation
- Stack: FastAPI + PostgreSQL + React + PyMuPDF
- Ablageort: Evo-X2 (lokales Laufwerk)
- GitHub: https://github.com/c-stone/c-stone-invoice-check
- Server-Pfad: /root/invoice-check/ (nach Deployment)
- URL: https://invoice-check.c-stone-dev.com (nach Deployment)
Aktuelle Phase: Phase 2 — Architektur (abgeschlossen)
Erledigt:
- ✅ Projektordner angelegt
- ✅ SaaS-Struktur erstellt (backend/, frontend/, docs/)
- ✅ Backend: FastAPI mit Router (emails.py, invoices.py, auth.py)
- ✅ Datenbank: PostgreSQL Models (Invoice, EmailLog, InvoiceDetail, User)
- ✅ PDF-Verarbeitung: PyMuPDF für Text-Extraktion und Steuer-Erkennung
- ✅ Excel-Export: openpyxl für Dokumentation
- ✅ Frontend: React/Vite mit TypeScript (Dashboard, Invoices, Email Logs)
- ✅ Tailwind CSS Konfiguration
- ✅ docker-compose.yml mit Backend + Frontend + PostgreSQL
- ✅ Dockerfile.backend erstellt
- ✅ Dockerfile.frontend erstellt (nginx-basiert)
- ✅ .env.example mit Platzhaltern
- ✅ README.md und docs/schema.md
- ✅ Alembic Migration initialisiert (5316895daf52_initial_schema.py)
- ✅ Test-Dateien (test_imap.py, test_pdf.py)
- ✅ Git Commits für alle Änderungen
Offene Punkte:
- Docker-Container builden und testen (
docker-compose up) - IMAP-Verbindung testen (Strato + Gmail)
- PDF-Verarbeitung lokal testen
- Evo-X2 Ablagepfad konfigurieren
- Frontend lokal starten (
npm run devim frontend/)
Mail-Provider Konfiguration:
- Strato: imap.strato.de:993
- Gmail: imap.gmail.com:993
- Hinweis: App-Passwords statt Hauptpasswort verwenden!
PDF-Verarbeitung:
- PyMuPDF (fitz) für lokal laufende Text-Extraktion
- Keine Daten verlassen den Server
Ablagestruktur (Evo-X2):
Rechnungen/
├── 2025/
│ ├── mit MwSt/
│ └── ohne MwSt/
└── 2026/
├── mit MwSt/
└── ohne MwSt/
Docker-Ports (Project-Port-Liste):
- Backend: 8005 (Host) → 8001 (Container)
- Frontend: 5178 (Host) → 80 (Container)
- PostgreSQL: 5438 (Host) → 5432 (Container, intern)
- Redis: 6384 (Host) → 6379 (Container, intern)
Nächste Schritte:
- Docker-Container testen (
docker-compose up --build) - Frontend unter http://localhost:5178 erreichen
- Backend API unter http://localhost:8005/docs testen
- IMAP-Verbindung mit echten Credentials konfigurieren
102126 — Erweiterung „Invoice Picker" (Entscheidung Markus)
- Entscheidung: Kein neues Repo. Invoice Check wird zu Invoice Picker erweitert: Rechnungen, die nur per Portal-Hinweis-Mail kommen (Amazon, OpenAI, Meta, AWS, Google), automatisch ziehen.
- Architektur: 3 Stufen hinter dem bestehenden IMAP-Poller — (1) Anhang (existiert), (2) Direktlink in Mail (Stripe/Paddle,
requests), (3) Playwright mit persistentem Browser-Profil + Adapter pro Anbieter (backend/fetchers/<vendor>.py,fetch(mail) -> list[Path]). Fehler → „Manuell abholen"-Liste + Benachrichtigung, nie stiller Skip. - Laufzeit: NucBox (= Evo-X2, Hostname
c-stone-ai-lab-NucBox-EVO-X2, on-prem EU). Ablage lokal auf NucBox. Portal-Credentials nur sops-Vault. - Anbieter-Reihenfolge: OpenAI → Amazon → Meta → AWS → Google.
- Phasen: 0 Invoice Check erstmals in Betrieb (nie deployed!) → 1 Klassifikator + Direktlink → 2 Playwright-Basis + Amazon → 3 weitere Adapter → 4 Deploy + 2 Wochen Beobachtung.
- Nicht im Scope: DATEV/lexoffice-Export, OCR gescannter Belege, Mehrmandanten, Mobile.
- Stand: Phase 0 beginnt. RAG-Query am 102126 fehlgeschlagen (
qwen3-coder:30b404 auf NucBox-Ollama) — separat fixen. - Phase 0 erledigt (102126 abends): Live auf NucBox
~/invoice-check/(Compose,.envaus Vault via~/cstone-secrets/bin/with-secrets.sh invoice-check scripts/deploy.sh). Postfach Stratoinfo@c-stone-dev.com. ErstscanPOST /emails/scan-all/startüber 5.240 Mails, nach 90 s bereits 93 Treffer/34 PDFs abgelegt. Zugriff nur per SSH-Tunnel (-L 5178:localhost:5178 -L 8005:localhost:8005). Befunde (offen, Scope Phase 1+): kein Scheduler (Scan manuell),/emails/*ohne Auth (nur localhost), Aussteller-Parser liefert Wortfetzen, Steuer-Erkennung schlägt überall auf „ohne MwSt" an, Dockerfile kopiert.env.exampleals.env.