Documentation TraDoc

Résoudre les problèmes de ports, jeton, fournisseur, import, progression et export.

Le port 8000 ou 2499 est déjà utilisé

Un ancien processus est encore actif ou une autre application utilise le port. Arrêtez proprement l'ancien TraDoc, ou lancez :

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

Requêtes 401 en boucle

En mode local main.py dev, rechargez la page ouverte sur le bon port.
En --lan-secure, collez le même APP_SECRET dans chaque navigateur.
Supprimez l'ancien jeton enregistré si vous avez régénéré le secret.

Requêtes 403 sur le test de connexion

Vérifiez que vous utilisez l'interface servie par l'instance, pas un ancien onglet ou une autre origine. Contrôlez ALLOWED_ORIGINS et le mode LAN.

Fournisseur hors ligne

Vérifiez processus, URL, clé, modèle, pare-feu et accès réseau. Dans Docker, localhost ne désigne pas l'hôte.

Contrôlez l'extension, la taille, l'intégrité de l'archive et la présence d'une couche texte pour les PDF. Consultez les limites MAX_UPLOAD_BYTES, MAX_ARCHIVE_ENTRIES et MAX_ARCHIVE_UNCOMPRESSED_BYTES.

Aucun aperçu disponible

Au moins un segment doit être terminé. Si le projet n'a rien traduit, le serveur répond avec un conflit plutôt que de renvoyer un faux résultat.

Reconstruction impossible

Un bloc peut manquer, la structure source peut avoir changé ou le fichier d'entrée peut être absent. Ne supprimez pas manuellement data/jobs/. Restaurez une sauvegarde cohérente si nécessaire.

Le serveur s'arrête après une modification

Avec --reload, Uvicorn redémarre lors d'un changement Python. Si le superviseur complet s'arrête, relancez une seule instance et vérifiez qu'aucun processus enfant ne conserve le port.

Dépannage