暫無描述

gc-server3 bb487e98b6 Verbessere Kommentarverarbeitung und passe Zeitformat an; aktiviere automatisches Neuladen des Servers 2 周之前
.vscode 444a303300 Kleine Anpassungen 1 月之前
app bb487e98b6 Verbessere Kommentarverarbeitung und passe Zeitformat an; aktiviere automatisches Neuladen des Servers 2 周之前
migrations 6cf42fec89 Füge Authentifizierungs- und Berechtigungsmanagement hinzu 1 月之前
static 444a303300 Kleine Anpassungen 1 月之前
templates 1ad0ad9bdc Füge Unterstützung für Forderungsdetails hinzu und verbessere Berechtigungsprüfung 1 月之前
tests 1ad0ad9bdc Füge Unterstützung für Forderungsdetails hinzu und verbessere Berechtigungsprüfung 1 月之前
webservice 0579a3d06b Port auf 8094 geändert 1 月之前
.env.example e46d02a259 Anmeldung ohne LDAP im Debug-Modus 1 月之前
.gitignore 6cf42fec89 Füge Authentifizierungs- und Berechtigungsmanagement hinzu 1 月之前
.python-version ba4f1437b4 init 9 月之前
README.md e46d02a259 Anmeldung ohne LDAP im Debug-Modus 1 月之前
filter_export.py ada592407d Filter in csv ausgelagert 4 月之前
pyproject.toml 6cf42fec89 Füge Authentifizierungs- und Berechtigungsmanagement hinzu 1 月之前
server.py bb487e98b6 Verbessere Kommentarverarbeitung und passe Zeitformat an; aktiviere automatisches Neuladen des Servers 2 周之前
specs.md 2fac46b3d9 Verschiedene Verbesserungen an der Dokumentation und den SQL-Modellen 9 月之前
tox.ini dfc1615049 Erster Entwurf von GPT-5 mini 9 月之前
uv.lock 6cf42fec89 Füge Authentifizierungs- und Berechtigungsmanagement hinzu 1 月之前

README.md

GlobalCube Enterprise Planning, Information & Controlling (gcepic)

Das ultimative Tool für:

  • Forderungsmanagement
  • Offene Aufträge
  • Planung
  • Fahrzeug-Auftragseingang

Installation

Zunächst muss uv, der Python-Paketmanager, installiert werden:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Im Anschluss git-Repository klonen (am Beispiel von Ordner C:\Projekte - im Grunde beliebig):

cd C:\Projekte
git clone https://git.global-cube.com/GlobalCube/Reisacher-Forderung.git

Git erstellt einen Unterordner C:\Projekte\Reisacher-Forderung, in dem das gesamte Projekt abgelegt ist. Jetzt müssen alle Requirements erfüllt werden: passende Python-Version, benötigte Module mit entsprechenden Abhängigkeiten. Das übernimmt uv

Konfiguration

cd C:\Projekte\Reisacher-Forderung
uv sync
copy .env.example .env

Danach müssen in .env die Datenbank-, LDAP-, Proxy- und JWT-Platzhalter ersetzt werden.

Danach kann der Webserver gestartet werden:

.venv\Scripts\activate.bat
uvicorn app.main:app --reload --host 0.0.0.0 

Die Konsole meldet dann Folgendes:

(Reisacher-Forderung) PS C:\Projekte\Reisacher-Forderung> uvicorn app.main:app --reload --host 0.0.0.0                                
INFO:     Will watch for changes in these directories: ['C:\\Projekte\\Reisacher-Forderung']
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [41364] using WatchFiles
INFO:     Started server process [23216]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

Das Repository ist nun bereit für die Nutzung.

Nutzung

Öffne http://127.0.0.1:8000 im Browser.

Authentifizierung und Deployment

Die Anwendung läuft im Produktivbetrieb ausschließlich hinter dem IIS-Reverse-Proxy auf 127.0.0.1:8094. IIS entfernt einen eventuell vom Client gelieferten Header X-Remote-User und setzt ihn nur für erfolgreich per Windows Authentication bestätigte Benutzer neu. Fehlt der Header, bietet die Anwendung die Anmeldung gegen Active Directory über LDAPS an.

  1. migrations/001_authentication.sql auf der Anwendungsdatenbank ausführen.
  2. .env.example nach .env kopieren und alle Platzhalter ersetzen.
  3. Ein eigenes zufälliges JWT_SECRET mit mindestens 32 Byte konfigurieren.
  4. Das LDAPS-Zertifikat des Domain Controllers auf dem Server als vertrauenswürdig installieren.
  5. Die IIS-Proxyadresse in TRUSTED_PROXY_IPS eintragen und den FastAPI-Port nicht extern freigeben.
  6. Den Windows-Dienst mit webservice/install_service.bat installieren.

Die Rollenprioritäten sind: Buchhaltung (400), Standortleitung (300), Abteilungsleitung (200) und Mitarbeiter (100). Berechtigungen werden bei jedem Request aus dbo.Benutzer_Rechte gelesen; leere Benutzerkennungen erteilen keine Rechte.

Tests werden ohne zusätzliche Testabhängigkeiten ausgeführt:

.venv\Scripts\python.exe -m unittest discover -v

Debug-Anmeldung ohne LDAP

Für Entwicklung und manuelle Tests diese Werte in .env setzen und die Anwendung neu starten:

ENVIRONMENT=development
DEBUG_AUTH=true
COOKIE_SECURE=false

Unter /login dieselbe Benutzerkennung in beide Felder eingeben, z. B. Benutzername winter und Passwort winter. Beide Eingaben müssen exakt übereinstimmen. Die Kennung wird anschließend wie beim AD-Login normalisiert. Eine gültige Zuordnung in dbo.Benutzer_Rechte zu einer aktiven Rolle in dbo.Rollen ist weiterhin erforderlich; mehrere Berechtigungszeilen werden wie bisher vereinigt. Ein LDAP-Server ist dafür nicht nötig, die konfigurierte SQL-Datenbank und die Authentifizierungsmigration hingegen schon.

Im Debugmodus werden IIS-Identitätsheader ignoriert, damit verschiedene Benutzer über das Formular getestet werden können. JWT, CSRF, Logout und die Rechteprüfung pro Request bleiben aktiv; der Token enthält auth_source=debug. Benutzername wird als Anzeigename verwendet, E-Mail bleibt leer. Nach dem Deaktivieren von DEBUG_AUTH werden diese Tokens nicht mehr akzeptiert. Standardmäßig ist DEBUG_AUTH=false; außerhalb der Umgebungen development, debug und test verweigert die Anwendung den Start mit aktivem Debug-Login. COOKIE_SECURE=false ist nur für lokale HTTP-Tests gedacht; bei HTTPS auf true setzen.