📦 Inventarium

Eine moderne Inventarverwaltung mit KI-Unterstützung und intuitiver Benutzeroberfläche. Entwickelt von daMustermann.

✨ Features

• 🎨 Modernes, responsives Design mit Dark Mode
• 🤖 KI-gestützte Vorschläge für Artikelbeschreibungen
• 🔍 Integrierte Bildersuche für Artikel
• 📊 Detaillierte Statistiken und Visualisierungen
• 📱 Optimiert für Desktop und Mobile
• 🔄 Einfache Artikel-Verwaltung (Hinzufügen, Bearbeiten, Löschen)
• 📷 Bildverwaltung mit automatischer Optimierung
• 💾 Backup & Restore System für alle Daten
• 🔐 Sichere Speicherung von API-Keys und Einstellungen

🚀 Installation

Windows

1. Python installieren

   • Laden Sie Python 3.8 oder höher von python.org herunter
   • Aktivieren Sie bei der Installation die Option "Add Python to PATH"

2. Repository klonen

   git clone https://github.com/daMustermann/Inventarium.git
   cd Inventarium

3. Virtuelle Umgebung erstellen und aktivieren

   python -m venv venv
   .\venv\Scripts\activate

4. Abhängigkeiten installieren

   pip install -r requirements.txt

Linux/Raspberry Pi

1. Erforderliche Pakete installieren

   sudo apt update
   sudo apt install python3 python3-pip python3-venv git

2. Repository klonen

   git clone https://github.com/daMustermann/Inventarium.git
   cd Inventarium

3. Virtuelle Umgebung erstellen und aktivieren

   python3 -m venv venv
   source venv/bin/activate

4. Abhängigkeiten installieren

   pip install -r requirements.txt

⚙️ Konfiguration

1. Umgebungsvariablen einrichten (optional für erweiterte Funktionen)

   • Starten Sie die Anwendung
   • Gehen Sie zu "Einstellungen"
   • Tragen Sie Ihre API-Schlüssel für die gewünschten Zusatzfunktionen ein:
     • GEMINI_API_KEY (optional, für KI-Vorschläge)
     • GOOGLE_API_KEY und GOOGLE_CSE_ID (optional, für Bildersuche)
   • Klicken Sie auf "Einstellungen speichern"

   Hinweis: Die Kernfunktionen der Anwendung sind auch ohne API-Schlüssel verfügbar. Die API-Schlüssel werden nur für die KI-Vorschläge und die Bildersuche benötigt.

2. Anwendung starten

   Entwicklungsserver (app.py)

   python app.py

   • Vorteile:
     • Auto-Reload bei Code-Änderungen
     • Detaillierte Debug-Informationen
     • Interaktive Debugger-Konsole
   • Nachteile:
     • Nicht für Produktivbetrieb geeignet
     • Eingeschränkte Performance
     • Keine Sicherheitsoptimierungen
   • Verwendung:
     • Während der Entwicklung
     • Zum Testen von Änderungen
     • Für lokale Debugging-Zwecke

   Die Anwendung ist unter http://localhost:5000 erreichbar.

   Produktionsserver (wsgi.py)

   python wsgi.py

   • Vorteile:
     • Optimierte Performance
     • Multi-Threading Support
     • Robuste Fehlerbehandlung
     • Sicherheitsoptimierungen
     • Im lokalen Netzwerk erreichbar
   • Nachteile:
     • Kein Auto-Reload
     • Weniger Debug-Informationen
   • Verwendung:
     • Im Produktivbetrieb
     • Für den dauerhaften Einsatz
     • Wenn mehrere Benutzer zugreifen

   Die Anwendung ist erreichbar unter:

   • Lokal: http://localhost:5000 oder http://127.0.0.1:5000
   • Netzwerk: http://<Server-IP>:5000 (ersetzen Sie mit der IP-Adresse des Servers)

   Um die IP-Adresse des Servers zu finden:

   • Windows: ipconfig in der Kommandozeile
   • Linux: ip addr oder ifconfig im Terminal
   • Raspberry Pi: hostname -I im Terminal

📱 Funktionen

Artikel verwalten

• Artikel hinzufügen:

  • Klicken Sie auf "Artikel hinzufügen"
  • Füllen Sie die Pflichtfelder aus
  • Nutzen Sie die KI für Beschreibungsvorschläge
  • Fügen Sie ein Bild hinzu (Upload oder Bildersuche)

• Artikel bearbeiten:

  • Klicken Sie auf einen Artikel
  • Wählen Sie "Bearbeiten"
  • Aktualisieren Sie die gewünschten Felder

• Artikel löschen:

  • Öffnen Sie die Artikeldetails
  • Klicken Sie auf "Löschen"
  • Bestätigen Sie die Aktion

KI-Funktionen

• Beschreibungsvorschläge:

  • Geben Sie den Artikelnamen ein
  • Klicken Sie auf "KI-Vorschläge generieren"
  • Wählen Sie einen passenden Vorschlag aus

• Bildersuche:

  • Klicken Sie auf "Nach Bildern suchen"
  • Geben Sie Suchbegriffe ein
  • Wählen Sie ein passendes Bild aus

Backup & Restore

• Backup erstellen:

  • Gehen Sie zu "Einstellungen"
  • Klicken Sie auf "Backup herunterladen"
  • Das Backup enthält:
    • Alle Datenbank-Einträge
    • Alle Bilder
    • Alle Einstellungen (.env Datei)

• Backup wiederherstellen:

  • Gehen Sie zu "Einstellungen"
  • Wählen Sie eine Backup-Datei aus
  • Klicken Sie auf "Wiederherstellen"
  • Das System wird automatisch neu geladen

Statistiken

• Klicken Sie auf "Statistiken" für:
  • Gesamtübersicht der Artikel
  • Verteilung nach Kategorien
  • Verteilung nach Standorten
  • Systemstatistiken
  • Bildabdeckung
  • Speichernutzung

🎨 Design-Anpassung

• Dark Mode optimiert für bessere Lesbarkeit
• Responsive Design für alle Bildschirmgrößen
• Optimierte Darstellung auf mobilen Geräten
• Verbesserte Kontraste und Farbschema

🔧 Fehlerbehebung

Häufige Probleme

1. Datenbank-Fehler

   • Stellen Sie sicher, dass der instance Ordner existiert
   • Überprüfen Sie die Schreibrechte

2. API-Fehler

   • Überprüfen Sie die API-Schlüssel in der .env Datei
   • Stellen Sie sicher, dass die APIs aktiviert sind

3. Bildupload-Probleme

   • Überprüfen Sie die Schreibrechte im static/uploads Ordner
   • Maximale Bildgröße beachten (10MB)

4. Backup/Restore-Probleme

   • Stellen Sie sicher, dass genügend Speicherplatz vorhanden ist
   • Überprüfen Sie die Schreibrechte für die .env Datei
   • Backup-Datei muss im ZIP-Format sein

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Details finden Sie in der LICENSE Datei.

🤝 Mitwirken

Beiträge sind willkommen! Bitte lesen Sie CONTRIBUTING.md für Details.

📞 Support

Bei Fragen oder Problemen:

• Erstellen Sie ein Issue auf GitHub