feat: integriertes Dokumentations-Wiki für NetBox hinzufügen

- Markdown-Dokumentationen direkt in NetBox erstellen
- Dokumente Standorten, Racks, Geräten, VMs und Clustern zuordnen
- DOCX-, XLSX-, PDF-, Markdown- und Textimporte unterstützen
- REST-API, Suche, Berechtigungen und Änderungsprotokoll ergänzen
- Installation, Konfiguration und Importgrenzen dokumentieren

README.md

@@ -0,0 +1,109 @@
+# NetBox Documentation
+
+Ein in NetBox integriertes Markdown-Wiki für Betriebsdokumentationen und Anleitungen.
+
+## Funktionen
+
+- Dokumentationen direkt in NetBox als Markdown schreiben und sicher gerendert anzeigen
+- Eine Dokumentation mehreren Objekten zuordnen und umgekehrt
+- Unterstützte Standardobjekte: Region, Standort, Location, Rack, Gerät, VM, VM-Cluster und Mandant/Kunde
+- DOCX, XLSX/XLSM, textbasierte PDF-, Markdown- und Textdateien importieren
+- Originaldatei optional zusammen mit der Dokumentation aufbewahren
+- Dokumentationen über die globale NetBox-Suche und per REST-API finden
+- NetBox-Berechtigungen, Änderungsprotokoll, Tags und Custom Fields verwenden
+
+## Kompatibilität
+
+Die Version `0.1.0` zielt auf NetBox 4.x (mindestens 4.0). Vor einem produktiven Rollout sollte das Plugin gegen die konkret eingesetzte NetBox-Minor-Version in einer Testinstanz geprüft werden.
+
+## Installation
+
+Im Python-Virtualenv der NetBox-Installation:
+
+```bash
+source /opt/netbox/venv/bin/activate
+pip install /pfad/zu/Netbox-DokiWiki
+```
+
+In `configuration.py`:
+
+```python
+PLUGINS = [
+    "netbox_documentation",
+]
+
+PLUGINS_CONFIG = {
+    "netbox_documentation": {
+        "max_import_size_mb": 25,
+        "keep_imported_file": True,
+        "allowed_object_types": [
+            "dcim.region",
+            "dcim.site",
+            "dcim.location",
+            "dcim.rack",
+            "dcim.device",
+            "virtualization.virtualmachine",
+            "virtualization.cluster",
+            "tenancy.tenant",
+        ],
+    }
+}
+```
+
+Danach:
+
+```bash
+cd /opt/netbox/netbox
+python manage.py migrate
+python manage.py collectstatic --no-input
+sudo systemctl restart netbox netbox-rq
+```
+
+Für Docker-Installationen das Paket in das NetBox-Image aufnehmen, Plugin und Konfiguration setzen und anschließend das Image neu bauen. Die hochgeladenen Originaldateien liegen im konfigurierten NetBox-`MEDIA_ROOT`; dieses Verzeichnis muss persistent gespeichert und gesichert werden.
+
+## Berechtigungen
+
+Die benötigten Rechte können in NetBox unter **Admin → Benutzer → Berechtigungen** vergeben werden:
+
+- `netbox_documentation.view_document`
+- `netbox_documentation.add_document`, `change_document`, `delete_document`
+- `netbox_documentation.view_documentassignment` sowie die entsprechenden Änderungsrechte
+- `netbox_documentation.import_document` für Office-/PDF-Importe
+
+Objektbezogene NetBox-Constraints sollten zusätzlich passend zu Mandanten und Verantwortungsbereichen gesetzt werden. Nicht veröffentlichte Dokumente sind als Redaktionsstatus gedacht; sie ersetzen keine Objektberechtigung.
+
+## Importverhalten
+
+| Format | Übernahme |
+|---|---|
+| DOCX | Überschriften, Absätze, Listen, Links und einfache Tabellen nach Markdown |
+| XLSX/XLSM | Jedes Tabellenblatt als eigene Markdown-Tabelle; Formelergebnisse nur, wenn Excel sie zuvor gespeichert hat |
+| PDF | Extrahierbarer Text, nach Seiten gegliedert |
+| MD/TXT | Direkte Übernahme (UTF-8) |
+
+Alte binäre `.doc`- und `.xls`-Dateien müssen vorher in `.docx` bzw. `.xlsx` konvertiert werden. Gescannte PDFs benötigen OCR, die in dieser Version bewusst noch nicht enthalten ist. Komplexe Word-/PDF-Layouts, eingebettete Bilder und Excel-Formatierungen können nicht verlustfrei nach Markdown übertragen werden.
+
+## REST-API
+
+Nach Aktivierung stehen die üblichen NetBox-Plugin-Endpunkte bereit:
+
+- `/api/plugins/documentation/documents/`
+- `/api/plugins/documentation/assignments/`
+
+## Entwicklung und Tests
+
+```bash
+pip install -e ".[test]"
+pytest
+```
+
+Für vollständige UI-/API-Tests muss NetBox im selben Virtualenv verfügbar sein. Die reinen Importtests befinden sich unter `netbox_documentation/tests/`.
+
+## Nächste sinnvolle Ausbaustufen
+
+- OCR für gescannte PDFs (z. B. Tesseract/OCRmyPDF als optionaler Worker)
+- eingebettete DOCX-Bilder als NetBox-Medien übernehmen
+- echte Dokumentrevisionen mit Vergleich und Freigabeprozess
+- asynchroner Massenimport großer Excel-Bestände über NetBox-RQ
+- Vorlagen und automatisch vererbte Dokumentation entlang Region → Standort → Gerät
+