Initialer Import des AssetManagers

README.md

@@ -0,0 +1,112 @@
+# AssetManager 0.5.5.27
+
+AssetManager ist eine selbst gehostete Webanwendung zur Verwaltung von IT- und sonstigen Betriebsmitteln. Das Projekt wird unter der **Apache License 2.0** veröffentlicht und darf privat sowie kommerziell genutzt, verändert und weitergegeben werden.
+
+## Funktionsumfang
+
+- frei konfigurierbare Asset-Kategorien, Felder und Statuswerte
+- Assetlisten, Detailansichten, Historie, Ausgabe und Rückgabe
+- Excel-Import und -Export, Sammeländerungen, Zusammenführen und Baumansicht
+- Hardware- und Softwareinventur
+- Jobdefinitionen und Jobausführung mit Status, Callback, Wiederholung und Protokollen
+- lokale Benutzerverwaltung und optionale LDAP-Anmeldung
+- geschütztes lokales Notfallkonto auch bei aktiviertem LDAP
+- Rollen, Sichtbarkeitsregeln, Übersetzungen, Darkmode und anpassbare Darstellung
+- integrierte Sicherungs- und Wiederherstellungsfunktionen
+- optionale MeshCentral-Anbindung über die MeshCtrl-Kommandozeilenschnittstelle
+
+## MeshCentral-Integration
+
+Die Integration ist optional. AssetManager verwendet MeshCtrl für unterstützte Geräteabfragen und Remote-Aufträge. Es erfolgt kein direkter Zugriff auf die MeshCentral-Datenbank. MeshCentral und MeshCtrl sind eigenständige Drittprojekte und nicht Bestandteil dieses Repositorys; sie werden beim Docker-Build als Abhängigkeit installiert.
+
+## Voraussetzungen
+
+- Docker Engine mit Docker Compose
+- ein für den Server geeigneter DNS-Name und HTTPS-Reverse-Proxy werden für produktive Installationen empfohlen
+- optional eine erreichbare MeshCentral-Instanz
+- optional LDAP/Active Directory
+
+## Installation
+
+```bash
+cp .env.example .env
+```
+
+Ändere in `.env` mindestens:
+
+```env
+POSTGRES_PASSWORD=CHANGE_ME
+SESSION_SECRET=CHANGE_ME_LONG_RANDOM
+LOCAL_ADMIN_USERNAME=emergency-admin
+LOCAL_ADMIN_PASSWORD=CHANGE_ME_MIN_12_CHARS
+```
+
+Danach:
+
+```bash
+docker compose up -d --build
+```
+
+Standardmäßig ist die Anwendung unter Port `8088` erreichbar.
+
+## Persistente Daten
+
+Die Laufzeitdaten werden über Bind-Mounts unter `data/` gespeichert:
+
+```text
+data/
+├── config/       Anwendungskonfiguration
+├── postgres/     PostgreSQL-Datenbank
+├── uploads/      hochgeladene Dateien
+├── logs/         Protokolle und Diagnosedaten
+├── backups/      Anwendungssicherungen
+└── scripts/      bereitgestellte Skripte
+```
+
+Diese Inhalte sowie `.env` enthalten möglicherweise Zugangsdaten oder personenbezogene beziehungsweise betriebliche Daten und dürfen nicht in ein öffentliches Repository aufgenommen werden.
+
+## Aktualisierung
+
+Vor einer Aktualisierung immer `.env` und den gesamten Ordner `data/` sichern. Danach den neuen Quellstand über den bestehenden Projektordner kopieren und ausführen:
+
+```bash
+docker compose down
+docker compose up -d --build
+docker compose logs --tail=100 -f
+```
+
+## Öffentlichen Quellstand erzeugen
+
+Der Exporter erstellt ein bereinigtes ZIP mit genau einem Hauptordner `assetmanager/`:
+
+```bash
+python tools/create_github_source.py
+```
+
+Vor dem Export prüft das Skript unter anderem Versionen, Lizenzangaben, vertrauliche Laufzeitdateien und unerwünschte Produktvergleiche.
+
+## Prüfungen
+
+```bash
+python tools/check_public_release.py
+python tools/check_translations.py
+python tools/validate_release.py
+```
+
+## Drittkomponenten
+
+Die direkten Abhängigkeiten und ihre Lizenztypen sind in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) aufgeführt. Beim Docker-Build werden zusätzlich die Lizenzdateien der tatsächlich installierten Python- und Node.js-Pakete unter `/app/THIRD_PARTY_LICENSES/` gesammelt.
+
+## Mitwirken
+
+Beiträge und Forks sind willkommen. Hinweise zur Einreichung stehen in [CONTRIBUTING.md](CONTRIBUTING.md). Eine Einreichung ist ein Vorschlag; es besteht kein Anspruch auf Aufnahme in das offizielle Projekt.
+
+## Sicherheit
+
+Sicherheitsprobleme bitte nicht mit vertraulichen Details in einer öffentlichen Issue melden. Siehe [SECURITY.md](SECURITY.md).
+
+## Lizenz
+
+Copyright © 2026 Roland Reich
+
+Lizenziert unter der Apache License, Version 2.0. Der vollständige Lizenztext befindet sich in [LICENSE.txt](LICENSE.txt).