website/README.md

MindMapProjekt - Roadmap

Projektübersicht

Das MindMapProjekt ist eine interaktive Plattform zum Visualisieren, Erforschen und Teilen von Wissen. Das Projekt wird umfassend überarbeitet, um ein modernes, benutzerfreundliches Design und erweiterte Funktionalitäten zu bieten.

Technischer Stack

• Backend: Python/Flask
• Frontend:
  • Tailwind CSS für moderne UI
  • SVG-Bibliotheken für Visualisierungen (D3.js)
  • JavaScript/Alpine.js für interaktive Komponenten
• Datenbank: SQLite mit SQLAlchemy
• KI-Integration: OpenAI API für intelligente Assistenz

Installation und Verwendung

Installation

1. Repository klonen
2. Virtuelle Umgebung erstellen: python -m venv venv
3. Virtuelle Umgebung aktivieren:
   • Windows: venv\Scripts\activate
   • Unix/MacOS: source venv/bin/activate
4. Abhängigkeiten installieren: pip install -r requirements.txt
5. Datenbank initialisieren: python TOOLS.py db:rebuild
6. Admin-Benutzer erstellen: python TOOLS.py user:admin
7. Server starten: python TOOLS.py server:run

Standardbenutzer

• Admin-Benutzer: Username: admin / Passwort: admin
• Testbenutzer: Username: user / Passwort: user

Verwaltungswerkzeuge mit TOOLS.py

Das Projekt enthält ein zentrales Verwaltungsskript TOOLS.py, das verschiedene Hilfsfunktionen bietet:

Datenbankverwaltung

• python TOOLS.py db:fix - Reparieren der Datenbankstruktur
• python TOOLS.py db:rebuild - Datenbank neu aufbauen (löscht alle Daten!)
• python TOOLS.py db:test - Datenbankverbindung und Modelle testen
• python TOOLS.py db:stats - Datenbankstatistiken anzeigen

Benutzerverwaltung

• python TOOLS.py user:list - Alle Benutzer anzeigen
• python TOOLS.py user:create -u USERNAME -e EMAIL -p PASSWORD [-a] - Neuen Benutzer erstellen
• python TOOLS.py user:admin - Admin-Benutzer erstellen (admin/admin)
• python TOOLS.py user:reset-pw -u USERNAME -p NEWPASSWORD - Benutzerpasswort zurücksetzen
• python TOOLS.py user:delete -u USERNAME - Benutzer löschen

Serververwaltung

• python TOOLS.py server:run [--host HOST] [--port PORT] [--no-debug] - Entwicklungsserver starten

Für detaillierte Hilfe: python TOOLS.py -h

Roadmap der Überarbeitung

Phase 1: Grundlegende Infrastruktur ✅

• Bestandsaufnahme des aktuellen Projekts
• Erstellung der Roadmap
• Aktualisierung der Abhängigkeiten
• Integration von Tailwind CSS
• Einrichtung der SVG-Bibliotheken (D3.js)
• Favicon erstellen
• Setup-Skript für einfache Installation

Phase 2: Design-Überarbeitung 🔄

• Implementierung des Dark Mode
• Erstellung eines modernen, minimalistischen UI mit Tech-Ästhetik
• Responsive Design für alle Geräte
• Gestaltung der Landing Page mit großer Typografie

Phase 3: Mindmap-Funktionalitäten 🔄

• Verbesserte Visualisierung mit SVG und D3.js
• Implementierung der Mouseover-Funktion
• Entwicklung der Suchfunktion für Knoten
• Tagging-System für Inhalte
• Quellenmanagement und -verlinkung
• Upload-Funktionalität an Knotenpunkten

Phase 4: Kernseitenentwicklung

• Überarbeitung der Startseite mit neuen Features
• Entwicklung der "Wer sind wir?"-Seite
• Implementierung von Impressum und Datenschutzerklärung
• Erstellung der Kontaktseite mit FAQs
• Überarbeitung des Benutzerprofilbereichs

Phase 5: Community-Features

• Entwicklung des Autorenbereichs
• Implementierung von Community-Bereichen für Themenbereiche
• Verbesserter Kommentarbereich
• Benutzerrechtemanagement

Phase 6: KI-Integration

• Implementierung des Frage-Antwort-Systems
• KI-generierte Themeneinleitungen
• Intelligente Suchunterstützung
• Geführte Pfade durch Themenbereiche
• Vorgeschlagene Chat-Möglichkeiten

Phase 7: Benutzerprofilfunktionen

• Speichern von Thematiken
• Persönliche Mindmap/Pinboard
• Beitragsmanagement
• Benutzerstatistiken und -aktivitäten

Phase 8: Testing und Optimierung

• Umfassende Tests aller Funktionen
• Performance-Optimierung
• SEO-Implementierung
• Barrierefreiheit prüfen und verbessern

Phase 9: Dokumentation und Einführung

• Erstellung von Benutzeranleitungen
• Entwicklerdokumentation
• Administratorenhandbuch
• Guided Tour für neue Benutzer

Aktueller Status

• Phase 1: ✅ Abgeschlossen
• Phase 2: 🔄 In Bearbeitung (75% abgeschlossen)
• Phase 3: 🔄 In Bearbeitung (50% abgeschlossen)

Aktuelle Fortschritte

• Grundlegende UI modernisiert mit Tailwind CSS und Dark Mode
• Neues Favicon für bessere visuelle Identität erstellt
• Setup-Prozess vereinfacht mit einem Shell-Skript
• Mindmap-Visualisierung komplett überarbeitet mit D3.js für eine interaktivere Erfahrung
• Responsive Design für optimale Darstellung auf allen Geräten

Nächste Schritte

• Fertigstellung der Landing Page
• Erstellung der "Wer sind wir?"-Seite
• Implementierung des Tagging-Systems für Gedanken
• Verbesserung der Gedankenansicht im Mindmap-Bereich

Zuletzt aktualisiert: 01.06.2024