80 lines
3.8 KiB
Markdown
80 lines
3.8 KiB
Markdown
# 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 dev` im 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:
|
|
1. Docker-Container testen (`docker-compose up --build`)
|
|
2. Frontend unter http://localhost:5178 erreichen
|
|
3. Backend API unter http://localhost:8005/docs testen
|
|
4. 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:30b` 404 auf NucBox-Ollama) — separat fixen.
|