|
|
2 هفته پیش | |
|---|---|---|
| .vscode | 1 ماه پیش | |
| app | 2 هفته پیش | |
| migrations | 1 ماه پیش | |
| static | 2 هفته پیش | |
| templates | 2 هفته پیش | |
| tests | 2 هفته پیش | |
| webservice | 1 ماه پیش | |
| .env.example | 1 ماه پیش | |
| .gitignore | 1 ماه پیش | |
| .python-version | 9 ماه پیش | |
| README.md | 2 هفته پیش | |
| filter_export.py | 4 ماه پیش | |
| pyproject.toml | 1 ماه پیش | |
| server.py | 2 هفته پیش | |
| specs.md | 9 ماه پیش | |
| tox.ini | 9 ماه پیش | |
| uv.lock | 1 ماه پیش |
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
Kommentare und Buchungsbelege starten jeweils mit „Diese Rechnung“ und lassen sich
unabhängig auf offene Rechnungen, das Fahrzeug oder die gesamte Debitorhistorie erweitern.
Die Auswahl gilt für die geöffnete Seite und wird beim Neuladen zurückgesetzt.
Die Fahrzeugansicht bleibt auf denselben Debitor begrenzt und ist ohne Fahrzeugnummer deaktiviert.
Offen bedeutet Beleg_offen <> 0; Zahlungen werden über Bezug_Beleg_Nr zugeordnet.
Alle Filter bleiben im Mandanten der Ausgangsrechnung. Nach erfolgreicher Rechteprüfung dieser Rechnung umfasst die erweiterte Ansicht ausdrücklich auch andere Standorte und Abteilungen des Debitors. Der direkte Zugriff auf andere Rechnungen wird separat geprüft. Neue Kommentare gehören immer zur geöffneten Rechnung, auch in erweiterten Ansichten. Filterwechsel erhalten ungespeicherte Eingaben. Buchungsbelege sind auf 1.000 Zeilen begrenzt; bei Erreichen dieses Limits erscheint ein Hinweis.
Die lesenden Endpunkte /app/forderungen/details/{primary_key}/kommentare und
/app/forderungen/details/{primary_key}/buchungen liefern HTML-Fragmente für HTMX.
scope akzeptiert invoice (Standard), open, vehicle und debtor; andere Werte
werden mit HTTP 422 abgelehnt. Kommentar-POSTs übergeben die aktuelle Auswahl als
comment_scope. Datenbankschemaänderungen sind nicht erforderlich.
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.