initial commit

nexa-core/doc/scope.md

@@ -0,0 +1,80 @@
+📑 Projekt Nexa: Scoping & Vision
+1. Vision & Zielsetzung
+Nexa ist als "Zentrales Nervensystem" konzipiert. Das Ziel ist die Schaffung einer intelligenten Middleware zwischen Input-Quellen (Memos, E-Mail, RSS), Wissensspeichern (Obsidian, Qdrant) und Organisations-Tools (Nextcloud Calendar/Tasks).
+
+Kernziele:
+Kognitive Entlastung: Nexa sortiert, filtert und schlägt vor, anstatt nur zu speichern.
+
+Kontext-Trennung: Saubere, KI-gestützte Unterscheidung zwischen Privat und Arbeit.
+
+Single Point of Interaction: Memos fungiert als primäre Schnittstelle ("The Voice & Ear").
+
+Wissens-Synergie: Verknüpfung von flüchtigen Memos mit tiefem Wissen in Obsidian via semantischer Suche.
+
+2. Abgrenzung (Scope)
+Um die Komplexität beherrschbar zu halten, wird das Projekt wie folgt abgegrenzt:
+
+In-Scope (Was Nexa tut):
+Triaging: Klassifizierung von 20 Mails/Tag (Privat).
+
+Task-Routing: Verteilung von Aufgaben auf die richtige Nextcloud-Liste (Work vs. Personal).
+
+Scheduling: Vorschlagen von Timeboxen im Arbeitskalender.
+
+Memory: Aufbau eines Langzeitgedächtnisses in Qdrant.
+
+Monitoring: Aggregation kritischer IT-Alarme (Proxmox, Backrest).
+
+Out-of-Scope (Was Nexa NICHT tut):
+Kein direkter Zugriff auf Arbeits-IT (E-Mail/Server).
+
+Keine aktive Bearbeitung von Dokumenten (außer Metadaten-Extraktion).
+
+Keine Ersetzung von Spezial-UIs (z.B. Arcane oder Portainer für Container-Management).
+
+3. Phasenmodell der Entwicklung
+Der Aufbau erfolgt iterativ, um frühzeitig Mehrwert zu generieren.
+
+Phase 1: Die Wirbelsäule (Konnektivität)
+Fokus: Datenfluss zwischen Memos, n8n und SAIA.
+
+Meilenstein: Nexa antwortet auf Memos und kann einfache Fragen beantworten.
+
+Technik: Webhooks, REST-API, LiteLLM-Proxy.
+
+Phase 2: Sensorik & Klassifizierung (The Senses)
+Fokus: E-Mail-Filterung und das Routing-System.
+
+Meilenstein: Nexa erkennt den Unterschied zwischen "Arbeits-Task" und "Privat-Task" ohne manuelle Tags.
+
+Technik: IMAP-Node, n8n-Logic-Router, System-Prompts für Kontext-Analyse.
+
+Phase 3: Das semantische Gedächtnis (The Brain)
+Fokus: Anbindung von Qdrant und Obsidian.
+
+Meilenstein: RAG (Retrieval Augmented Generation). Nexa beantwortet Fragen basierend auf deinen archivierten Notizen.
+
+Technik: Embeddings-Pipeline, Qdrant-Vektor-Suche.
+
+Phase 4: Proaktive Motorik (The Assistant)
+Fokus: Kalender-Integration und Timeboxing.
+
+Meilenstein: Nexa schlägt morgens proaktiv Fokus-Zeiten im Arbeitskalender vor.
+
+Technik: Nextcloud CalDAV/CardDAV Integration, Optimierungs-Logik für freie Slots.
+
+Phase 5: Physische Präsenz (Voice & Alarms)
+Fokus: Home Assistant Voice & Monitoring-Integration.
+
+Meilenstein: Nexa spricht über HA-Voice und meldet kritische Systemzustände proaktiv.
+
+Technik: Home Assistant API, Wyoming Protocol, ntfy/Memos-Push.
+
+4. Erfolgsmetriken
+Woran merken wir, dass Nexa funktioniert?
+
+Reduktion der Mail-Interaktion: Weniger Zeit in der Mail-App, mehr Fokus auf den Nexa-Digest.
+
+Kalender-Füllrate: Fokus-Slots für Arbeit sind automatisch geblockt.
+
+Such-Geschwindigkeit: Informationen aus alten Memos/Obsidian werden via #ask sofort gefunden.