Erste Schritte

Lokale Entwicklung

Tägliche Befehle, Ports, Builds und Tests des Quellcodes.

Alle folgenden Befehle werden im Stammverzeichnis tradoc/ ausgeführt.

Täglicher Start

.\.venv\Scripts\python.exe main.py dev

Standardmäßig gilt:

  • Vite-Frontend: 127.0.0.1:2499;
  • FastAPI-API: 127.0.0.1:8000;
  • Loopback-Bindung für Vite und FastAPI.

Ports anpassen

.\.venv\Scripts\python.exe main.py dev --api-port 8001 --web-port 2500

Mit --reload startet das Backend bei Änderungen am Python-Code automatisch neu.

Frontend bauen

npm --prefix web run build
.\.venv\Scripts\python.exe main.py serve

serve lauscht auf 127.0.0.1:8000. Docker verwendet --host 0.0.0.0 in einem vertrauenswürdigen LAN.

Tests

.\.venv\Scripts\python.exe -m unittest discover -s tests -p "test_*.py"
npm --prefix web run build
npm --prefix web run test:e2e

Port bereits belegt

TraDoc startet nicht, wenn 8000 oder 2499 belegt sind. Beende den alten Prozess oder wähle andere Ports; starte nicht mehrere Supervisoren auf denselben Ports.

Schnellinstallation

TraDoc aus dem Repository installieren und Frontend mit Backend starten.

Zugriff im lokalen Netzwerk

TraDoc auf Smartphone oder Tablet in einem vertrauenswürdigen LAN verwenden.