# 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: ```cmd 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): ```cmd 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 ```cmd 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: ```cmd .venv\Scripts\activate.bat uvicorn app.main:app --reload --host 0.0.0.0 ``` Die Konsole meldet dann Folgendes: ```txt (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 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: ```cmd .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: ```dotenv 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.