Files
nexa/docs/04-integration-matrix.md
T
Claude e1c2ba96e2 Resolve Q4/Q5/Q13/Q14/Q18: Obsidian via Nextcloud WebDAV, Karakeep, Octoprint suppress
- Q4 → Obsidian vault is the Notizen/ folder in Nextcloud (multi-device sync).
  Nexa reads via WebDAV using the existing NC_APP_PASSWORD — no filesystem
  mount. Ignore list pinned: .copilot/, .copilot-index/, .smart-env/,
  .caldav-sync/, assets/ (routed to Phase-3.2 visual queue), Templates/,
  BMO/, Excalidraw/. Index target: Notizen/**/*.md.
- Q5 → canonical name is Karakeep; legacy Zoraxy alias hoarder.nuclide.systems
  kept for compatibility.
- Q13 → Octoprint container is intentionally powered down most of the time.
  Phase-5 monitoring must skip names matching octoprint*. Reflected in
  docs/10 monitoring table and CLAUDE.md.
- Q14 → Homepage Zoraxy widget config error; cosmetic, dropped from open
  questions and from docs/12 optimization list.
- Q18 → SAIA does proxy embeddings but rate limit is 10 msg/min, unusable
  for ingest. TEI stays in Phase 3.1.
- docs/12: stale items removed (Octoprint, Zoraxy widget, generic Immich
  vector idea); added new ones derived from the Obsidian discovery (plugin
  embedding collision, notify_push upgrade path, assets/ size note).
- docs/04 integration matrix updated to describe Obsidian-via-Nextcloud
  read path explicitly.
- docs/09 step-4 credentials list collapses NC Tasks / Calendar / WebDAV
  onto a single app password.
2026-05-04 21:55:47 +00:00

4.0 KiB

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 via Nextcloud & Qdrant)

  • Der Obsidian-Vault liegt im Nextcloud-Ordner Notizen/ (Multi-Device-Sync via Nextcloud-Client). Nexa liest read-only über WebDAV (/remote.php/dav/files/<user>/Notizen/) — kein Mount, kein zweiter Sync-Mechanismus.
  • Markdown-Dateien (Notizen/**/*.md) werden in Qdrant (nexa_knowledge_text) indiziert; Bilder unter assets/ landen im Phase-3.2-Visual-Queue (siehe docs/11/Q4).
  • Plugin-Internals (.copilot/, .smart-env/, .caldav-sync/, Templates/, BMO/, Excalidraw/) sind explizit von der Indizierung ausgeschlossen.
  • 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.