c-stone-invoice-check/Task Board.md
2026-11-15 13:49:59 +01:00

61 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Task Board — C-Stone Invoice Check → Invoice Picker
## 🔥 Aktuell (111326 — Grabber + Accountable-Versand, Plan freigegeben)
- [x] Klassifikator: Direktlink-Allowlist (https), Login-/Konsolen-Links → portal, Zahlungsbeleg, email_from dekodiert — `db8dc1d`
- [x] `backend/grabber.py` (INBOX/Archive/Archive.2026/Trash readonly, Dedupe Message-ID+SHA) + `/outbound` (Liste/xlsx/PDF/approve/run) + `mailer.py` — `db8dc1d`
- [x] Deploy + Rückblick-Lauf `since=2025-01-01` (111326/111426)
- [x] OpenAI-Adapter (Stripe-Tracker → pay.stripe.com/pdf) — `b7840cd`, 12 Rechnungen
- [x] AWS-Adapter (Invoicing-API, IAM-User `invoice-picker` + Policy `invoice-picker-readonly`, nur List/GetPDF) — `e18c174`, 18 Rechnungen 05–10/2026
- [x] Strato: kein Adapter — im Kunden-Login „Rechnung als PDF erhalten“ aktiviert, Altbestand per Mail nachgesandt (25 Rechnungen, 12 davon doppelt verschickt); Outbound-Zeilen → `via_mail` (111426)
- [x] Canva: keine API; 14 PDFs einmalig per Chrome geladen und importiert (pending_review); laufend 1×/Monat in „Manuell abholen“ (111426)
- [x] Meta-Zahlungsbelege („Das ist keine Rechnung“) → portal statt ignore — `4ae79bf` (Deploy offen); PDFs nur im Billing Hub, Login Meta Business ausstehend
- [x] Whop: 67 PDFs (Okt–Nov 2026) per Chrome geholt + importiert (pending_review); „order confirmation“ als Stichwort; Belegnr. in Mail = pay_-ID
- [ ] Whop wöchentlich: Playwright+IMAP-Login-Code — **von Markus freigegeben 111526**, Umsetzung in neuer Session
- [x] Accountable: 63 Whop-Zahlungen als Ausgabe „Werbung“, USt „Ausländische USt.“ (Reverse Charge, Entscheidung Markus); 11 alte mit 19 % korrigiert (111526)
- [x] Vault: ACCOUNTABLE_INBOX gesetzt (111526) — Deploy nötig; vor Sammelversand Testmail an eigene Adresse
- [x] Meta: 37 FBADS-Rechnungen (Meta Platforms Ireland) aus Billing Hub (Login via Instagram) importiert; App-Store-Aufladungen → Rechnung von Apple; Hinweis: USt-IdNr. in Meta fehlt (111526)
- [x] Gmail (info@ bis Ende Mai 2026) als 2. Postfach — `cc74635`, App-Passwort im Vault, deployt, Rückblick läuft (111526)
- [x] **Accountable-Kategorisierung 111526: 379 → 109 offen** (≈270 gebucht nach Regeln unten; Leasing = Private Ausgabe; Galaxus = Elektronik/IT 19 % Sofortabschreibung; Privateinlagen = Überweisung von anderem Konto; 0 % braucht in Accountable Begründung „befreit“). Offen: Hochpreis, +3.150/−3.150 Steuerrücklage, Amazon 13, Miete Berdin ~22, Motortech +1.500, Kleinanbieter ohne Regel (Media Markt, Logicc, Adclue, Kaufland, Famila, MOL*WMD, Sixt, SN Nord, IBA, Lox, Heyzine, Black Forest, Alstar, Jet, Invokable, Usercentrics, myposter, mvb, Hotel), Gutschriften
- [x] **Accountable 111526 (2): 109 → ca. 23 offen.** Markus: alles geschäftlich. Miete Berdin 22× „Miete (Externes Büro)“ 19 %; Hochpreis Werbung 19 %; +3.150/−3.150 = Überweisung von/auf anderes Konto; Motortech +1.500 mit Rechnung 2026-005 verknüpft; Amazon 13× 19 %; Nord/Paddle/Heyzine/Black Forest/Jantine = Ausländische USt.; Logicc/Lox24/Invokable/Usercentrics/Adclue/Media Markt/Kaufland/Famila/myposter/mvb/Sixt/Jet 19 %; Gutschriften als Stornorechnung (Flyeralarm, Amazon Media 5×, IONOS 19 %; Qonto 2× 0 % befreit)
- [x] Wochenlauf (111526): Cron NucBox So 06:00 `grabber --send --report`, nur Strato (Gmail nur Rückblick <06/2026), Whop-Roboter (Login-Code aus Postfach, lokal e2e getestet) — `4dff823`, `c6b84db`. Deployt + getestet 15.11.: Whop-Roboter NucBox ok, Testmail ok, 1 echte ok, Sammelversand 148 (+1) → 149 sent, 0 Fehler; 2 Nicht-Belege raus (Qonto-Erinnerung, Fw-Kopie). Offen: GRAB_CUTOFF
- [ ] **Markus klären:** MOL*WMD (14, inkl. Erstattungen), „Rech“ 20.05. (110/39), IBA DE* (Okt 2025, ~6), Alstar 32,40 — wer/was?
- [ ] **Markus prüfen:** Berdin 05.03. 638 € enthält 400 € Kaution (keine Ausgabe, keine USt) → aufteilen; Hotel Leipzig 45 € = 3 Ausgaben (Duplikat-Hinweis, eine ohne Beleg von mir) + Kategorie → Übernachtung; mvb 129,71 als „Bankgebühren“ 19 %?; Kaufland „Bewirtung“ / Famila „Aufmerksamkeiten“ plausibel?; Qonto fx_card ab 08.11. als „Private Ausgabe“ markiert (Regel?)
- [ ] ~~Accountable-Kategorisierung Hauptkonto (379 offen; Girokonto AUSLASSEN = privat)~~ — Freigabe Markus 111526:
- Regeln: Ausland-SaaS (OpenAI, Anthropic/Claude, Google, Meta/Facebk, Base44, Wix, Canva, Invideo, 10Web, Higgsfield, Perplexity, DeepSeek, SlideSpeak, HeyGen, Elementor, AppSumo, Udemy, Coursera, Fiverr, AWS) = „Ausländische USt.“; DE-Anbieter (Hetzner, Contabo, IONOS, fonial, DeepL, SeaTable, Druck, Shirts, Coworking) = 19 %; Qonto-Gebühren/Rundfunk/Behörden = 0 %
- Privateinlage/-entnahme → Privat. Sonderfälle OFFEN lassen: Autohaus-Leasing, Galaxus (AfA), Hochpreis RE20261784, +3.150 „Markus Kruse C-Stone“, Miete Berdin, Amazon
- Ablauf je Buchung: Panel „Zahlung ansehen“ → erst „Geschäftliche Ausgabe“ → „Zu existierender Ausgabe zuordnen“ prüfen (gleicher Lieferant+Betrag = verknüpfen, KEINE Doppel-Ausgabe), sonst „Neue Ausgabe erstellen“ → Kategorie/USt setzen → Speichern. Soft-Hyphens (\u00AD) in Button-Texten beachten.
- [ ] Rechnungslücken (Mails ohne PDF, Picker erkennt nicht): Amazon, Google, Anthropic, Base44, Coursera, Udemy, 10Web, SeaTable, Fiverr, Higgsfield, Perplexity, DeepSeek, SlideSpeak, Vistaprint, AppSumo, Wix
- [ ] Meta: Marketing-API-Token (c-stone-marketing) abgelaufen seit 20.08.2026; API liefert ohnehin keine Beleg-PDFs → Billing-Hub per Browser-Login
- [ ] Gmail (info@ bis Ende Mai 2026): App-Passwort → Vault `GMAIL_IMAP_PASSWORD`, dann zweites Postfach im Grabber
- [ ] Accountable ohne Beleg (31): B2B Datenbank/Invideo/Thalia als Anhang im Postfach; Qonto-Gebühren in Qonto-App; Rest vermutlich Gmail/Papier
- [ ] Stand 111426: pending_review 47, manual 60 (Google, bhw, Instagram, IONOS, stripe.com, eigene Adresse …) — nächste Adapter je nach Menge
- [ ] **Markus:** Accountable-Belegadresse → Vault `ACCOUNTABLE_INBOX`; `GRAB_CUTOFF` = Inbetriebnahme-Tag
- [ ] Befund: Strato-Postfach enthält praktisch erst Mails ab 16.09.2025 (Jan–Sep 2025: 6 Mails) → Quelle für 2025 klären (Gmail? altes Postfach?)
- [ ] Phase 4: Cron NucBox alle 10 Min `docker compose exec -T backend python -m backend.grabber` + `mailer.send_queued`
- [ ] Frontend-Seite „Freigabe“ (bis dahin: `/outbound?format=xlsx` + `/docs`)
## Phase 1 — Altbestand
- [ ] **Morgen zuerst:** Klassifikator nachbessern (Login-/Konsolen-Links → portal; „Zahlungsbeleg" → portal; `email_from` mit `decode_hdr` dekodieren), Redeploy (Markus), Nachklassifizier-Scan; 103 `ignore`-Mails stichprobenartig prüfen
- [ ] Schritt 3 (Monatsablage `Jahr/Monat`) + Schritt 4 (Postfach/Ordner wählbar) — Freigabe ausstehend; vorher klären: Jahr aus Mail- oder Scan-Datum? 199 Invoice-Einträge vs. 134 PDFs (Duplikate?)
- [ ] Gmail-Credentials fehlen (`AUTHENTICATIONFAILED` im Scan)
- [x] Mail-Klassifikator (Anhang / Link / Portal / Ignorieren) — `37e4ed1`, live (170/92/26/103); Ergebnisliste `/emails/classified` basis fertig, Nachbesserung offen
- [ ] Direktlink-Fetcher (Stripe/Paddle) → OpenAI automatisch
- [ ] Qualität prüfen: Aussteller-Erkennung liefert Wortfetzen („ichtet", „kundennr"), alles „ohne MwSt" → Parser-Review
## 📋 Backlog (Invoice Picker)
- [ ] 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] Erstscan-Fix `bd2e21e` (decode_hdr), Scan komplett durch (102226)
- [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)
- [x] Phase 0 (102126): Prod-Compose, Vault, deploy.sh, live auf NucBox, Erstscan 5.240 Mails → echte PDFs unter ~/invoice-check/rechnungen/