taarly/PHP_AdminTool_Projekt
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Admin Tool Projekt für das Fach PHP
73 Commits 5 Branches 0 Tags 5.5 MiB
CSS 68.3%
PHP 28.5%
JavaScript 3.2%
4127323530
Go to file
blaerf 4127323530 LDAP Connection URI angepasst (#21) 
Reviewed-on: https://git.eckertplayground.de/taarly/PHP_AdminTool_Projekt/pulls/21
2025-12-05 08:24:36 +00:00
app LDAP Connection URI angepasst 2025-12-05 09:08:14 +01:00
config Logging-Service hinzugefügt 2025-12-05 08:34:37 +01:00
docs Erstes Commit mit neuer Ordnerstruktur 2025-11-15 18:56:41 +01:00
public LDAP Connection URI angepasst (#21) 2025-12-05 08:24:36 +00:00
scripts Ordner Struktur aktualisiert 2025-11-15 19:05:40 +01:00
.gitignore ldap/benutzer-und-gruppen-anzeigen (#4) 2025-11-27 13:29:28 +00:00
CHANGELOG.md snmp_update2 (#14) 2025-12-04 03:30:46 +00:00
README.md README.md aktualisiert 2025-11-28 05:04:44 +00:00

README.md

PHP_AdminTool_Projekt

Dieses Repository enthält das gemeinsame PHP AdminTool, das auf IIS unter Windows betrieben wird und über LDAP/AD, SNMP und PowerShell administrative Aufgaben ermöglicht. Das Projekt wird von mehreren Entwicklern gepflegt und folgt einem klar definierten Workflow, um Qualität, Stabilität und Nachvollziehbarkeit sicherzustellen.

Ein zentraler Bestandteil der Arbeit mit diesem Repository ist der verbindliche Gitea-Workflow im Wiki.

Hinweis: Der Gitea-Workflow ist zwingend zu lesen und einzuhalten. Er legt fest, wie Branches erstellt, gemerged und getestet werden.

Überblick

Das Projekt dient als webbasiertes Administrationswerkzeug und umfasst unter anderem:

  • LDAP/AD‑Anbindung (LDAPS)
  • Benutzer- und Gruppenverwaltung
  • SNMP‑Auswertungen
  • PowerShell‑Integration
  • Weboberfläche zur zentralen Administration

Die Anwendung läuft in zwei Umgebungen:

Ordnerstruktur (Auszug)

  • app/ – Anwendungscode
  • public/ – Webroot
  • config/ – Konfigurationen für LDAP, Systemvariablen usw.
  • scripts/ – Hilfs- und Bereitstellungsskripte
  • docs/ – interne Dokumente
  • .gitignore – ausgeschlossene Dateien

Workflow

Die Entwicklung folgt einem strengen, verbindlichen Ablauf:

  1. Feature‑Branch erstellen (feature/name)
  2. Feature entwickeln, committen, pushen
  3. PR nach develop für Tests auf der Testinstanz
    • wird vom Autor selbst gemerged
    • Branch bleibt bestehen
  4. Nach bestandenem Test: PR nach main
    • mit Review
    • Merge per Squash
    • danach wird der Feature‑Branch gelöscht

Details stehen im Wiki.

Wichtiger Hinweis:
Der komplette Ablauf ist im Gitea-Workflow beschrieben und muss befolgt werden.

Aufgaben

Aufgabe Benutzer
Benutzer und Gruppen über LDAP anzeigen Jens E (@blaerf), Stefan W (@viperion)
SNMP Serverstatus abfragen / anzeigen Thomas G (@tg95)
PHP-Powershell Anbindung Marco Z (@Taarly)
Powershell Script für einzelne Benutzer und CSV Import Alle Fisis
UI/UX anpassen Yasin B (@Muchentuchen), Alexander M (@Alexander), Torsten J (@tojacobs)

Dokumentation

Alle weiteren Informationen wie Regeln, technische Details, Konzepte und Anleitungen befinden sich im Wiki:

Wiki → Gitea‑Workflow
Wiki → Implementierung / LDAP / IIS / Setup

Dieser Bereich muss von allen Entwicklern gelesen werden, bevor am Projekt gearbeitet wird.

Mitwirken

Wer etwas ändern oder erweitern möchte:

  • Branch vom aktuellen Stand erstellen
  • Entwickeln, Committen, Pushen
  • PR zuerst nach develop, später nach bestandenen Tests nach main
  • Reviewer zuweisen (für main)

Nur tested und reviewed Code gelangt in die Produktion.

Ziel

Das AdminTool soll eine wartbare, erweiterbare und zuverlässige Verwaltungsoberfläche bieten, die zentrale Aufgaben des AD‑Umfelds über eine moderne Weboberfläche ermöglicht.