feat: initial architecture - requirements, architecture.md, task_graph, AGENTS.md, UI prototype v8d

2026-07-13 03:34:35 +02:00
commit afe6d0a168
10 changed files with 4991 additions and 0 deletions
@@ -0,0 +1,88 @@
+# Offene Fragen – ERP Nutzfahrzeug-/Baumaschinen-Handel
+
+**Stand:** 2026-07-10  
+**Status:** Discovery abgeschlossen – alle Fragen geklärt
+
+---
+
+## 1. Tech-Stack
+
+1. **Backend-Präferenz?** ✅ RESOLVED → Python / FastAPI
+2. **Frontend-Präferenz?** ✅ RESOLVED → React / Next.js (TypeScript)
+3. **Datenbank?** ✅ RESOLVED → PostgreSQL 16+
+4. **PDF-Generierung?** ✅ RESOLVED → Server-seitig (WeasyPrint oder ReportLab)
+
+## 2. Hosting & Deployment
+
+5. **Hosting?** ✅ RESOLVED → Coolify self-hosted (Docker) auf eigenem Server
+6. **CI/CD?** ✅ RESOLVED → Forgejo Actions → Docker Build → Coolify Deploy. Dev + Prod Environments.
+7. **Domain?** ⏳ SPÄTER → Zu klären mit Coolify (vorhandene Domain nutzbar)
+
+## 3. mobile.de Integration
+
+8. **mobile.de Händleraccount vorhanden?** ✅ RESOLVED → JA, aktiver Account mit Seller API-Zugang
+9. **API-Zugangsdaten?** ✅ RESOLVED → JA, vorhanden (Customer-ID und API-Key)
+10. **Sync-Richtung?** ✅ RESOLVED → Push-Only (ERP → mobile.de), NICHT bidirektional
+11. **Sync-Frequenz?** ✅ RESOLVED → Manuell im MVP, ggf. Cron-Job später
+12. **Nutzfahrzeug-spezifische Felder?** ✅ RESOLVED → JA: LKW-Typ, Art (Bagger, Radlader, etc.), Aufbau, Betriebsstunden statt KM, Leistung kW/PS
+
+## 4. OCR (Zulassungsbescheinigung)
+
+13. **OCR-Anbieter-Präferenz?** ✅ RESOLVED → OpenRouter Vision-Modell (Qwen2.5-VL), keine Spezial-API
+14. **Budget für OCR-API?** ✅ RESOLVED → OpenRouter pay-per-use, Budget vorhanden
+15. **Datenschutz?** ✅ RESOLVED → DSGVO: Cloud-Verarbeitung via OpenRouter akzeptiert
+16. **Offline-OCR?** ✅ RESOLVED → Nein, Internetverbindung erforderlich (Cloud)
+
+## 5. Rechtsdokumente & Compliance
+
+17. **Rechtsberatung?** ✅ RESOLVED → System generiert Verträge aus Vorlagen. Stammdaten in Einstellungen hinterlegt.
+18. **GwG-Schwellwert?** ✅ RESOLVED → 10.000 € Barzahlung (gesetzlicher Standard)
+19. **Ausweisdaten-Speicherung?** ✅ RESOLVED → JA, DSGVO-konform verschlüsselt (AES-256), Zugriff nur Admin + Buchhaltung
+20. **BZSt-API-Zugang?** ✅ RESOLVED → NEIN, kein Zugang vorhanden. Manuelle Prüfung im MVP, API-Integration später.
+21. **Steuerberater-Einbindung?** ✅ RESOLVED → JA, DATEV-Export (CSV) eingeplant
+
+## 6. KI-Copilot
+
+22. **Sprachsteuerung?** ✅ RESOLVED → Beides: Spracheingabe (Microphone) + Text-Eingabe
+23. **LLM-Präferenz?** ✅ RESOLVED → OpenRouter (flexibel, z.B. Claude/GPT-4 über OpenRouter)
+24. **KI-Kosten?** ✅ RESOLVED → OpenRouter pay-per-use, Budget vorhanden
+25. **KI-Autonomie?** ✅ RESOLVED → KI darf selbstständig handeln (nach User-Bestätigung)
+
+## 7. KI Bildretusche
+
+26. **Bildretusche-Anbieter?** ✅ RESOLVED → OpenRouter Flux.1-Pro (Hintergrund entfernen, Spiegelungen retuschieren)
+27. **Batch-Größe?** ✅ RESOLVED → Batch-Verarbeitung für mehrere Fotos pro Fahrzeug
+28. **Kosten pro Bild?** ✅ RESOLVED → OpenRouter pay-per-use, Budget vorhanden
+
+## 8. Budget & Zeitrahmen
+
+29. **Budget?** ✅ RESOLVED → OpenRouter pay-per-use + mobile.de Händleraccount. Keine harten Budget-Limits.
+30. **Zeitrahmen?** ✅ RESOLVED → MVP-Phasen sequenziell, keine harten Deadlines
+31. **MVP-Prioritäten?** ✅ RESOLVED → Logischer Ablauf: Bestand → Kontakte → Verkauf etc. (7 Phasen definiert)
+
+## 9. Nutzer & Rollen
+
+32. **Anzahl Nutzer?** ✅ RESOLVED → ~10 Nutzer
+33. **Rollen?** ✅ RESOLVED → 3 Rollen: Admin, Verkäufer, Buchhaltung (Berechtigungs-Matrix definiert)
+34. **Auth-Methode?** ✅ RESOLVED → JWT-basiert (Benutzername/Passwort), Session-Timeout 30min
+
+## 10. Datenmigration
+
+35. **Bestehende Daten?** ✅ RESOLVED → Keine Datenmigration nötig
+36. **Format?** ✅ RESOLVED → N/A (keine Bestandsdaten)
+37. **Menge?** ✅ RESOLVED → N/A (keine Bestandsdaten)
+
+## 11. Sonstiges
+
+38. **Projektname?** ⏳ SPÄTER → Zu klären mit User (Branding)
+39. **Sprachen?** ✅ RESOLVED → Deutsch + Englisch (beides, i18n von Anfang an)
+40. **Mobile App später?** ✅ RESOLVED → Nein, nur responsive Web-UI (kein native App)
+
+---
+
+## Zusammenfassung
+
+- **Resolved:** 38/40
+- **Später:** 2/40 (Domain, Projektname/Branding)
+- **Unresolved:** 0/40
+- **Blockiert für Architecture:** Nein (keine kritischen offenen Fragen)