Entwicklung

Codearchitektur

Zuständigkeiten der Python-Module, API und des React-Frontends.

tradoc/
├── api/
│   ├── app.py
│   └── routes.py
├── core/
│   ├── checkpoint.py
│   ├── chunker.py
│   ├── cleaner.py
│   ├── config.py
│   ├── credentials.py
│   ├── engine.py
│   ├── glossary.py
│   ├── llm_client.py
│   └── parser_*.py
├── tests/
├── web/
│   ├── src/components/
│   ├── src/demo/
│   └── src/i18n/
├── cli.py
└── main.py

Einstiegspunkte

main.py stellt serve, dev und die Gruppe cli bereit. api/app.py liefert die API und in Produktion die kompilierte SPA aus.

Fachlogik

TranslationEngine wählt den Parser, bereitet das Projekt vor, steuert Aufrufe und rekonstruiert die Datei. CheckpointDatabase speichert Projekte und Segmente. Der LLM-Client vereinheitlicht Anbieter-APIs und Fehler.

Frontend

App.jsx hält den globalen Zustand. Hauptansichten sind Dashboard, JobsInspector, TestSandboxModal, GlossaryWorkspace, SetupWizard und Settings. api.js wählt den echten oder den Demo-Adapter.

Demo

Der Vite-Modus demo ersetzt die API durch web/src/demo/api.js. Füge niemals eine Umgehung hinzu, durch die dieser Build das echte Backend erreichen könnte.