Commit 4c9e2b

2026-02-23 11:58:00 Manuel Weiser: docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.

/dev/null .. docs/de/01-einleitung.md
@@ 0,0 1,14 @@
+	# 1. Einleitung
+
+	**FilaMan** ist eine webbasierte Verwaltungssoftware für **3D-Drucker-Filamente**. Mit FilaMan behalten Sie stets den Überblick über Ihren gesamten Filamentbestand:
+
+	- Welche Filamente und Spulen (Rollen) Sie besitzen
+	- Wie viel Filament auf jeder Spule noch verfügbar ist
+	- Wo Ihre Spulen gelagert sind
+	- Welche Drucker mit welchem Filament verwendet werden
+
+	FilaMan ist mehrbenutzer-fähig und unterstützt rollenbasierte Zugriffskontrolle, damit jeder Nutzer nur die für ihn relevanten Bereiche sehen und bearbeiten kann.
+
+	---
+
+	← [Zurück zum Inhaltsverzeichnis](./README.md) | [Weiter: Anmeldung →](./02-anmeldung.md)
/dev/null .. docs/de/02-anmeldung.md
@@ 0,0 1,19 @@
+	# 2. Anmeldung (Login)
+
+	Rufen Sie die FilaMan-Anwendung in Ihrem Browser auf. Sie werden automatisch zur Anmeldeseite weitergeleitet, wenn Sie noch nicht eingeloggt sind.
+
+	
+
+	**Anmeldefelder:**
+	- **E-Mail** – Ihre registrierte E-Mail-Adresse
+	- **Passwort** – Ihr persönliches Passwort
+
+	Klicken Sie nach der Eingabe auf **„Sign in"**, um sich anzumelden.
+
+	> 💡 **Hinweis:** Wenn Sie Ihr Passwort vergessen haben, wenden Sie sich an Ihren Systemadministrator. Eine Passwortzurücksetzung ist über den Admin-Bereich möglich.
+
+	Nach erfolgreicher Anmeldung gelangen Sie direkt zum **Dashboard**.
+
+	---
+
+	← [Zurück: Einleitung](./01-einleitung.md) | [Weiter: Navigation & Benutzeroberfläche →](./03-navigation.md)
/dev/null .. docs/de/03-navigation.md
@@ 0,0 1,44 @@
+	# 3. Navigation & Benutzeroberfläche
+
+	
+
+	Die Benutzeroberfläche von FilaMan ist in zwei Hauptbereiche aufgeteilt:
+
+	## Seitenleiste (linke Navigation)
+
+	Die Seitenleiste enthält alle Hauptmenüpunkte:
+
+	| Symbol | Menüpunkt | Beschreibung |
+	|--------|-----------|--------------|
+	| 🟩 | **Dashboard** | Übersichtsseite mit Statistiken |
+	| 📊 | **Manufacturers** | Herstellerverwaltung |
+	| 🔵 | **Filaments** | Filamentverwaltung |
+	| ⭕ | **Spools** | Spulenverwaltung (Bestand) |
+	| 🗂️ | **Locations** | Lagerortverwaltung |
+	| 🖨️ | **Printers** | Druckerverwaltung |
+	| 🛡️ | **Admin Panel** | Administration (nur für Admins) |
+
+	Am unteren Rand der Seitenleiste befinden sich:
+	- Ihr **Benutzername** und Ihre **Rolle**
+	- Das **⚙️ Einstellungs-Symbol** (führt zu den persönlichen Einstellungen)
+	- Das **→ Abmelde-Symbol** (Logout)
+	- **Farbschema-Umschalter** (Default / Light / Dark)
+
+	## Hauptbereich (rechts)
+
+	Der Hauptbereich zeigt den Inhalt der aktuell gewählten Seite. Alle Seiten folgen einem einheitlichen Aufbau:
+	- **Seitentitel** oben links
+	- **Aktionsschaltflächen** oben rechts (z. B. „Add Spool")
+	- **Filter und Suche** unterhalb des Titels
+	- **Tabelle oder Kachelansicht** im Hauptbereich
+
+	## Farbschema wechseln
+
+	Unten links in der Seitenleiste können Sie zwischen drei Farbschemata wählen:
+	- **Default** – Dunkles Grün-Thema (Standard)
+	- **Light** – Helles Thema
+	- **Dark** – Dunkles Thema
+
+	---
+
+	← [Zurück: Anmeldung](./02-anmeldung.md) | [Weiter: Dashboard →](./04-dashboard.md)
/dev/null .. docs/de/04-dashboard.md
@@ 0,0 1,46 @@
+	# 4. Dashboard
+
+	**URL:** `http://localhost:4321/`
+
+	
+
+	Das Dashboard ist die Startseite von FilaMan und gibt Ihnen einen schnellen Überblick über den gesamten Filamentbestand.
+
+	## Statistik-Kacheln (oben)
+
+	| Kachel | Beschreibung |
+	|--------|--------------|
+	| **Total Spools** | Gesamtanzahl aller erfassten Spulen |
+	| **Filaments** | Anzahl der verschiedenen Filamenttypen |
+	| **Low & Empty Spools** | Spulen mit niedrigem (Low) und leerem (Empty) Füllstand |
+	| **Total Value (available)** | Gesamtwert des verfügbaren Filamentbestands |
+
+	## Warnsystem: Low Stock Spools
+
+	Die Kachel **„Low Stock Spools"** zeigt sofort, ob Spulen nachbestellt werden müssen:
+	- **Grüne Meldung** „All spools have sufficient filament" – kein Handlungsbedarf
+	- **Rote Meldung** – Liste der kritischen oder leeren Spulen wird angezeigt
+
+	## Statistik-Bereiche
+
+	| Bereich | Beschreibung |
+	|---------|--------------|
+	| **Manufacturers (non-empty)** | Auflistung der Hersteller mit noch vollen Spulen |
+	| **Filament Types** | Übersicht der verwendeten Filament-Typen |
+	| **Spool Status** | Visualisierung des Spulenstatus nach Kategorien |
+	| **Filament Statistics** | Weitere Statistiken über Ihr Filament |
+	| **Locations** | Übersicht der belegten Lagerorte |
+
+	## Spool Status – Füllstand-Kategorien
+
+	| Status | Farbe | Bedeutung |
+	|--------|-------|-----------|
+	| **Full** | Grün | > 75 % Füllstand |
+	| **Normal** | Blau | 50 – 75 % |
+	| **Low** | Gelb | Unter Mindestwert |
+	| **Critical** | Rot | < 50 % des Mindestwerts |
+	| **Empty** | Grau | 0 g – komplett leer |
+
+	---
+
+	← [Zurück: Navigation](./03-navigation.md) | [Weiter: Hersteller →](./05-hersteller.md)
/dev/null .. docs/de/05-hersteller.md
@@ 0,0 1,41 @@
+	# 5. Hersteller (Manufacturers)
+
+	**URL:** `http://localhost:4321/manufacturers`
+
+	
+
+	Auf der Herstellerseite verwalten Sie alle **Filament-Hersteller**, deren Produkte Sie im System erfassen möchten. Jeder Hersteller kann mehrere Filamente haben.
+
+	## Tabellenspalten
+
+	| Spalte | Beschreibung |
+	|--------|--------------|
+	| **NAME** | Bezeichnung des Herstellers |
+	| **URL** | Website des Herstellers (klickbarer Link) |
+	| **FILAMENTS** | Anzahl der vom Hersteller erfassten Filamenttypen |
+	| **SPOOLS** | Anzahl der Spulen dieses Herstellers im Bestand |
+	| **MATERIALS** | Verwendete Materialien (z. B. PLA, PETG, ABS) |
+	| **ACTIONS** | Bearbeiten / Löschen-Schaltflächen |
+
+	## Funktionen
+
+	### Hersteller suchen
+	Nutzen Sie die **Suchleiste** oben links, um Hersteller nach Name zu filtern.
+
+	### Nach Material filtern
+	Das Dropdown **„All Materials"** filtert die Herstellerliste nach einem bestimmten Filamentmaterial (z. B. nur PLA-Hersteller anzeigen).
+
+	### Hersteller hinzufügen
+	Klicken Sie oben rechts auf **„Add Manufacturer"**. Es öffnet sich ein Dialog/Formular mit folgenden Feldern:
+	- **Name** – Pflichtfeld: Herstellername (z. B. „Prusament")
+	- **URL** – Optionale Website-Adresse des Herstellers
+
+	### Hersteller bearbeiten
+	Klicken Sie in der Tabelle in der Spalte **ACTIONS** auf das **Stift-Symbol** neben einem Hersteller.
+
+	### Hersteller löschen
+	Klicken Sie in der Spalte **ACTIONS** auf das **Papierkorb-Symbol**. Ein Hersteller kann nur gelöscht werden, wenn ihm keine Filamente mehr zugeordnet sind.
+
+	---
+
+	← [Zurück: Dashboard](./04-dashboard.md) | [Weiter: Filamente →](./06-filamente.md)
/dev/null .. docs/de/06-filamente.md
@@ 0,0 1,46 @@
+	# 6. Filamente (Filaments)
+
+	**URL:** `http://localhost:4321/filaments`
+
+	
+
+	Die Filamentseite listet alle **Filamentprodukte** auf, die in Ihrem System hinterlegt sind. Ein Filament ist ein Produkt-Template (z. B. „Prusament PETG Galaxy Black 1.75 mm"), dem dann physische Spulen zugeordnet werden.
+
+	## Tabellenspalten
+
+	| Spalte | Beschreibung |
+	|--------|--------------|
+	| **DESIGNATION** | Bezeichnung/Name des Filaments |
+	| **COLORS** | Zugeordnete Farben (als farbige Kreise dargestellt) |
+	| **TYPE** | Materialtyp (z. B. PLA, PETG, ABS, TPU) |
+	| **DIAMETER** | Durchmesser der Spule in mm (z. B. 1.75 mm) |
+	| **MANUFACTURER** | Zugeordneter Hersteller |
+	| **SPOOLS** | Anzahl der vorhandenen Spulen dieses Filaments |
+
+	## Funktionen
+
+	### Filament suchen
+	Die **Suchleiste** durchsucht Bezeichnung, Farbe und Hersteller gleichzeitig.
+
+	### Filter
+	- **All Manufacturers** – Nur Filamente eines bestimmten Herstellers anzeigen
+	- **All Types** – Nach Materialtyp filtern (PLA, PETG, ABS usw.)
+	- **All Colors** – Nach Farbe filtern
+
+	### Filament hinzufügen
+	Klicken Sie auf **„Add Filament"** oben rechts. Das Formular enthält:
+	- **Designation** – Name/Bezeichnung des Filaments
+	- **Manufacturer** – Zugehöriger Hersteller (Dropdown)
+	- **Type** – Materialtyp
+	- **Diameter** – Durchmesser (Standard: 1.75 mm)
+	- **Colors** – Eine oder mehrere Farben zuordnen
+	- **Min. Weight** – Mindestgewicht (für die Low-Stock-Warnung)
+	- **Price per kg** – Preis für Wertberechnung (optional)
+	- **Article Number** – Artikelnummer (optional)
+
+	### Farbverwaltung
+	Über den Button **„Manage Colors"** oben rechts gelangen Sie zur [Farbverwaltung](./12-farbverwaltung.md), wo Sie Farben anlegen und verwalten können.
+
+	---
+
+	← [Zurück: Hersteller](./05-hersteller.md) | [Weiter: Spulen →](./07-spulen.md)
/dev/null .. docs/de/07-spulen.md
@@ 0,0 1,55 @@
+	# 7. Spulen (Spools)
+
+	**URL:** `http://localhost:4321/spools`
+
+	
+
+	Die Spulenseite zeigt den **physischen Filamentbestand** – also jede einzelne Spule, die Sie besitzen. Dies ist das zentrale Herzstück von FilaMan.
+
+	## Tabellenspalten
+
+	| Spalte | Beschreibung |
+	|--------|--------------|
+	| **ID** | Eindeutige interne ID der Spule |
+	| **FILAMENT** | Zugeordnetes Filamentprodukt (Bezeichnung + Farbe) |
+	| **MANUFACTURER** | Hersteller des Filaments |
+	| **MATERIAL** | Materialtyp (PLA, PETG, ABS usw.) |
+	| **STATUS** | Aktueller Füllstandstatus (Full / Normal / Low / Critical / Empty) |
+	| **REMAINING** | Restgewicht in Gramm |
+	| **LOCATION** | Aktueller Lagerort der Spule |
+
+	## Funktionen
+
+	### Suche
+	Durchsucht Filament, Hersteller und weitere Felder.
+
+	### Filter
+	FilaMan bietet umfangreiche Filtermöglichkeiten für Spulen:
+	- **All Statuses** – Nach Füllstandstatus filtern
+	- **All Locations** – Nur Spulen eines bestimmten Lagerorts anzeigen
+	- **All Manufacturers** – Nach Hersteller filtern
+	- **All Materials** – Nach Materialtyp filtern
+
+	### Gruppierung nach Filament
+	Mit dem Toggle **„Group by Filament"** können Spulen nach Filamentprodukt gruppiert angezeigt werden. Das gibt einen schnellen Überblick, wie viele Exemplare eines Filaments vorhanden sind.
+
+	### Spule hinzufügen
+	Klicken Sie auf **„Add Spool"** oben rechts. Das Formular enthält u. a.:
+	- **Filament** – Auswahl des zugehörigen Filamentprodukts
+	- **Location** – Lagerort der Spule
+	- **Initial Weight / Remaining Weight** – Startgewicht und aktuelles Restgewicht in Gramm
+	- **Purchase Price** – Kaufpreis (optional, für Wertberechnung)
+	- **Purchase Date** – Kaufdatum (optional)
+	- **Notes** – Freitextnotiz
+	- **Zusatzfelder** – Falls vom Administrator konfiguriert
+
+	### Spule bearbeiten
+	In der Aktionsspalte können Sie:
+	- ✏️ **Bearbeiten** – Spuleninformationen ändern (z. B. Restgewicht nach dem Druck aktualisieren)
+	- 🗑️ **Löschen** – Spule aus dem System entfernen
+
+	> 💡 **Tipp:** Aktualisieren Sie regelmäßig das Restgewicht Ihrer Spulen, damit das Dashboard und die Low-Stock-Warnungen korrekte Werte anzeigen.
+
+	---
+
+	← [Zurück: Filamente](./06-filamente.md) | [Weiter: Lagerorte →](./08-lagerorte.md)
/dev/null .. docs/de/08-lagerorte.md
@@ 0,0 1,33 @@
+	# 8. Lagerorte (Locations)
+
+	**URL:** `http://localhost:4321/locations`
+
+	
+
+	Auf der Locations-Seite verwalten Sie alle **Lagerorte** für Ihre Filamentspulen. Dies können Schubladen, Regale, Behälter oder auch Drucker sein.
+
+	## Tabellenspalten
+
+	| Spalte | Beschreibung |
+	|--------|--------------|
+	| **NAME** | Bezeichnung des Lagerorts (z. B. „Regal A", „Trockenschrank") |
+	| **RFID UID** | Optionale RFID-Kennnummer für automatische Identifikation |
+	| **SPOOLS** | Anzahl der Spulen, die sich aktuell an diesem Ort befinden |
+	| **ACTIONS** | Bearbeiten / Löschen |
+
+	## Funktionen
+
+	### Lagerort hinzufügen
+	Klicken Sie auf **„Add Location"** oben rechts. Geben Sie an:
+	- **Name** – Bezeichnung des Lagerorts
+	- **RFID UID** – (Optional) RFID-Chip-Kennung, falls Sie RFID-Scanner verwenden
+
+	### RFID-Integration
+	FilaMan unterstützt RFID für Lagerorte. Wenn Sie einen RFID-Scanner und entsprechende Chips einsetzen, können Sie Spulen automatisch einem Lagerort zuordnen, indem der Scanner die UID des Lagerorts an FilaMan übermittelt. Die RFID-UID wird direkt am Lagerort angebracht (z. B. Aufkleber mit RFID-Chip an einer Schublade).
+
+	### Lagerort löschen
+	Ein Lagerort kann nur gelöscht werden, wenn ihm keine Spulen mehr zugeordnet sind.
+
+	---
+
+	← [Zurück: Spulen](./07-spulen.md) | [Weiter: Drucker →](./09-drucker.md)
/dev/null .. docs/de/09-drucker.md
@@ 0,0 1,33 @@
+	# 9. Drucker (Printers)
+
+	**URL:** `http://localhost:4321/printers`
+
+	
+
+	Auf der Drucker-Seite verwalten Sie alle **3D-Drucker**, die in Ihrem FilaMan-System erfasst sind.
+
+	## Tabellenspalten
+
+	| Spalte | Beschreibung |
+	|--------|--------------|
+	| **NAME** | Bezeichnung des Druckers (z. B. „Prusa MK4 #1") |
+	| **MODEL** | Modellbezeichnung des Druckers |
+	| **DRIVER** | Verwendeter Druckertreiber/Verbindungstyp |
+	| **STATUS** | Aktueller Betriebsstatus des Druckers |
+	| **ACTIONS** | Bearbeiten / Löschen |
+
+	## Funktionen
+
+	### Drucker hinzufügen
+	Klicken Sie auf **„Add Printer"** oben rechts. Das Formular enthält:
+	- **Name** – Eindeutige Bezeichnung des Druckers
+	- **Model** – Modellbezeichnung
+	- **Driver** – Treiber oder Verbindungstyp (z. B. OctoPrint, Moonraker/Klipper)
+	- Weitere druckerspezifische Konfigurationsoptionen
+
+	### Druckerintegration
+	Mit verbundenen Druckern kann FilaMan den Filamentverbrauch automatisch erfassen und Spulen-Füllstände aktualisieren, sofern der Drucker über eine kompatible API (z. B. OctoPrint oder Klipper/Moonraker) integriert ist.
+
+	---
+
+	← [Zurück: Lagerorte](./08-lagerorte.md) | [Weiter: Einstellungen →](./10-einstellungen.md)
/dev/null .. docs/de/10-einstellungen.md
@@ 0,0 1,30 @@
+	# 10. Einstellungen (Settings)
+
+	**URL:** `http://localhost:4321/settings`
+
+	
+
+	Unter **Settings** können Sie Ihre persönlichen Benutzereinstellungen verwalten. Diese Seite ist für jeden angemeldeten Benutzer zugänglich.
+
+	## Profil-Einstellungen
+
+	| Feld | Beschreibung |
+	|------|--------------|
+	| **Email** | Ihre E-Mail-Adresse (wird für den Login verwendet) |
+	| **Display Name** | Anzeigename, der in der Seitenleiste angezeigt wird |
+	| **Language** | Anzeigesprache der Anwendung (z. B. English, Deutsch) |
+
+	Klicken Sie auf **„Save Profile"**, um Ihre Änderungen zu speichern.
+
+	## Passwort ändern
+
+	Um Ihr Passwort zu ändern, füllen Sie die drei Felder aus:
+	1. **Current Password** – Ihr aktuelles Passwort
+	2. **New Password** – Das neue Passwort
+	3. **Confirm New Password** – Neues Passwort zur Bestätigung wiederholen
+
+	> 🔒 **Sicherheitshinweis:** Wählen Sie ein sicheres Passwort mit mindestens 8 Zeichen, bestehend aus Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen.
+
+	---
+
+	← [Zurück: Drucker](./09-drucker.md) | [Weiter: Admin-Bereich →](./11-admin.md)
/dev/null .. docs/de/11-admin.md
@@ 0,0 1,126 @@
+	# 11. Admin-Bereich
+
+	**URL:** `http://localhost:4321/admin`
+
+	
+
+	> ⚠️ **Hinweis:** Der Admin-Bereich ist nur für Benutzer mit **Administrator-Rolle** sichtbar und zugänglich.
+
+	Das Admin-Panel ist die zentrale Anlaufstelle für die **Systemadministration**. Es bietet Zugriff auf folgende Bereiche:
+
+	| Kachel | Beschreibung |
+	|--------|--------------|
+	| **Users** | Benutzerverwaltung |
+	| **Roles & Permissions** | Rollen und Berechtigungen |
+	| **Devices** | Geräte-Token-Verwaltung |
+	| **System Extra Fields** | Systemweite Zusatzfelder für Spulen und Filamente |
+	| **System** | Plugins und Systemverwaltung |
+
+	---
+
+	## 11.1 Benutzerverwaltung (Users)
+
+	**URL:** `http://localhost:4321/admin/users`
+
+	
+
+	Hier können Administratoren alle Benutzer des Systems verwalten. Die Tabelle zeigt:
+
+	| Spalte | Beschreibung |
+	|--------|-------------|
+	| **EMAIL** | E-Mail-Adresse des Benutzers (dient als Login) |
+	| **DISPLAY NAME** | Anzeigename in der Anwendung |
+	| **STATUS** | Aktiv / Inaktiv |
+	| **ROLES** | Zugewiesene Rollen (z. B. Superadmin, User) |
+	| **ACTIONS** | Edit / Reset PW |
+
+	Verfügbare Aktionen:
+	- **Add User** (oben rechts) – Neuen Benutzer mit E-Mail, Passwort und Rolle erstellen
+	- **Edit** – E-Mail, Name oder Rolle eines Users ändern
+	- **Reset PW** – Passwort eines Benutzers zurücksetzen
+
+	---
+
+	## 11.2 Rollen & Berechtigungen (Roles & Permissions)
+
+	**URL:** `http://localhost:4321/admin/roles`
+
+	
+
+	FilaMan enthält drei **Standard-Systemrollen**, die nicht gelöscht werden können:
+
+	| Rolle | Kennung | Beschreibung |
+	|-------|---------|--------------|
+	| **Administrator** | `admin` | Vollzugriff auf alle Funktionen und den Admin-Bereich |
+	| **User** | `user` | Standard-Benutzer mit Lese- und Schreibzugriff |
+	| **Viewer** | `viewer` | Nur-Lese-Zugriff |
+
+	Über **„Create Role"** (oben rechts) können eigene Rollen mit benutzerdefinierten Berechtigungen angelegt werden. Mit **„Edit Permissions"** lassen sich die Berechtigungen jeder Rolle granular anpassen.
+
+	Klicken Sie auf eine Rolle, um die zugeordneten Berechtigungen im rechten Bereich (**Permissions**) einzusehen und zu bearbeiten.
+
+	---
+
+	## 11.3 Geräte (Devices)
+
+	**URL:** `http://localhost:4321/admin/devices`
+
+	
+
+	Hier werden **API-Tokens für Geräte** verwaltet. Diese werden benötigt, wenn externe Geräte (z. B. RFID-Scanner, automatisierte Systeme) über die FilaMan-API kommunizieren sollen.
+
+	- **Token erstellen** – Neuen Geräte-Token generieren
+	- **Token widerrufen** – Zugang eines Geräts deaktivieren
+
+	---
+
+	## 11.4 Zusatzfelder (Extra Fields)
+
+	**URL:** `http://localhost:4321/admin/extra-fields`
+
+	
+
+	Mit **System Extra Fields** können Administratoren zusätzliche Datenfelder für Spulen und Filamente definieren, die über die Standardfelder hinausgehen. Diese Felder werden automatisch zu allen Filamenten oder Spulen hinzugefügt.
+
+	| Spalte | Beschreibung |
+	|--------|-------------|
+	| **TARGET TYPE** | Ob das Feld für Filamente oder Spulen gilt |
+	| **KEY (JSON)** | Interner JSON-Schlüssel für das Feld |
+	| **DISPLAY LABEL** | Anzeigetext in der Benutzeroberfläche |
+	| **DEFAULT VALUE (OPTIONAL)** | Optionaler Standardwert |
+
+	Klicken Sie auf **„Add Field"** (oben rechts), um ein neues Zusatzfeld zu erstellen.
+
+	Beispiele für Zusatzfelder:
+	- „Trocknungszeit" für Spulen
+	- „Drucktemperatur" für Filamente
+	- „Lieferant" als ergänzendes Herstellerfeld
+
+	Wenn Zusatzfelder erstellt wurden, erscheinen diese als neue Eingabefelder in den entsprechenden Formularen (Spule hinzufügen, Filament hinzufügen).
+
+	---
+
+	## 11.5 System
+
+	**URL:** `http://localhost:4321/admin/system`
+
+	
+
+	Der Systembereich bietet Zugriff auf:
+	- **Plugin-Verwaltung** – Erweiterungen installieren und verwalten
+	- **Systemeinstellungen** – Globale Konfigurationsoptionen
+
+	---
+
+	## 11.6 Gefahrenzone
+
+	Am unteren Ende des Admin-Panels befindet sich die rot markierte **Danger Zone** mit einer kritischen Aktion:
+
+	> ⛔ **„Delete all data"**
+	> Löscht **dauerhaft** alle Spulen, Filamente, Hersteller, Farben, Lagerorte und Drucker einschließlich aller Logs und Ereignisse.
+	> **Benutzerkonten, Rollen, Berechtigungen und Geräte bleiben davon unberührt.**
+	> Diese Aktion kann **nicht rückgängig gemacht** werden!
+
+	---
+
+	← [Zurück: Einstellungen](./10-einstellungen.md) | [Weiter: Farbverwaltung →](./12-farbverwaltung.md)
/dev/null .. docs/de/12-farbverwaltung.md
@@ 0,0 1,17 @@
+	# 12. Farbverwaltung
+
+	Die Farbverwaltung ist über den Button **„Manage Colors"** auf der [Filamente-Seite](./06-filamente.md) erreichbar.
+
+	Farben werden in FilaMan systemweit definiert und können dann Filamenten zugeordnet werden. Dies ermöglicht es, nach Farbe zu filtern und Farben einheitlich darzustellen.
+
+	## Farbe anlegen
+
+	Klicken Sie auf **„Add Color"** und geben Sie folgende Felder an:
+	- **Name** – Farbbezeichnung (z. B. „Schwarz", „Galaxy Black")
+	- **Hex-Code** – Farbcode für die visuelle Darstellung (z. B. `#1A1A2E`)
+
+	Die Farbe erscheint danach als auswählbare Option beim Anlegen oder Bearbeiten eines Filaments.
+
+	---
+
+	← [Zurück: Admin-Bereich](./11-admin.md) | [Weiter: Tipps & FAQ →](./13-faq.md)
/dev/null .. docs/de/13-faq.md
@@ 0,0 1,56 @@
+	# 13. Tipps & Häufige Fragen
+
+	## ❓ Wie lege ich eine neue Spule an?
+
+	1. Stellen Sie sicher, dass der Hersteller bereits angelegt ist (→ [Hersteller](./05-hersteller.md))
+	2. Stellen Sie sicher, dass das Filamentprodukt bereits angelegt ist (→ [Filamente](./06-filamente.md))
+	3. Legen Sie ggf. den Lagerort an (→ [Lagerorte](./08-lagerorte.md))
+	4. Gehen Sie zu **Spools** und klicken Sie auf **„Add Spool"**
+	5. Wählen Sie Filament, Lagerort, geben Sie das Gewicht ein und speichern Sie
+
+	---
+
+	## ❓ In welcher Reihenfolge sollte ich Daten erfassen?
+
+	Für optimale Ergebnisse empfiehlt sich folgende Reihenfolge:
+
+	```
+	1. Hersteller anlegen (Manufacturers)
+	2. Farben anlegen (via "Manage Colors" in Filaments)
+	3. Filamentprodukte anlegen (Filaments)
+	4. Lagerorte anlegen (Locations)
+	5. Spulen anlegen (Spools)
+	6. Drucker anlegen (Printers) – optional
+	```
+
+	---
+
+	## ❓ Was bedeutet der „Low Stock" Status?
+
+	Jede Spule hat einen Mindestwert (Min. Weight), der beim Filament definiert wird. Wenn das Restgewicht einer Spule diesen Mindestwert unterschreitet, wird die Spule als **Low** markiert. Das Dashboard zeigt dann eine Warnung in der „Low Stock Spools"-Kachel.
+
+	---
+
+	## ❓ Wie ändere ich das Farbschema der Anwendung?
+
+	Unten links in der Seitenleiste gibt es Schaltflächen für **Default**, **Light** und **Dark**. Klicken Sie einfach auf das gewünschte Thema.
+
+	---
+
+	## ❓ Ich sehe den Admin-Bereich nicht – warum?
+
+	Der **Admin Panel**-Menüpunkt ist nur für Benutzer mit der **Admin-Rolle** sichtbar. Wenn Sie administrative Aufgaben durchführen müssen, wenden Sie sich an Ihren Systemadministrator, um die notwendigen Berechtigungen zu erhalten.
+
+	---
+
+	## ❓ Wie melde ich mich ab?
+
+	Klicken Sie unten links in der Seitenleiste auf das **→ Pfeil-Symbol** neben dem Zahnrad-Icon. Sie werden sofort abgemeldet und zur Login-Seite weitergeleitet.
+
+	---
+
+	← [Zurück: Farbverwaltung](./12-farbverwaltung.md) | [Zum Inhaltsverzeichnis →](./README.md)
+
+	---
+
+	*Dieses Handbuch wurde für FilaMan erstellt. Für technische Fragen oder Probleme wenden Sie sich an Ihren Systemadministrator.*
/dev/null .. docs/de/README.md
@@ 0,0 1,31 @@
+	# FilaMan – Endanwender-Handbuch
+
+	**Version:** 1.0
+	**Stand:** Februar 2026
+	**Sprache:** Deutsch
+
+	---
+
+	FilaMan ist eine webbasierte Verwaltungssoftware für 3D-Drucker-Filamente. Dieses Handbuch beschreibt alle Funktionen und Seiten der Anwendung.
+
+	## Inhaltsverzeichnis
+
+	| # | Kapitel | Beschreibung |
+	|---|---------|--------------|
+	| 1 | [Einleitung](./01-einleitung.md) | Was ist FilaMan? |
+	| 2 | [Anmeldung (Login)](./02-anmeldung.md) | Anmelden und abmelden |
+	| 3 | [Navigation & Benutzeroberfläche](./03-navigation.md) | Seitenleiste, Menü, Farbschema |
+	| 4 | [Dashboard](./04-dashboard.md) | Übersichtsseite mit Statistiken und Warnungen |
+	| 5 | [Hersteller (Manufacturers)](./05-hersteller.md) | Filament-Hersteller verwalten |
+	| 6 | [Filamente (Filaments)](./06-filamente.md) | Filamentprodukte anlegen und verwalten |
+	| 7 | [Spulen (Spools)](./07-spulen.md) | Physischen Bestand verwalten |
+	| 8 | [Lagerorte (Locations)](./08-lagerorte.md) | Lagerplätze und RFID-Integration |
+	| 9 | [Drucker (Printers)](./09-drucker.md) | 3D-Drucker verwalten und integrieren |
+	| 10 | [Einstellungen (Settings)](./10-einstellungen.md) | Profil und Passwort ändern |
+	| 11 | [Admin-Bereich](./11-admin.md) | Benutzer, Rollen, Geräte, Zusatzfelder, System |
+	| 12 | [Farbverwaltung](./12-farbverwaltung.md) | Farben für Filamente definieren |
+	| 13 | [Tipps & Häufige Fragen](./13-faq.md) | FAQ und Empfehlungen |
+
+	---
+
+	*Für technische Fragen oder Probleme wenden Sie sich an Ihren Systemadministrator.*
docs/de/handbuch.md .. /dev/null
@@ 1,572 0,0 @@
-	# FilaMan – Endanwender-Handbuch
-
-	**Version:** 1.0
-	**Stand:** Februar 2026
-	**Sprache:** Deutsch
-
-	---
-
-	## Inhaltsverzeichnis
-
-	1. [Einleitung](#1-einleitung)
-	2. [Anmeldung (Login)](#2-anmeldung-login)
-	3. [Navigation & Benutzeroberfläche](#3-navigation--benutzeroberfläche)
-	4. [Dashboard](#4-dashboard)
-	5. [Hersteller (Manufacturers)](#5-hersteller-manufacturers)
-	6. [Filamente (Filaments)](#6-filamente-filaments)
-	7. [Spulen (Spools)](#7-spulen-spools)
-	8. [Lagerorte (Locations)](#8-lagerorte-locations)
-	9. [Drucker (Printers)](#9-drucker-printers)
-	10. [Einstellungen (Settings)](#10-einstellungen-settings)
-	11. [Admin-Bereich](#11-admin-bereich)
-	- [Benutzerverwaltung](#111-benutzerverwaltung-users)
-	- [Rollen & Berechtigungen](#112-rollen--berechtigungen-roles--permissions)
-	- [Geräte (Devices)](#113-geräte-devices)
-	- [Zusatzfelder (Extra Fields)](#114-zusatzfelder-extra-fields)
-	- [System](#115-system)
-	- [Gefahrenzone](#116-gefahrenzone)
-	12. [Farbverwaltung](#12-farbverwaltung)
-	13. [Tipps & Häufige Fragen](#13-tipps--häufige-fragen)
-
-	---
-
-	## 1. Einleitung
-
-	**FilaMan** ist eine webbasierte Verwaltungssoftware für **3D-Drucker-Filamente**. Mit FilaMan behalten Sie stets den Überblick über Ihren gesamten Filamentbestand:
-
-	- Welche Filamente und Spulen (Rollen) Sie besitzen
-	- Wie viel Filament auf jeder Spule noch verfügbar ist
-	- Wo Ihre Spulen gelagert sind
-	- Welche Drucker mit welchem Filament verwendet werden
-
-	FilaMan ist mehrbenutzer-fähig und unterstützt rollenbasierte Zugriffskontrolle, damit jeder Nutzer nur die für ihn relevanten Bereiche sehen und bearbeiten kann.
-
-	---
-
-	## 2. Anmeldung (Login)
-
-	Rufen Sie die FilaMan-Anwendung in Ihrem Browser auf. Sie werden automatisch zur Anmeldeseite weitergeleitet, wenn Sie noch nicht eingeloggt sind.
-
-	
-
-	**Anmeldefelder:**
-	- **E-Mail** – Ihre registrierte E-Mail-Adresse
-	- **Passwort** – Ihr persönliches Passwort
-
-	Klicken Sie nach der Eingabe auf **„Sign in"**, um sich anzumelden.
-
-	> 💡 **Hinweis:** Wenn Sie Ihr Passwort vergessen haben, wenden Sie sich an Ihren Systemadministrator. Eine Passwortzurücksetzung ist über den Admin-Bereich möglich.
-
-	Nach erfolgreicher Anmeldung gelangen Sie direkt zum **Dashboard**.
-
-	---
-
-	## 3. Navigation & Benutzeroberfläche
-
-	
-
-	Die Benutzeroberfläche von FilaMan ist in zwei Hauptbereiche aufgeteilt:
-
-	### Seitenleiste (linke Navigation)
-
-	Die Seitenleiste enthält alle Hauptmenüpunkte:
-
-	| Symbol | Menüpunkt | Beschreibung |
-	|--------|-----------|--------------|
-	| 🟩 | **Dashboard** | Übersichtsseite mit Statistiken |
-	| 📊 | **Manufacturers** | Herstellerverwaltung |
-	| 🔵 | **Filaments** | Filamentverwaltung |
-	| ⭕ | **Spools** | Spulenverwaltung (Bestand) |
-	| 🗂️ | **Locations** | Lagerortverwaltung |
-	| 🖨️ | **Printers** | Druckerverwaltung |
-	| 🛡️ | **Admin Panel** | Administration (nur für Admins) |
-
-	Am unteren Rand der Seitenleiste befinden sich:
-	- Ihr **Benutzername** und Ihre **Rolle**
-	- Das **⚙️ Einstellungs-Symbol** (führt zu den persönlichen Einstellungen)
-	- Das **→ Abmelde-Symbol** (Logout)
-	- **Farbschema-Umschalter** (Default / Light / Dark)
-
-	### Hauptbereich (rechts)
-
-	Der Hauptbereich zeigt den Inhalt der aktuell gewählten Seite. Alle Seiten folgen einem einheitlichen Aufbau:
-	- **Seitentitel** oben links
-	- **Aktionsschaltflächen** oben rechts (z. B. „Add Spool")
-	- **Filter und Suche** unterhalb des Titels
-	- **Tabelle oder Kachelansicht** im Hauptbereich
-
-	### Farbschema wechseln
-
-	Unten links in der Seitenleiste können Sie zwischen drei Farbschemata wählen:
-	- **Default** – Dunkles Grün-Thema (Standard)
-	- **Light** – Helles Thema
-	- **Dark** – Dunkles Thema
-
-	---
-
-	## 4. Dashboard
-
-	**URL:** `http://localhost:4321/`
-
-	
-
-	Das Dashboard ist die Startseite von FilaMan und gibt Ihnen einen schnellen Überblick über den gesamten Filamentbestand.
-
-	### Statistik-Kacheln (oben)
-
-	| Kachel | Beschreibung |
-	|--------|--------------|
-	| **Total Spools** | Gesamtanzahl aller erfassten Spulen |
-	| **Filaments** | Anzahl der verschiedenen Filamenttypen |
-	| **Low & Empty Spools** | Spulen mit niedrigem (Low) und leerem (Empty) Füllstand |
-	| **Total Value (available)** | Gesamtwert des verfügbaren Filamentbestands |
-
-	### Warnsystem: Low Stock Spools
-
-	Die Kachel **„Low Stock Spools"** zeigt sofort, ob Spulen nachbestellt werden müssen:
-	- **Grüne Meldung** „All spools have sufficient filament" – kein Handlungsbedarf
-	- **Rote Meldung** – Liste der kritischen oder leeren Spulen wird angezeigt
-
-	### Statistik-Bereiche
-
-	| Bereich | Beschreibung |
-	|---------|--------------|
-	| **Manufacturers (non-empty)** | Auflistung der Hersteller mit noch vollen Spulen |
-	| **Filament Types** | Übersicht der verwendeten Filament-Typen |
-	| **Spool Status** | Visualisierung des Spulenstatus nach Kategorien |
-	| **Filament Statistics** | Weitere Statistiken über Ihr Filament |
-	| **Locations** | Übersicht der belegten Lagerorte |
-
-	### Spool Status – Füllstand-Kategorien
-
-	| Status | Farbe | Bedeutung |
-	|--------|-------|-----------|
-	| **Full** | Grün | > 75 % Füllstand |
-	| **Normal** | Blau | 50 – 75 % |
-	| **Low** | Gelb | Unter Mindestwert |
-	| **Critical** | Rot | < 50 % des Mindestwerts |
-	| **Empty** | Grau | 0 g – komplett leer |
-
-	---
-
-	## 5. Hersteller (Manufacturers)
-
-	**URL:** `http://localhost:4321/manufacturers`
-
-	
-
-	Auf der Herstellerseite verwalten Sie alle **Filament-Hersteller**, deren Produkte Sie im System erfassen möchten. Jeder Hersteller kann mehrere Filamente haben.
-
-	### Tabellenspalten
-
-	| Spalte | Beschreibung |
-	|--------|--------------|
-	| **NAME** | Bezeichnung des Herstellers |
-	| **URL** | Website des Herstellers (klickbarer Link) |
-	| **FILAMENTS** | Anzahl der vom Hersteller erfassten Filamenttypen |
-	| **SPOOLS** | Anzahl der Spulen dieses Herstellers im Bestand |
-	| **MATERIALS** | Verwendete Materialien (z. B. PLA, PETG, ABS) |
-	| **ACTIONS** | Bearbeiten / Löschen-Schaltflächen |
-
-	### Funktionen
-
-	#### Hersteller suchen
-	Nutzen Sie die **Suchleiste** oben links, um Hersteller nach Name zu filtern.
-
-	#### Nach Material filtern
-	Das Dropdown **„All Materials"** filtert die Herstellerliste nach einem bestimmten Filamentmaterial (z. B. nur PLA-Hersteller anzeigen).
-
-	#### Hersteller hinzufügen
-	Klicken Sie oben rechts auf **„Add Manufacturer"**. Es öffnet sich ein Dialog/Formular mit folgenden Feldern:
-	- **Name** – Pflichtfeld: Herstellername (z. B. „Prusament")
-	- **URL** – Optionale Website-Adresse des Herstellers
-
-	#### Hersteller bearbeiten
-	Klicken Sie in der Tabelle in der Spalte **ACTIONS** auf das **Stift-Symbol** neben einem Hersteller.
-
-	#### Hersteller löschen
-	Klicken Sie in der Spalte **ACTIONS** auf das **Papierkorb-Symbol**. Ein Hersteller kann nur gelöscht werden, wenn ihm keine Filamente mehr zugeordnet sind.
-
-	---
-
-	## 6. Filamente (Filaments)
-
-	**URL:** `http://localhost:4321/filaments`
-
-	
-
-	Die Filamentseite listet alle **Filamentprodukte** auf, die in Ihrem System hinterlegt sind. Ein Filament ist ein Produkt-Template (z. B. „Prusament PETG Galaxy Black 1.75 mm"), dem dann physische Spulen zugeordnet werden.
-
-	### Tabellenspalten
-
-	| Spalte | Beschreibung |
-	|--------|--------------|
-	| **DESIGNATION** | Bezeichnung/Name des Filaments |
-	| **COLORS** | Zugeordnete Farben (als farbige Kreise dargestellt) |
-	| **TYPE** | Materialtyp (z. B. PLA, PETG, ABS, TPU) |
-	| **DIAMETER** | Durchmesser der Spule in mm (z. B. 1.75 mm) |
-	| **MANUFACTURER** | Zugeordneter Hersteller |
-	| **SPOOLS** | Anzahl der vorhandenen Spulen dieses Filaments |
-
-	### Funktionen
-
-	#### Filament suchen
-	Die **Suchleiste** durchsucht Bezeichnung, Farbe und Hersteller gleichzeitig.
-
-	#### Filter
-	- **All Manufacturers** – Nur Filamente eines bestimmten Herstellers anzeigen
-	- **All Types** – Nach Materialtyp filtern (PLA, PETG, ABS usw.)
-	- **All Colors** – Nach Farbe filtern
-
-	#### Filament hinzufügen
-	Klicken Sie auf **„Add Filament"** oben rechts. Das Formular enthält:
-	- **Designation** – Name/Bezeichnung des Filaments
-	- **Manufacturer** – Zugehöriger Hersteller (Dropdown)
-	- **Type** – Materialtyp
-	- **Diameter** – Durchmesser (Standard: 1.75 mm)
-	- **Colors** – Eine oder mehrere Farben zuordnen
-	- **Min. Weight** – Mindestgewicht (für die Low-Stock-Warnung)
-	- **Price per kg** – Preis für Wertberechnung (optional)
-	- **Article Number** – Artikelnummer (optional)
-
-	#### Farbverwaltung
-	Über den Button **„Manage Colors"** oben rechts gelangen Sie zur [Farbverwaltung](#12-farbverwaltung), wo Sie Farben anlegen und verwalten können.
-
-	---
-
-	## 7. Spulen (Spools)
-
-	**URL:** `http://localhost:4321/spools`
-
-	
-
-	Die Spulenseite zeigt den **physischen Filamentbestand** – also jede einzelne Spule, die Sie besitzen. Dies ist das zentrale Herzstück von FilaMan.
-
-	### Tabellenspalten
-
-	| Spalte | Beschreibung |
-	|--------|--------------|
-	| **ID** | Eindeutige interne ID der Spule |
-	| **FILAMENT** | Zugeordnetes Filamentprodukt (Bezeichnung + Farbe) |
-	| **MANUFACTURER** | Hersteller des Filaments |
-	| **MATERIAL** | Materialtyp (PLA, PETG, ABS usw.) |
-	| **STATUS** | Aktueller Füllstandstatus (Full / Normal / Low / Critical / Empty) |
-	| **REMAINING** | Restgewicht in Gramm |
-	| **LOCATION** | Aktueller Lagerort der Spule |
-
-	### Funktionen
-
-	#### Suche
-	Durchsucht Filament, Hersteller und weitere Felder.
-
-	#### Filter
-	FilaMan bietet umfangreiche Filtermöglichkeiten für Spulen:
-	- **All Statuses** – Nach Füllstandstatus filtern
-	- **All Locations** – Nur Spulen eines bestimmten Lagerorts anzeigen
-	- **All Manufacturers** – Nach Hersteller filtern
-	- **All Materials** – Nach Materialtyp filtern
-
-	#### Gruppierung nach Filament
-	Mit dem Toggle **„Group by Filament"** können Spulen nach Filamentprodukt gruppiert angezeigt werden. Das gibt einen schnellen Überblick, wie viele Exemplare eines Filaments vorhanden sind.
-
-	#### Spule hinzufügen
-	Klicken Sie auf **„Add Spool"** oben rechts. Das Formular enthält u. a.:
-	- **Filament** – Auswahl des zugehörigen Filamentprodukts
-	- **Location** – Lagerort der Spule
-	- **Initial Weight / Remaining Weight** – Startgewicht und aktuelles Restgewicht in Gramm
-	- **Purchase Price** – Kaufpreis (optional, für Wertberechnung)
-	- **Purchase Date** – Kaufdatum (optional)
-	- **Notes** – Freitextnotiz
-	- **Zusatzfelder** – Falls vom Administrator konfiguriert
-
-	#### Spule bearbeiten
-	In der Aktionsspalte können Sie:
-	- ✏️ **Bearbeiten** – Spuleninformationen ändern (z. B. Restgewicht nach dem Druck aktualisieren)
-	- 🗑️ **Löschen** – Spule aus dem System entfernen
-
-	> 💡 **Tipp:** Aktualisieren Sie regelmäßig das Restgewicht Ihrer Spulen, damit das Dashboard und die Low-Stock-Warnungen korrekte Werte anzeigen.
-
-	---
-
-	## 8. Lagerorte (Locations)
-
-	**URL:** `http://localhost:4321/locations`
-
-	
-
-	Auf der Locations-Seite verwalten Sie alle **Lagerorte** für Ihre Filamentspulen. Dies können Schubladen, Regale, Behälter oder auch Drucker sein.
-
-	### Tabellenspalten
-
-	| Spalte | Beschreibung |
-	|--------|--------------|
-	| **NAME** | Bezeichnung des Lagerorts (z. B. „Regal A", „Trockenschrank") |
-	| **RFID UID** | Optionale RFID-Kennnummer für automatische Identifikation |
-	| **SPOOLS** | Anzahl der Spulen, die sich aktuell an diesem Ort befinden |
-	| **ACTIONS** | Bearbeiten / Löschen |
-
-	### Funktionen
-
-	#### Lagerort hinzufügen
-	Klicken Sie auf **„Add Location"** oben rechts. Geben Sie an:
-	- **Name** – Bezeichnung des Lagerorts
-	- **RFID UID** – (Optional) RFID-Chip-Kennung, falls Sie RFID-Scanner verwenden
-
-	#### RFID-Integration
-	FilaMan unterstützt RFID für Lagerorte. Wenn Sie einen RFID-Scanner und entsprechende Chips einsetzen, können Sie Spulen automatisch einem Lagerort zuordnen, indem der Scanner die UID des Lagerorts an FilaMan übermittelt. Die RFID-UID wird direkt am Lagerort angebracht (z. B. Aufkleber mit RFID-Chip an einer Schublade).
-
-	#### Lagerort löschen
-	Ein Lagerort kann nur gelöscht werden, wenn ihm keine Spulen mehr zugeordnet sind.
-
-	---
-
-	## 9. Drucker (Printers)
-
-	**URL:** `http://localhost:4321/printers`
-
-	
-
-	Auf der Drucker-Seite verwalten Sie alle **3D-Drucker**, die in Ihrem FilaMan-System erfasst sind.
-
-	### Tabellenspalten
-
-	| Spalte | Beschreibung |
-	|--------|--------------|
-	| **NAME** | Bezeichnung des Druckers (z. B. „Prusa MK4 #1") |
-	| **MODEL** | Modellbezeichnung des Druckers |
-	| **DRIVER** | Verwendeter Druckertreiber/Verbindungstyp |
-	| **STATUS** | Aktueller Betriebsstatus des Druckers |
-	| **ACTIONS** | Bearbeiten / Löschen |
-
-	### Funktionen
-
-	#### Drucker hinzufügen
-	Klicken Sie auf **„Add Printer"** oben rechts. Das Formular enthält:
-	- **Name** – Eindeutige Bezeichnung des Druckers
-	- **Model** – Modellbezeichnung
-	- **Driver** – Treiber oder Verbindungstyp (z. B. OctoPrint, Moonraker/Klipper)
-	- Weitere druckerspezifische Konfigurationsoptionen
-
-	#### Druckerintegration
-	Mit verbundenen Druckern kann FilaMan den Filamentverbrauch automatisch erfassen und Spulen-Füllstände aktualisieren, sofern der Drucker über eine kompatible API (z. B. OctoPrint oder Klipper/Moonraker) integriert ist.
-
-	---
-
-	## 10. Einstellungen (Settings)
-
-	**URL:** `http://localhost:4321/settings`
-
-	
-
-	Unter **Settings** können Sie Ihre persönlichen Benutzereinstellungen verwalten. Diese Seite ist für jeden angemeldeten Benutzer zugänglich.
-
-	### Profil-Einstellungen
-
-	| Feld | Beschreibung |
-	|------|--------------|
-	| **Email** | Ihre E-Mail-Adresse (wird für den Login verwendet) |
-	| **Display Name** | Anzeigename, der in der Seitenleiste angezeigt wird |
-	| **Language** | Anzeigesprache der Anwendung (z. B. English, Deutsch) |
-
-	Klicken Sie auf **„Save Profile"**, um Ihre Änderungen zu speichern.
-
-	### Passwort ändern
-
-	Um Ihr Passwort zu ändern, füllen Sie die drei Felder aus:
-	1. **Current Password** – Ihr aktuelles Passwort
-	2. **New Password** – Das neue Passwort
-	3. **Confirm New Password** – Neues Passwort zur Bestätigung wiederholen
-
-	> 🔒 **Sicherheitshinweis:** Wählen Sie ein sicheres Passwort mit mindestens 8 Zeichen, bestehend aus Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen.
-
-	---
-
-	## 11. Admin-Bereich
-
-	**URL:** `http://localhost:4321/admin`
-
-	
-
-	> ⚠️ **Hinweis:** Der Admin-Bereich ist nur für Benutzer mit **Administrator-Rolle** sichtbar und zugänglich.
-
-	Das Admin-Panel ist die zentrale Anlaufstelle für die **Systemadministration**. Es bietet Zugriff auf folgende Bereiche:
-
-	| Kachel | Beschreibung |
-	|--------|--------------|
-	| **Users** | Benutzerverwaltung |
-	| **Roles & Permissions** | Rollen und Berechtigungen |
-	| **Devices** | Geräte-Token-Verwaltung |
-	| **System Extra Fields** | Systemweite Zusatzfelder für Spulen und Filamente |
-	| **System** | Plugins und Systemverwaltung |
-
-	---
-
-	### 11.1 Benutzerverwaltung (Users)
-
-	**URL:** `http://localhost:4321/admin/users`
-
-	
-
-	Hier können Administratoren alle Benutzer des Systems verwalten. Die Tabelle zeigt:
-
-	| Spalte | Beschreibung |
-	|--------|-------------|
-	| **EMAIL** | E-Mail-Adresse des Benutzers (dient als Login) |
-	| **DISPLAY NAME** | Anzeigename in der Anwendung |
-	| **STATUS** | Aktiv / Inaktiv |
-	| **ROLES** | Zugewiesene Rollen (z. B. Superadmin, User) |
-	| **ACTIONS** | Edit / Reset PW |
-
-	Verfügbare Aktionen:
-	- **Add User** (oben rechts) – Neuen Benutzer mit E-Mail, Passwort und Rolle erstellen
-	- **Edit** – E-Mail, Name oder Rolle eines Users ändern
-	- **Reset PW** – Passwort eines Benutzers zurücksetzen
-
-	---
-
-	### 11.2 Rollen & Berechtigungen (Roles & Permissions)
-
-	**URL:** `http://localhost:4321/admin/roles`
-
-	
-
-	FilaMan enthält drei **Standard-Systemrollen**, die nicht gelöscht werden können:
-
-	| Rolle | Kennung | Beschreibung |
-	|-------|---------|--------------|
-	| **Administrator** | `admin` | Vollzugriff auf alle Funktionen und den Admin-Bereich |
-	| **User** | `user` | Standard-Benutzer mit Lese- und Schreibzugriff |
-	| **Viewer** | `viewer` | Nur-Lese-Zugriff |
-
-	Über **„Create Role"** (oben rechts) können eigene Rollen mit benutzerdefinierten Berechtigungen angelegt werden. Mit **„Edit Permissions"** lassen sich die Berechtigungen jeder Rolle granular anpassen.
-
-	Klicken Sie auf eine Rolle, um die zugeordneten Berechtigungen im rechten Bereich (**Permissions**) einzusehen und zu bearbeiten.
-
-	---
-
-	### 11.3 Geräte (Devices)
-
-	**URL:** `http://localhost:4321/admin/devices`
-
-	
-
-	Hier werden **API-Tokens für Geräte** verwaltet. Diese werden benötigt, wenn externe Geräte (z. B. RFID-Scanner, automatisierte Systeme) über die FilaMan-API kommunizieren sollen.
-
-	- **Token erstellen** – Neuen Geräte-Token generieren
-	- **Token widerrufen** – Zugang eines Geräts deaktivieren
-
-	---
-
-	### 11.4 Zusatzfelder (Extra Fields)
-
-	**URL:** `http://localhost:4321/admin/extra-fields`
-
-	
-
-	Mit **System Extra Fields** können Administratoren zusätzliche Datenfelder für Spulen und Filamente definieren, die über die Standardfelder hinausgehen. Diese Felder werden automatisch zu allen Filamenten oder Spulen hinzugefügt.
-
-	| Spalte | Beschreibung |
-	|--------|-------------|
-	| **TARGET TYPE** | Ob das Feld für Filamente oder Spulen gilt |
-	| **KEY (JSON)** | Interner JSON-Schlüssel für das Feld |
-	| **DISPLAY LABEL** | Anzeigetext in der Benutzeroberfläche |
-	| **DEFAULT VALUE (OPTIONAL)** | Optionaler Standardwert |
-
-	Klicken Sie auf **„Add Field"** (oben rechts), um ein neues Zusatzfeld zu erstellen.
-
-	Beispiele für Zusatzfelder:
-	- „Trocknungszeit" für Spulen
-	- „Drucktemperatur" für Filamente
-	- „Lieferant" als ergänzendes Herstellerfeld
-
-	Wenn Zusatzfelder erstellt wurden, erscheinen diese als neue Eingabefelder in den entsprechenden Formularen (Spule hinzufügen, Filament hinzufügen).
-
-	---
-
-	### 11.5 System
-
-	**URL:** `http://localhost:4321/admin/system`
-
-	
-
-	Der Systembereich bietet Zugriff auf:
-	- **Plugin-Verwaltung** – Erweiterungen installieren und verwalten
-	- **Systemeinstellungen** – Globale Konfigurationsoptionen
-
-	---
-
-	### 11.6 Gefahrenzone
-
-	Am unteren Ende des Admin-Panels befindet sich die rot markierte **Danger Zone** mit einer kritischen Aktion:
-
-	> ⛔ **„Delete all data"**
-	> Löscht **dauerhaft** alle Spulen, Filamente, Hersteller, Farben, Lagerorte und Drucker einschließlich aller Logs und Ereignisse.
-	> **Benutzerkonten, Rollen, Berechtigungen und Geräte bleiben davon unberührt.**
-	> Diese Aktion kann **nicht rückgängig gemacht** werden!
-
-	---
-
-	## 12. Farbverwaltung
-
-	Die Farbverwaltung ist über den Button **„Manage Colors"** auf der Filamente-Seite erreichbar.
-
-	Farben werden in FilaMan systemweit definiert und können dann Filamenten zugeordnet werden. Dies ermöglicht es, nach Farbe zu filtern und Farben einheitlich darzustellen.
-
-	### Farbe anlegen
-	- **Name** – Farbbezeichnung (z. B. „Schwarz", „Galaxy Black")
-	- **Hex-Code** – Farbcode für die visuelle Darstellung (z. B. `#1A1A2E`)
-
-	---
-
-	## 13. Tipps & Häufige Fragen
-
-	### ❓ Wie lege ich eine neue Spule an?
-
-	1. Stellen Sie sicher, dass der Hersteller bereits angelegt ist (→ [Hersteller](#5-hersteller-manufacturers))
-	2. Stellen Sie sicher, dass das Filamentprodukt bereits angelegt ist (→ [Filamente](#6-filamente-filaments))
-	3. Legen Sie ggf. den Lagerort an (→ [Lagerorte](#8-lagerorte-locations))
-	4. Gehen Sie zu **Spools** und klicken Sie auf **„Add Spool"**
-	5. Wählen Sie Filament, Lagerort, geben Sie das Gewicht ein und speichern Sie
-
-	---
-
-	### ❓ In welcher Reihenfolge sollte ich Daten erfassen?
-
-	Für optimale Ergebnisse empfiehlt sich folgende Reihenfolge:
-
-	```
-	1. Hersteller anlegen (Manufacturers)
-	2. Farben anlegen (via "Manage Colors" in Filaments)
-	3. Filamentprodukte anlegen (Filaments)
-	4. Lagerorte anlegen (Locations)
-	5. Spulen anlegen (Spools)
-	6. Drucker anlegen (Printers) – optional
-	```
-
-	---
-
-	### ❓ Was bedeutet der „Low Stock" Status?
-
-	Jede Spule hat einen Mindestwert (Min. Weight), der beim Filament definiert wird. Wenn das Restgewicht einer Spule diesen Mindestwert unterschreitet, wird die Spule als **Low** markiert. Das Dashboard zeigt dann eine Warnung in der „Low Stock Spools"-Kachel.
-
-	---
-
-	### ❓ Wie ändere ich das Farbschema der Anwendung?
-
-	Unten links in der Seitenleiste gibt es Schaltflächen für **Default**, **Light** und **Dark**. Klicken Sie einfach auf das gewünschte Thema.
-
-	---
-
-	### ❓ Ich sehe den Admin-Bereich nicht – warum?
-
-	Der **Admin Panel**-Menüpunkt ist nur für Benutzer mit der **Admin-Rolle** sichtbar. Wenn Sie administrative Aufgaben durchführen müssen, wenden Sie sich an Ihren Systemadministrator, um die notwendigen Berechtigungen zu erhalten.
-
-	---
-
-	### ❓ Wie melde ich mich ab?
-
-	Klicken Sie unten links in der Seitenleiste auf das **→ Pfeil-Symbol** neben dem Zahnrad-Icon. Sie werden sofort abgemeldet und zur Login-Seite weitergeleitet.
-
-	---
-
-	*Dieses Handbuch wurde für FilaMan erstellt. Für technische Fragen oder Probleme wenden Sie sich an Ihren Systemadministrator.*