Die hier verlinkten Dokumente beschreiben die unterstützte aktuelle Architektur. Weitere Dateien in diesem Verzeichnis sind als historisch oder nicht normativ gekennzeichnet (Kopfzeile); sie dokumentieren Analysen, Pläne und Messläufe, keinen Vertrag.
- USER_GUIDE.md – UnoSim im Browser bedienen: Sketches, Simulation, Beispiele und Tutor.
- UnoSim-Examples – eigene Beispiele und Tutor-Inhalte erstellen.
Für einen ersten Klassenraum-Aufbau ist INSTALL_UBUNTU_VBOX.md der kürzeste Weg; für einen eigenen Reverse Proxy gilt INSTALL_SERVER.md.
- INSTALL_LOCAL.md – lokale Entwicklung mit lokaler Kompilierung und Simulation.
- INSTALL_SERVER.md – Docker-Deployment mit erforderlichem Gateway, optionaler Benutzeranmeldung und Docker-Sandboxen.
- INSTALL_UBUNTU_VBOX.md – Ubuntu-Desktop-Setup in VirtualBox mit Docker, Nginx, TLS und optionaler Benutzeranmeldung.
- SECURITY.md – Sicherheits- und Isolationsvertrag.
- RELEASE_RUNBOOK.md – Release-Gates und Betriebskontrollen.
- ARCHITECTURE.md – Komponenten, Datenflüsse und die beiden Runtime-Profile.
- EXTERNAL_API.md – versionierter iframe-/postMessage-Vertrag.
- TESTING_STANDARDS.md – Testklassen und Qualitätsgates.
- CAPACITY_MODEL.md – maßgebliches Kapazitätsmodell, Timeout-Grenzen und Kalibrierung.
- CAPACITY_VALIDATION_QUICKSTART.md – Ablauf der Validierung auf dem Staging-Host.
- CAPACITY_MIXED_LOAD_TESTING.md – gemischte Messung aus REST-Compiles, Simulationsstarts und laufenden Simulationen.
- CAPACITY_TEST_RESULTS.md – gemessene Referenzergebnisse.
- CAPACITY_HISTORICAL_PHASE_3_4.md – historische Kapazitätsmessung aus Phase 3.4 (nicht normativ).
- adr/ – akzeptierte Architekturentscheidungen.
- ../ssot/ – fachliche Single Sources of Truth für UI und Verhalten.
Bei Änderungen zuerst die zuständige normative Quelle aktualisieren.
- OPEN_POINTS.md – geprüfte offene Entscheidungen und zurückgestellte Punkte.
- archive/refactoring/ – Architektur- und
Gesundheitsbericht (Stand
54cc2950) und die daraus abgeleitete, abgeschlossene Refactoring-Serie. - archive/tutor-quality/ – abgeschlossene Pläne und Messberichte zur Tutor-Qualität. Normativ bleibt ../ssot/ssot_function_definition_TutorQualityEvaluation.md.
Erledigte Implementierungspläne werden gelöscht, nicht archiviert; sie bleiben in der Git-Historie.
Dateien im Wurzelverzeichnis heißen THEMA_INHALT.md in Großbuchstaben. Das
Präfix gruppiert zusammengehörige Dokumente (INSTALL_, CAPACITY_). ADRs
liegen unter adr/ als NNNN-titel.md. Fachliche SSOTs unter ../ssot/
heißen ssot_function_definition_<Thema>.md mit <Thema> in PascalCase;
nur die Agenten-Policy heißt ssot_agent_policy.md.