Claude
9b18e2710d
- /docs/ now contains 12 numbered guides + index.md (navigator).
- Old duplicates removed: nexa-core/doc/, DEPLOYMENT.md, PLAN.md,
config/{classification_logic,workflows_spec}.md.
- 09-deployment.md targets the running infra (LXC 104 docker host,
Zoraxy at 192.168.1.4, existing Memos/n8n/LiteLLM/Nextcloud/Qdrant)
rather than spinning a parallel stack; minimal-config approach.
- 11-open-questions.md tracks user-info-required blockers.
- 12-optimization-opportunities.md captures homelab tweaks.
- CLAUDE.md added so future agent runs know repo conventions and infra.
79 lines
3.4 KiB
Markdown
79 lines
3.4 KiB
Markdown
# 04 — Integrations-Matrix
|
|
|
|
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. |