|
|
hai 1 mes | |
|---|---|---|
| .vscode | hai 1 mes | |
| app | hai 1 mes | |
| migrations | hai 1 mes | |
| static | hai 1 mes | |
| templates | hai 1 mes | |
| tests | hai 1 mes | |
| webservice | hai 1 mes | |
| .env.example | hai 1 mes | |
| .gitignore | hai 1 mes | |
| .python-version | hai 9 meses | |
| README.md | hai 1 mes | |
| filter_export.py | hai 3 meses | |
| pyproject.toml | hai 1 mes | |
| server.py | hai 1 mes | |
| specs.md | hai 9 meses | |
| tox.ini | hai 9 meses | |
| uv.lock | hai 1 mes |
Das ultimative Tool für:
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
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.
Öffne http://127.0.0.1:8000 im Browser.
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.
migrations/001_authentication.sql auf der Anwendungsdatenbank ausführen..env.example nach .env kopieren und alle Platzhalter ersetzen.JWT_SECRET mit mindestens 32 Byte konfigurieren.TRUSTED_PROXY_IPS eintragen und den FastAPI-Port nicht extern freigeben.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
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.