nexa/nexa-core/doc/integration_matrix.md

🔗 Nexa Integrations-Matrix (V2)

Diese Matrix definiert die logische Trennung zwischen privaten und beruflichen Datenströmen sowie die Anbindung der Infrastruktur.

---

1. Die Dualität: Arbeit vs. Privat

Nexa muss strikt zwischen zwei Kontexten unterscheiden, da die Datenquellen variieren:

A. Bereich: ARBEIT (Work)

• Sichtbarkeit: Eingeschränkt (kein Zugriff auf Arbeits-E-Mails oder Firmen-Server).
• Datenquellen:
  • Separate Nextcloud Task-Liste (Work_Tasks).
  • Separater Nextcloud Kalender (Work_Calendar).
  • Memos mit Tag #work oder semantischer Erkennung.
• Nexa-Fokus: Timeblocking, Fokus-Zeiten, Vorbereitung von Meetings basierend auf Obsidian-Notizen.

B. Bereich: PRIVAT (Personal)

• Sichtbarkeit: Vollständig.
• Datenquellen:
  • Nextcloud Task-Liste (Personal_Tasks).
  • Haupt-Kalender.
  • E-Mails (IMAP - 20 Mails/Tag).
  • Bluesky, RSS, Karakeep.
• Nexa-Fokus: Automatisierung des Alltags, Kuratierung von Wissen, E-Mail-Management.

Karakeep & Shopping-Logik

• Schnittstelle: Karakeep API / RSS.
• Listen-Routing:
  • Einkaufsliste: Automatischer Sync für Items mit hoher Frequenz (Lebensmittel, Drogerie).
  • Wunschliste: Speicherort für "Entdeckungen". Nexa fügt bei Wunschlisten-Items automatisch den aktuellen Preis und eine kurze SAIA-Zusammenfassung hinzu ("Warum du das speichern wolltest").
• Review-Cycle: Einmal im Monat fragt Nexa bei Wunschlisten-Items nach: "Immer noch interessiert oder kann das weg?"

---

2. Kern-Infrastruktur (The Brain & Spine)

Komponente	Rolle im System
Memos	Zentraler Input (Drafts, Ideen, schnelle Tasks). Schnittstelle für Nexa-Antworten.
n8n	Logik-Engine. Führt die Klassifizierung Arbeit vs. Privat durch.
SAIA (LiteLLM)	Entscheidet anhand des Inhalts, in welchen Kalender/Liste ein Eintrag gehört.
Qdrant	Langzeitgedächtnis. Speichert Projektwissen (Work) und privates Wissen getrennt.
Arcane	Verwaltung der Docker-Container (n8n, Qdrant, Memos).

---

3. Spezifische Datenflüsse & Logik

Task-Routing (Das Gehirn-Filter)

1. Input: Neues Memo oder Spracheingabe.
2. Analyse: SAIA prüft: "Ist das Business oder Privat?"
3. Routing: * Arbeits-Kontext -> Eintrag in Work_Tasks.
   • Privat-Kontext -> Eintrag in Personal_Tasks.
4. Timeboxing: Nexa scannt den Work_Calendar auf Lücken und schlägt Slots für Work_Tasks vor.

E-Mail Management (Nur Privat)

• Nexa filtert die 20 täglichen Privat-Mails.
• Wichtige private Termine werden in den privaten Kalender extrahiert.
• Newsletter landen als Zusammenfassung in Memos.

Wissens-Management (Obsidian & Qdrant)

• Obsidian-Notizen (Arbeit & Privat) werden in Qdrant indiziert.
• Nexa nutzt dieses Wissen, um Arbeits-Tasks besser zu beschreiben, auch wenn sie keinen Zugriff auf die Arbeits-E-Mails hat.

---

4. Monitoring & Hardware (Home Assistant)

Dienst	Reiz-Typ	Nexa-Reaktion
Home Assistant	Voice / Sensorik	Nexa nimmt Sprachbefehle entgegen und meldet Alarme (Haus).
Proxmox	Stabilität	Meldung an Nexa bei Hardware-Problemen.
S3 Server	Archiv	Langzeit-Backups der Wissensdatenbank.

---

5. Ergänzungen für das Setup (Vorschlag)

• Zwei-Faktor-Klassifizierung: Einführung von expliziten Tags (#w für Work, #p für Privat) für Grenzfälle, in denen SAIA den Kontext nicht eindeutig bestimmen kann.