docs: Planung Invoice Picker (Erweiterung, NucBox, Phasen 0-4)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
parent
d2c3d29ad2
commit
170e4ddfc1
3 changed files with 33 additions and 44 deletions
|
|
@ -53,3 +53,7 @@ Rechnungen/
|
|||
- Automatische Speicherung (keine manuelle Bestätigung nötig)
|
||||
- Nur speichern, keine Weiterleitung
|
||||
- xlsx-Format für Excel-Tabelle
|
||||
|
||||
## Entscheidung 2026-10-21: Invoice Picker = Erweiterung, kein Neuprojekt
|
||||
Duplikat-Check (Memory-Regel) ergab ~70 % Überschneidung mit diesem Repo → erweitern statt neu. Portal-Abruf läuft auf NucBox, nicht Hetzner: persistentes Browser-Profil, manuelles 2FA-Re-Login per VNC möglich, Amazon blockt Rechenzentrums-IPs aggressiver.
|
||||
Fetcher-Reihenfolge immer billigste Stufe zuerst: Anhang → Direktlink → Playwright. API statt Browser, wo vorhanden (AWS Invoicing API, Meta `business_invoices` nur bei Rechnungskonto).
|
||||
|
|
|
|||
|
|
@ -69,3 +69,12 @@ Rechnungen/
|
|||
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.
|
||||
|
|
|
|||
|
|
@ -1,48 +1,24 @@
|
|||
# Task Board — C-Stone Invoice Check
|
||||
# Task Board — C-Stone Invoice Check → Invoice Picker
|
||||
|
||||
## 📋 Backlog
|
||||
## 🔥 Aktuell (Phase 0 — erstmals in Betrieb nehmen, NucBox)
|
||||
- [ ] docker-compose: restart-Policy backend/db, Storage-Pfad auf NucBox-Volume, Secrets aus Vault statt .env
|
||||
- [ ] IMAP-Secrets (Strato/Gmail) in `~/cstone-secrets/invoice-check/` anlegen
|
||||
- [ ] Deploy NucBox (Port 8005 prüfen), Compose up, Health grün
|
||||
- [ ] 1 echte Anhang-Rechnung korrekt abgelegt (Exit-Kriterium)
|
||||
|
||||
- [ ] Dockerfile.backend erstellen
|
||||
- [ ] Dockerfile frontend (React/Vite) erstellen
|
||||
- [ ] frontend/src/App.tsx erstellen
|
||||
- [ ] frontend/src/main.tsx erstellen
|
||||
- [ ] frontend/vite.config.ts konfigurieren
|
||||
- [ ] frontend/package.json mit Dependencies
|
||||
- [ ] .gitignore prüfen und anpassen
|
||||
- [ ] .env.example mit echten Platzhaltern
|
||||
- [ ] README.md mit Detaillierung erweitern
|
||||
- [ ] Alembic Migration initialisieren
|
||||
- [ ] pytest Setup mit conftest.py
|
||||
|
||||
## 🚀 Aktuell (Phase 2 — Architektur)
|
||||
|
||||
- [ ] docker-compose.yml mit Traefik-Labels erstellen
|
||||
- [ ] Datenbankschema in docs/schema.md entwerfen (✅ erledigt)
|
||||
- [ ] FastAPI Grundstruktur mit Health-Endpunkt (✅ erledigt)
|
||||
- [ ] Backend Router implementieren (emails.py, invoices.py - ✅ erledigt)
|
||||
- [ ] PDF-Scanning mit PyMuPDF implementieren (✅ erledigt)
|
||||
- [ ] Excel-Export mit openpyxl implementieren (✅ erledigt)
|
||||
- [ ] Frontend Grundstruktur (Vite + React)
|
||||
- [ ] IMAP-Verbindung testen (Strato + Gmail)
|
||||
- [ ] PDF-Verarbeitung lokal testen
|
||||
- [ ] Evo-X2 Ablagepfad konfigurieren
|
||||
## 📋 Backlog (Invoice Picker)
|
||||
- [ ] Phase 1: Mail-Klassifikator (Anhang / Link / Portal / Ignorieren)
|
||||
- [ ] Phase 1: Direktlink-Fetcher (Stripe/Paddle) → OpenAI automatisch
|
||||
- [ ] Phase 2: Playwright-Basis, persistentes Profil, Re-Login-Flow, Manuell-Liste + Benachrichtigung
|
||||
- [ ] Phase 2: Adapter Amazon
|
||||
- [ ] Phase 3: Adapter Meta, AWS, Google (vorher API-Check je Anbieter)
|
||||
- [ ] Phase 4: Scheduler/Cron auf NucBox, 2 Wochen Beobachtung
|
||||
- [ ] Frontend: „Manuell abholen"-Liste
|
||||
- [ ] pytest conftest.py
|
||||
|
||||
## ✅ Erledigt
|
||||
|
||||
- [x] Projektordner angelegt
|
||||
- [x] Base Project kopiert
|
||||
- [x] SaaS-Struktur erstellt (backend/, frontend/, docs/)
|
||||
- [x] requirements.txt mit Dependencies
|
||||
- [x] docker-compose.yml erstellt
|
||||
- [x] .env.example mit Platzhaltern
|
||||
- [x] .gitignore und .nextcloudignore
|
||||
- [x] README.md initialisiert
|
||||
- [x] memory.md und knowledge-base.md
|
||||
- [x] Database-Models (Invoice, EmailLog, InvoiceDetail, User)
|
||||
- [x] Email Router (IMAP Search, Filterung)
|
||||
- [x] Invoice Router (PDF-Scan, Tax-Detection, Excel-Export)
|
||||
- [x] Datenbankschema dokumentiert (docs/schema.md)
|
||||
|
||||
## 🔒 Blockiert
|
||||
|
||||
-
|
||||
- [x] Projektordner, Base Project, SaaS-Struktur
|
||||
- [x] Backend: FastAPI, Router (emails/invoices/auth/settings), Models, Alembic
|
||||
- [x] PDF-Extraktion PyMuPDF, Steuer-Erkennung, Excel-Export
|
||||
- [x] Frontend Vite/React/Tailwind, Dockerfiles, docker-compose
|
||||
- [x] Planung Invoice Picker (102126, von Markus freigegeben)
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue