101 lines
3.1 KiB
Markdown
101 lines
3.1 KiB
Markdown
# 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](https://git.eckertplayground.de/taarly/PHP_AdminTool_Projekt/wiki) 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:
|
||
|
||
- Produktion (`main`): https://itfa.schraubenfuzzi.de
|
||
- Test (`develop`): https://test.itfa.schraubenfuzzi.de
|
||
|
||
---
|
||
|
||
## 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](https://git.eckertplayground.de/taarly/PHP_AdminTool_Projekt/wiki) 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.
|
||
|