11-Admin - blame (ae873c) – FilaMan Documentation

Blame

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

# 11. Admin-Bereich

57076d	Manuel Weiser	2026-02-23 16:43:14
update

**URL:** `http(s)://url/admin`

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

![Admin-Panel](../images/admin-panel.png)

> ⚠️ **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)

57076d	Manuel Weiser	2026-02-23 16:43:14
update

**URL:** `http(s)://url/admin/users`

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

![Benutzerverwaltung](../images/admin-users.png)

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)

57076d	Manuel Weiser	2026-02-23 16:43:14
update

**URL:** `http(s)://url/admin/roles`

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

![Rollen & Berechtigungen](../images/admin-roles.png)

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)

57076d	Manuel Weiser	2026-02-23 16:43:14
update

**URL:** `http(s)://url/admin/devices`

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

![Geräte-Verwaltung](../images/admin-devices.png)

ae873c	Manuel Weiser	2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.

Hier werden **externe Geräte** verwaltet, die über die FilaMan-API kommunizieren (z. B. ESP32-Waagen mit RFID-Scanner). Jedes Gerät erhält einen eigenen API-Token für die Authentifizierung.

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

ae873c	Manuel Weiser	2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.

### Geräte-Aktionen

- **Gerät hinzufügen** – Neues Gerät mit Name und optionalem Gerätecode erstellen

- **Token erstellen** – Neuen API-Token für ein Gerät generieren

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

- **Token widerrufen** – Zugang eines Geräts deaktivieren

ae873c	Manuel Weiser	2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.

- **Bearbeiten** – Gerätename und Einstellungen ändern

### Auto-Assign Konfiguration

Für jedes Gerät können folgende Einstellungen für die **automatische Spulenzuordnung** konfiguriert werden:

| Einstellung | Beschreibung |

|-------------|-------------|

| **Auto-Assign aktiviert** | Wenn aktiviert, wird nach dem Wiegen einer Spule auf diesem Gerät automatisch ein Pending-Auftrag an alle verbundenen Drucker gesendet. Sobald die Spule in einen AMS-Slot eingelegt wird, werden die Filament-Einstellungen automatisch übertragen. |

| **Auto-Assign Timeout** | Zeit in Sekunden, nach der ein ausstehender Zuordnungsauftrag automatisch verworfen wird (Standard: 60 Sekunden). Wenn innerhalb dieser Zeit keine Spule eingelegt wird, verfällt der Auftrag. |

> **Hinweis:** Auto-Assign wird pro Gerät konfiguriert, nicht pro Drucker. Wenn Auto-Assign für ein Gerät aktiviert ist, werden ALLE verbundenen Drucker benachrichtigt. Die Zuordnung erfolgt dann automatisch bei dem Drucker, in den die Spule tatsächlich eingelegt wird.

Weitere Informationen zum Ablauf: → [Drucker: Automatische Spulenzuordnung](./09-drucker.md#automatische-spulenzuordnung-auto-assignment)

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

---

## 11.4 Zusatzfelder (Extra Fields)

57076d	Manuel Weiser	2026-02-23 16:43:14
update

**URL:** `http(s)://url/admin/extra-fields`

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

![Zusatzfelder](../images/admin-extra-fields.png)

100

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.

101

102

| Spalte | Beschreibung |

103

|--------|-------------|

104

| **TARGET TYPE** | Ob das Feld für Filamente oder Spulen gilt |

105

| **KEY (JSON)** | Interner JSON-Schlüssel für das Feld |

106

| **DISPLAY LABEL** | Anzeigetext in der Benutzeroberfläche |

107

| **DEFAULT VALUE (OPTIONAL)** | Optionaler Standardwert |

108

109

Klicken Sie auf **„Add Field"** (oben rechts), um ein neues Zusatzfeld zu erstellen.

110

111

Beispiele für Zusatzfelder:

112

- „Trocknungszeit" für Spulen

113

- „Drucktemperatur" für Filamente

114

- „Lieferant" als ergänzendes Herstellerfeld

115

116

Wenn Zusatzfelder erstellt wurden, erscheinen diese als neue Eingabefelder in den entsprechenden Formularen (Spule hinzufügen, Filament hinzufügen).

117

118

---

119

ae873c	Manuel Weiser	2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.

120

## 11.5 System (Plugin-Verwaltung)

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

121

57076d	Manuel Weiser	2026-02-23 16:43:14
update

122

**URL:** `http(s)://url/admin/system`

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

123

124

![System-Einstellungen](../images/admin-system.png)

125

ae873c	Manuel Weiser	2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.

126

Der System-Bereich ist die zentrale Stelle für die **Plugin-Verwaltung**. Hier werden alle installierten Plugins angezeigt und verwaltet.

127

128

### Plugin-Übersicht

129

130

Die Plugin-Tabelle zeigt alle installierten Plugins mit folgenden Spalten:

131

132

| Spalte | Beschreibung |

133

|--------|-------------|

134

| **NAME** | Name und kurze Beschreibung des Plugins |

135

| **VERSION** | Installierte Version (z. B. 2.1.10) |

136

| **TYPE** | Art des Plugins: **Driver** (Druckertreiber), **Import** (Datenimport) oder **Integration** (Drittanbieter-Anbindung) |

137

| **AUTHOR** | Autor des Plugins |

138

| **STATUS** | Aktiviert/Deaktiviert — per Toggle-Schalter umschaltbar |

139

| **ACTIONS** | Details / Öffnen / Deinstallieren |

140

141

### Plugin installieren

142

143

Klicken Sie auf **„Install Plugin"** oben rechts. Es öffnet sich ein Dialog mit zwei Installationsmöglichkeiten:

144

145

#### Option 1: Aus der Plugin-Registry installieren (empfohlen)

146

147

1. Im Dropdown **„Install from Registry"** werden alle verfügbaren Plugins angezeigt

148

2. Die Liste wird automatisch aus dem offiziellen Plugin-Repository ([Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins)) auf GitHub geladen

149

3. Wählen Sie das gewünschte Plugin aus dem Dropdown — Name, Version und Beschreibung werden angezeigt

150

4. Klicken Sie auf **„Install Plugin"** um die Installation zu starten

151

5. FilaMan lädt das Plugin automatisch herunter, validiert es und installiert es

152

153

#### Option 2: ZIP-Datei manuell hochladen

154

155

1. Unterhalb des Registry-Dropdowns befindet sich der Bereich **„Plugin ZIP File"**

156

2. Ziehen Sie eine `.zip`-Datei per **Drag & Drop** in den markierten Bereich — oder klicken Sie darauf, um eine Datei auszuwählen

157

3. Die Datei wird automatisch validiert (Struktur, Manifest, Sicherheit)

158

4. Bei erfolgreicher Validierung erscheint eine Bestätigung mit Plugin-Details

159

5. Klicken Sie auf **„Install Plugin"** um die Installation abzuschließen

160

161

> **Hinweis:** Manuelle ZIP-Uploads sind für Entwickler oder für Plugins gedacht, die noch nicht in der offiziellen Registry verfügbar sind.

162

163

### Updates prüfen

164

165

Klicken Sie auf **„Check for Updates"** oben rechts neben dem Install-Button.

166

167

- FilaMan vergleicht die installierten Plugin-Versionen mit den neuesten Versionen in der Registry

168

- Wenn Updates verfügbar sind, wird eine Benachrichtigung mit der Anzahl der verfügbaren Updates angezeigt

169

- Jedes Plugin mit verfügbarem Update zeigt die neue Versionsnummer an

170

- Ein Update wird durch **erneutes Installieren** des Plugins aus der Registry durchgeführt — das bestehende Plugin wird dabei automatisch aktualisiert

171

172

### Plugin aktivieren / deaktivieren

173

174

Jedes Plugin kann über den **Toggle-Schalter** in der Status-Spalte aktiviert oder deaktiviert werden:

175

176

- **Aktiviert** — Das Plugin ist aktiv und seine Funktionen stehen zur Verfügung (z. B. Druckertreiber werden geladen)

177

- **Deaktiviert** — Das Plugin bleibt installiert, ist aber inaktiv. Bereits verbundene Drucker werden getrennt

178

179

### Plugin deinstallieren

180

181

1. Klicken Sie auf **„Uninstall"** in der Actions-Spalte des Plugins

182

2. Bestätigen Sie die Deinstallation im Bestätigungsdialog

183

3. Es erscheint eine zusätzliche Abfrage, ob auch die **Plugin-Daten** (z. B. Zusatzfelder, Drucker-Parameter) gelöscht werden sollen:

184

   - **Ja** — Entfernt das Plugin und alle zugehörigen Daten (Zusatzfelder, gespeicherte Parameter)

185

   - **Nein** — Entfernt nur das Plugin, die Daten bleiben erhalten (nützlich bei Neuinstallation)

186

187

### Plugin-Details

188

189

Klicken Sie auf **„Details"** um ausführliche Informationen zu einem Plugin anzuzeigen:

190

191

- Plugin-Name, Version und Beschreibung

192

- Plugin-Typ (Driver / Import / Integration)

193

- Autor und Homepage

194

- Unterstützte Fähigkeiten (z. B. AMS-Unterstützung, RFID, Auto-Match)

195

- Liste der vom Plugin erstellten Drucker-Parameter

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

196

197

---

198

199

## 11.6 Gefahrenzone

200

201

Am unteren Ende des Admin-Panels befindet sich die rot markierte **Danger Zone** mit einer kritischen Aktion:

202

203

> ⛔ **„Delete all data"**

204

> Löscht **dauerhaft** alle Spulen, Filamente, Hersteller, Farben, Lagerorte und Drucker einschließlich aller Logs und Ereignisse.  

205

> **Benutzerkonten, Rollen, Berechtigungen und Geräte bleiben davon unberührt.**  

206

> Diese Aktion kann **nicht rückgängig gemacht** werden!

207

208

---

209

210

← [Zurück: Einstellungen](./10-einstellungen.md) | [Weiter: Farbverwaltung →](./12-farbverwaltung.md)