Reisacher-Forderung/specs.md

GCOutline – Spezifikation

Projektübersicht

GCOutline ist ein webbasiertes Forderungsmanagement-Tool für ein Autohaus. Es basiert auf Python mit FastAPI als Backend, jinja2 für Templates und htmx für dynamische Interaktionen. Die Datenhaltung erfolgt in einer Microsoft SQL Server-Datenbank. Als UI-Framework wird CoreUI verwendet. Die Authentifizierung und Benutzergruppensteuerung erfolgt über LDAP.

---

Technologie-Stack

• Backend: Python 3.x, FastAPI
• Frontend: jinja2, htmx, CoreUI (HTML/CSS/JS)
• Datenbank: Microsoft SQL Server
• Auth: LDAP (Active Directory)
• Deployment: Docker (optional), Gunicorn/Uvicorn
• API: REST (JSON)

---

Hauptfunktionen

1. Login & Berechtigungen

• Authentifizierung über LDAP.
• Benutzergruppensteuerung (z. B. Standort, Rolle).
• Nach erfolgreichem Login: Weiterleitung zur Forderungsliste.

2. Forderungsliste (Offene Posten)

• Anzeige einer Tabelle mit Forderungen:
  • Sortierung: Standard nach Fälligkeit (aufsteigend).
  • Filter:
  • Standort
  • Verkäufer
  • Kunde
  • Fälligkeit (Datum)
  • Textsuche über:
  • Verkäufer
  • Kunde
  • Fahrzeug
  • Fahrgestellnummer
  • Rechnungsnummer
  • Bemerkung
• Pagination / Infinite Scroll:
  • Initial: 100 Einträge.
  • Beim Scrollen: dynamisches Nachladen weiterer Einträge via htmx.
• Export-Funktion:
  • CSV-Export.
  • Excel-Export (XLSX).

3. Detailansicht

• Eigene Seite mit eindeutiger URI:
  • /detail/{id} oder /detail/{rechnungsnummer}
• Inhalte:
  • Rechnungsdetails (Forderung, Betrag, Fälligkeit).
  • Bereits geleistete Zahlungen.
  • Kaufhistorie des Kunden.
• Eingabefelder:
  • Bemerkung (Textfeld).
  • Wiedervorlage-Datum (Datepicker).
• Speicherung:
  • Bemerkung + Wiedervorlage in separater Tabelle mit:
  • Zeitstempel
  • Benutzer-Info (aus LDAP)
  • Verknüpfung zur Forderung.
• Export-Funktionen auf Detailseite:
  • Microsoft Word (DOCX) mit Template und Platzhaltern für Tabellenfelder.
  • E-Mail-Erstellung via mailto: mit Link zur Detailseite.
• Navigation:
  • Beim Verlassen der Detailseite (Speichern oder Zurück) wird die zuletzt verwendete Filterung und Sortierung wiederhergestellt.

---

UI/UX Anforderungen

• CoreUI als Basis-Template.
• Responsive Design.
• Dropdown-Filter + Textsuche prominent.
• Infinite Scroll für Performance.
• Detailansicht als eigene Seite.
• Export-Buttons klar sichtbar.

---

Datenbank-Design (vereinfacht)

Tabellen

• Forderungen
  • ID (PK)
  • Kunde_ID
  • Verkäufer_ID
  • Fahrzeug
  • Fahrgestellnummer
  • Rechnungsnummer (Unique)
  • Betrag
  • Fälligkeit
  • Status
• Kunden
  • ID
  • Name
  • Historie
• Zahlungen
  • ID
  • Forderung_ID
  • Betrag
  • Datum
• Bemerkungen
  • ID
  • Forderung_ID
  • Benutzer
  • Bemerkung
  • Wiedervorlage_Datum
  • Zeitstempel

---

Sicherheitsanforderungen

• LDAP-Authentifizierung.
• Rollenbasierte Zugriffskontrolle.
• HTTPS für alle Verbindungen.
• SQL-Injection-Schutz (ORM oder Prepared Statements).

---

Performance

• Lazy Loading (htmx).
• Pagination für große Datenmengen.
• Indexierung der Filterfelder in SQL Server.

---

Offene Punkte

• Word-Template: Soll ein Autohaus-Briefkopf und Platzhalter für Rechnungsdaten enthalten.
• E-Mail: Nur mailto:-Link mit Betreff und URL zur Detailseite.
• Logging & Monitoring: vorerst nicht erforderlich.