MindSift/README.md

🧠 MindSift

Der Kopf frei in drei Sekunden.

MindSift ist deine zentrale Schaltstelle für spontane Gedanken, strukturierte Aufgaben, vernetztes Wissen und gemeinsame Echtzeit-Listen — kompromisslos schnell, ablenkungsfrei gestaltet und zu 100 % unter deiner eigenen Kontrolle.

Philosophie • Funktionen • Für wen? • Schnellstart

---

💡 Die Philosophie: Erst raus aus dem Kopf – später sortieren

Klassische Produktivitäts- und Notiz-Apps scheitern im Alltag oft an derselben Hürde: Sie verlangen Struktur im falschen Moment.
Wenn dir mitten im Gespräch, unterwegs oder kurz vor dem Feierabend ein wichtiger Gedanke kommt, willst du keinen Ordner auswählen, keine Datenbank-Eigenschaften pflegen und kein Formular ausfüllen. Du willst den Gedanken in drei Sekunden loswerden – und sicher sein, dass er nicht verloren geht.

MindSift trennt das Erfassen radikal vom Organisieren:

1. Sofort abladen (Quick Dump): Oben in der Eingabeleiste tippen, Enter drücken, fertig. Dein Kopf ist wieder frei. Wer möchte, kann einen Eintrag aber auch direkt bei der Eingabe einer Aufgabenliste, einer Einkaufsliste oder einer Notiz zuordnen.
2. Spielerisch sichten (Triage): Wenn du später Ruhe hast, arbeitest du deinen Gedanken-Stapel Karte für Karte durch. Nach links verwerfen, auf „Später“ schieben oder mit einem Klick in eine echte Aufgabe, ein Dokument oder einen Listeneintrag verwandeln.
3. Nahtlos weiterarbeiten: Aus flüchtigen Ideen werden strukturierte Aufgaben-Boards, verlinkte Wiki-Dokumente oder geteilte Listen für Familie und Team.

---

✨ Was MindSift auszeichnet

⚡ Quick-Dump & Triage-Deck

• Immer griffbereit: Die Schnell-Eingabeleiste sitzt prominent ganz oben – jederzeit erreichbar per Klick oder Tastendruck (C oder /).
• Entscheiden ohne Stress: Im Triage-Deck siehst du immer genau eine Karte im Fokus, während darunter deine Warteschlange bereitliegt. Bearbeite den Text direkt auf der Karte, vergib ein Fälligkeitsdatum oder sortiere ihn per Swipe und Tastatur-Kürzel weg.

✅ Aufgabenlisten & Kanban-Board

• Mehrere Aufgabenlisten: Trenne Berufliches, Privates, Projekte oder gemeinsame Team-Aufgaben sauber in eigenen Listen.
• Liste oder Kanban: Wechsle jederzeit mit einem Klick zwischen einer kompakten Listenansicht und einem übersichtlichen 3-Spalten-Kanban-Board (Zu erledigen, In Bearbeitung, Erledigt).
• Detailtiefe bei Bedarf: Füge Aufgaben Fälligkeiten, Prioritäten und ausführliche Notizen hinzu – oder wandle eine wachsende Aufgabe direkt in ein großes Workspace-Dokument um.

📝 Workspace: Komfort wie in Word, gespeichert als echtes Markdown

• Formatieren auf Knopfdruck: Nutze die übersichtliche Werkzeugleiste für Überschriften, Fett/Kursiv, Checklisten, Code-Blöcke, Hervorhebungen, Tabellen und Fortschrittsbalken – ganz ohne Markdown-Befehle auswendig lernen zu müssen.
• Vernetztes Wiki: Verknüpfe Dokumente untereinander über interne [[Wiki-Links]] und organisiere dein Wissen in einer klaren Ordner- und Unterordner-Struktur.
• Volle Datenhoheit (Kein Lock-in): Jedes Dokument wird im Hintergrund als saubere, standardisierte .md-Datei in deiner Ordnerstruktur auf der Festplatte abgelegt. Du kannst deine Notizen jederzeit direkt aus dem Dateisystem kopieren, sichern oder mit anderen Programmen nutzen.

🛒 Geteilte Echtzeit-Listen

• Gemeinsam abhaken: Ob Wocheneinkauf, Packliste für den Urlaub oder Checkliste fürs Projekt – teile Spaces per Einladungscode mit Partnern, Familie oder Kollegen.
• Live-Synchronisation: Hakst du im Supermarkt einen Artikel ab, verschwindet er im selben Augenblick auf den Bildschirmen aller anderen Mitglieder.

🏢 Organisationen, Teams & Berechtigungskonzept

• Geführte Ersteinrichtung: Beim ersten Start begrüßt dich ein Einrichtungs-Assistent, mit dem du dein Administrator-Konto und die Sicherheitseinstellungen deines Servers festlegst.
• Geschlossene Gesellschaft oder offenes Team: Schalte die öffentliche Registrierung ab und vergib gezielte Einladungscodes, oder lege Benutzer direkt über die Administration an.
• Drei klare Rollen: Unterscheide zwischen Server-Admin (volle Server- und Mail-Steuerung), Team-Admin (darf Nutzer einladen sowie Organisationen und Teams verwalten) und Mitglied.
• Sichtbarkeits-Isolation nach Maß: Bestimme als Administrator zentral, ob Nutzer komplett isoliert für sich arbeiten (Strikt Privat), nur Mitglieder ihrer eigenen Teams sehen (Teams isoliert) oder serverweit zusammenarbeiten (Offen).

🔔 Multi-Channel-Alarme & Eigene Webhooks

• Keine Frist mehr verpassen: Lass dich vor Fälligkeit einer Aufgabe automatisch benachrichtigen – frei wählbar per E-Mail, Discord-Nachricht oder eigenem Webhook.
• Offen für deine Automatisierung: Erzeuge persönliche API-Schlüssel in deinen Kontoeinstellungen und schicke System-Alarme, Server-Statusmeldungen oder eigene Skripte per einfachem curl-Befehl direkt als Aufgabe oder Notiz in dein MindSift.

🖤 Fokussiertes, eckiges Dark-Design

• Ruhe fürs Auge: Ein klares, monochromes dunkles Design mit präzisen Kanten und einer einzigen, gezielt eingesetzten Akzentfarbe. Keine Ablenkung, keine überladenen Menüs, volle Konzentration auf deine Inhalte.

---

👥 Für wen ist MindSift gemacht?

• Für Vielbeschäftigte & Kreative, die tagsüber hunderte Gedanken, To-Dos und Links im Kopf jonglieren und ein System suchen, das schneller ist als jede klassische Notiz-App.
• Für Familien, Paare & WGs, die gemeinsame Einkaufslisten, Erledigungen und Planungen ohne Werbe-Apps und ohne fremde Cloud synchronisieren möchten.
• Für Teams, Selbstständige & Homelab-Enthusiasten, die Aufgaben, Projektdokumentation, Server-Webhooks und Benutzerrechte souverän auf der eigenen Infrastruktur betreiben wollen.

---

🚀 In 60 Sekunden starten

MindSift läuft als einzelner, ressourcenschonender Container und bringt alles mit, was du brauchst.

Start mit Docker Compose

Lege eine docker-compose.yml an:

services:
  mindsift:
    image: git.dsit.me/sandrodach/mindsift:dev
    container_name: mindsift
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - PORT=8080
      - DATA_DIR=/data
      - JWT_SECRET=bitte-hier-ein-langes-sicheres-geheimnis-eintragen
      - ALLOW_REGISTRATION=false
      # Optional: Eigener SMTP-Server für E-Mail-Alarme
      # (kann alternativ auch später direkt in der Admin-Oberfläche eingetragen werden)
      - SMTP_HOST=
      - SMTP_PORT=587
      - SMTP_USER=
      - SMTP_PASS=
      - SMTP_FROM=
      - SMTP_TLS=true

Container starten:

docker compose up -d

Öffne anschließend http://localhost:8080 im Browser. Beim allerersten Aufruf führt dich MindSift automatisch durch die Ersteinrichtung für dein Administrator-Konto.

---

🔒 Deine Daten gehören dir

• 100 % Self-Hosted: Keine externen Cloud-Dienste, keine versteckte Telemetrie, kein Tracking.
• Portabel & Transparent: Alle Workspace-Notizen liegen als lesbare Markdown-Dateien im Datenverzeichnis; zusätzlich kannst du jederzeit ein komplettes Backup deiner Daten als JSON-Datei herunterladen.

---

📄 Lizenz

Veröffentlicht unter der MIT-Lizenz – siehe LICENSE.

_{Gebaut für maximale Klarheit, Geschwindigkeit und digitale Souveränität.}