# Tolaria — Target Architecture Proposal (v1)

**Datum:** 2026-08-24/25 · **Autor:** Red Queen · **Modus:** VORSCHLAG — NOCH NICHT UMZUSETZEN

---

## 1. Zielbild

**TOLARIA SECOND BRAIN v1**: Tolaria als aufbereitetes, verknüpftes, semantisch auffindbares Wissenssystem, gespeist aus der versionierten Wahrheit im Forgejo-Repo, gepflegt von Red Queen als Knowledge Steward.

## 2. Grundprinzipien

1. **Forgejo = Source of Truth** (versioniert), Tolaria = derived, aufbereitete Sicht.
2. **Graph = derived view**, rebuildbar aus dem Markdown-Vault (nie primärer Store).
3. **Human-in-the-Loop** bei echten Wissenskonflikten (Christian entscheidet).
4. **Backup vor jeder Mutation**; Restore-Drill vor Transformation.
5. **Read-only Discovery → Plan → Freigabe → Build** (kein unkontrollierter Umbau).

## 3. Ziel-Komponenten

| Komponente | Zweck |
|------------|-------|
| **Source of Truth** | Forgejo-Repo `trading-system-docs` bleibt Master |
| **Knowledge Model** | strukturierte Typen (Frontmatter `type`/`tags`/`relations`), Konsistenz bei Modulen |
| **Search** | Keyword (bestehend) + **Hybrid** (Keyword + semantisch) |
| **Indexing / Semantic Search** | Embeddings + Vector-Store für Synonym-/Konzept-Treffer |
| **Conflict Detection** | automatische Erkennung divergenter Versionen (READ-ONLY-Verdacht, Human entscheidet) |
| **Duplicate Detection** | Erkennung EXACT/NEAR/VERSIONED Duplikate |
| **Freshness** | Sync Forgejo→Tolaria; Erkennung veralteter Einträge |
| **Forgejo Integration** | git-basierte Synchronisierung (Polling/Pull), kein Webhook-Pflicht |
| **Knowledge Graph** | derived view aus Vault-Links + Struktur |
| **Graph UI** | Obsidian-artige Ansicht (Zoom/Pan/Cluster/Suche/Filter) |
| **Red Queen Steward** | konsolidiert, pflegt, konflikt-erkennt, hält Sync |
| **Human-in-the-Loop** | Freigabegates bei Merge/Konflikt/Löschung |
| **Backup/Rollback** | Git-Tags + Snapshot; getesteter Restore |
| **Security** | Secret-Scan, Auth bei Schreib-API, kein Leak |
| **Benchmarking** | Such-/Sync-/Graph-Regression-Suite |

## 4. Abgrenzung

- Der Graph ist **nicht** die Source of Truth.
- Es wird **kein** unbounded autonomer Umbau angestrebt; jeder Build-Schritt läuft über die bestehende Safety-/Retry-/Checker-Architektur (A1–A5).