Merge branch 'main' of https://git.kocoder.xyz/Diplomarbeit-Absolventenverein/pm

nnung

01-Allgemein.md

@@ -8,6 +8,16 @@ Der Absolventenverein verwaltet derzeit rund 300 Alumni, deren Daten in einer CS
 ### Zielsetzung
 Ziel der Diplomarbeit ist es, ein Content-Management-System als Basis für eine innovative, barrierefreie und sichere Website des Absolventenvereins zu nutzen, dabei vorhandene Funktionen des CMS anzupassen und eigene Module wie eine Eventanmeldung, eine Hall of Fame, ein Schwarzes Brett als Kommunikationsplattform sowie einen Premiumbereich zu entwickeln. Die Anwendung soll modular, erweiterbar und leicht wartbar sein und auf einem Schulserver betrieben werden, um eine kontrollierte und geschützte Umgebung für die Verwaltung der Mitglieder- und Veranstaltungsdaten zu gewährleisten. 
 
+### Tatsächliches Ergebnis
+
+Im Rahmen des Projekts konnten alle priorisierten Tickets aus dem Product Backlog erfolgreich umgesetzt werden.
+
+Konstantin Hintermayer übernahm als Product Owner die Kommunikation mit dem Auftraggeber und stellte einen funktionsfähigen Linux-Server als technische Grundlage bereit. Zusätzlich erarbeitete er Skripte sowie Dokumentationen zur Serverlandschaft und führte die Grundkonfiguration des CMS durch. Weiters wurden die Module „Auswertung“ und „Schwarzes Brett“ erfolgreich an den Kunden übergeben.
+
+Adam Gaiswinkler war für die Dokumentation der Benutzeroberfläche und des Backends sowie für die Entwicklung eines CMS-Moduls zur Anmeldung und für die „Hall of Fame“ verantwortlich. Auch die grundlegende Konfiguration des CMS wurde erfolgreich umgesetzt.
+
+Florian Edlmayer entwickelte ein funktionierendes CMS-Modul für den Premiumbereich der Absolventen. Zusätzlich erstellte er eine vollständige und gesetzeskonforme Datenschutzerklärung. Ein weiterer wichtiger Bestandteil war die erfolgreiche Implementierung einer OAuth-Authentifizierung über LinkedIn.
+
 ## Das Team
 Konstantin Hintermayer
 
@@ -34,6 +44,160 @@ E-Mail: [adam.gaiswinkler@edu.szu.at]
 Individuelle Themenstellung:Entwicklung zweier CMS-Module: (Anmeldetool für Treffen und Hall of Fame), Grundkonfiguration des CMS, Starker Fokus auf nutzerfreundliches und responsives Design, Web-Entwicklung mit C# und ASP.NET. 
 
 ## Fachliches Umfeld(Technologien)
+Im fachlichen Umfeld dieser Diplomarbeit kommt das Content-Management-System Oqtane zum Einsatz. Oqtane basiert auf modernen Webtechnologien wie ASP.NET Core und der Plattform .NET und ermöglicht die Entwicklung modularer und skalierbarer Webanwendungen. Durch seine komponentenbasierte Architektur können Funktionen in Form von Modulen flexibel entwickelt und in die Anwendung integriert werden. Dies erleichtert sowohl die Erweiterbarkeit als auch die Wartung der Plattform. Besonders im Kontext dieser Arbeit bietet Oqtane eine geeignete Grundlage, um eine dynamische und benutzerorientierte Alumni-Plattform umzusetzen, da sowohl Inhalte als auch Benutzerverwaltung effizient verwaltet werden können. 
+
+Siehe Details unter: Konstantin Hintermayer individueller Teil
+
+# Projektplannung
+
+## Projektziele
+
+### Hauptziele
+
+- **HZ01 – Verwaltung von Absolventenprofilen**
+Das System ermöglicht die zentrale Erstellung und Pflege individueller Profile für Absolventen.
+
+- **HZ02 – Organisation von Veranstaltungen**
+Die Applikation stellt Funktionen zur Planung und Durchführung von Vereinstreffen und Events bereit.
+
+- **HZ03 – Darstellung der Hall of Fame**
+Besondere Leistungen und Erfolge von Absolventen werden in einer digitalen Ehrengalerie präsentiert.
+
+- **HZ04 – Firmen- und Jobstellenmarkt**
+Integration einer Plattform für Stellenangebote, Praktika und die Vernetzung mit Partnerunternehmen.
+
+- **HZ05 – Zugriffsverwaltung und Sicherheit**
+Implementierung einer rollenbasierten Zugriffskontrolle und Gewährleistung der Datensicherheit nach DSGVO-Standard.
+
+- **HZ06 – Schülerzugang und CMS**
+Einbindung eines Redaktionssystems für Beiträge und eines speziellen Zugangs für aktuelle Schüler.
+
+### Hardwareanforderungen und Infrastruktur
+
+- **HW01 – Benutzerkapazität (300 Nutzer)**
+Das System unterstützt mindestens 300 gleichzeitig registrierte Benutzer für Administration und Nutzung.
+
+- **HW02 – Aktive Zugriffsrate (50 Zugriffe/Tag)**
+Die Infrastruktur ist auf ca. 50 tägliche aktive Nutzer ohne Performanceverluste ausgelegt.
+
+- **HW03 – Einfache Skalierbarkeit**
+Die Architektur erlaubt eine flexible Erweiterung der Ressourcen ohne strukturelle Änderungen.
+
+- **HW04/05 – Hochverfügbarkeit (99,5 %)**
+Der Betrieb erfolgt auf skalierbaren Cloud-Servern mit einer angestrebten Verfügbarkeit von 99,5 % pro Jahr.
+
+- **HW07 – Disaster Recovery (24h)**
+Im Falle eines Totalausfalls muss das System innerhalb von 24 Stunden wieder benutzbar sein.
+
+• **HW12/13 – Automatisierte Sicherung**
+Implementierung einer automatisierten Datensicherung für Datenbanken und Binaries auf unabhängigen Speichern.
+
+• **RED-1 – Redundanz der Datenbank**
+Die Datenbank wird zur Ausfallsicherheit redundant geführt und nutzt automatische Master-Promotion im Fehlerfall.
+
+### Schnittstellenanforderungen
+
+- **SnT-1 – REST-API (Frontend/Backend)**
+Bereitstellung einer API zur Kommunikation zwischen dem Oqtane-CMS und dem Blazor-Frontend für dynamische CRUD-Operationen.
+
+- **SnT-2 – SMTP-E-Mail-Versand (Brevo)**
+Einbindung des Brevo SMTP-Dienstes für den Versand von bis zu 300 transaktionalen E-Mails pro Tag.
+
+- **SnT-3 – LinkedIn OAuth (Phase 2)**
+Schnittstelle zur Authentifizierung und zum automatisierten Abruf von Profildaten über LinkedIn.
+
+### Software und Zugriffsverwaltung
+
+- **SW-1/2 – Barrierefreiheit und Browser-Support**
+Unterstützung gängiger Browser und Einhaltung des WCAG 2.1 AA Standards für Barrierefreiheit.
+
+- **SW-4 – Sicherer Administrationszugriff**
+Administrativer Zugriff erfolgt ausschließlich über eine verschlüsselte VPN-Verbindung (Wireguard) und SSH.
+
+- **ZUG-1–4 – Authentifizierung und Rollen**
+Implementierung klassischer Login-Verfahren, Passwort-Reset-Funktionen und einer detaillierten Benutzerverwaltung für Administratoren.
+
+- **ZUG-6/7 – Magic Link und 2FA (Phase 2)**
+Erweiterung der Sicherheit durch passwortlose Anmeldung via E-Mail-Link und Zwei-Faktor-Authentifizierung.
+
+### Funktionsmodule (Phase 2)
+
+- **HoF-1/2 – Hall of Fame Funktionen**
+Nutzer können ihre Erfolge online präsentieren und als ansprechendes PDF für Treffen exportieren.
+
+- **JOB-1/2 – Job- und Praktikumsbörse**
+Plattform für Stellenanzeigen und Bewerbungen inklusive Dashboard für Arbeitgeber und statistischen Auswertungen.
+
+- **PRE-1–3 – Premiumbereich**
+Exklusiver Zugang für Premiummitglieder inklusive Einsicht in Ingenieuranträge und erweiterter Event-Organisation.
+
+- **ScB-1–4 – Schwarzes Brett**
+Ein interaktiver Feed für Nachrichten, Event-Ankündigungen und Werbung mit integriertem Meldesystem für Inhalte.
+
+- **AfT-1–5 – Anmeldetool für Treffen**
+Umfassendes Tool zur Eventerstellung, zum Versand von Einladungen (E-Mail/SMS) und zur Zielgruppenfilterung.
+
+- **Pro-1–4 – Erweiterte Profilverwaltung**
+Nutzer können ihre Daten manuell pflegen oder automatisiert mit ihrem LinkedIn-Profil abgleichen lassen.
+
+### Daten und Dokumentation
+
+- **DB-1 – PostgreSQL Datenbank**
+Entwicklung eines relationalen Datenbankdesigns inklusive Indizierung und Verschlüsselung zur Gewährleistung der Datenintegrität.
+
+- **DOK-1–6 – Projektdokumentation**
+Erstellung aller notwendigen Handbücher (Benutzer, Admin, Git) und des Disaster-Recovery-Handbuchs.
+
+### Nicht-Ziele
+
+- **NZ01 – Zahlungsprozesse**
+Die technische Abwicklung von Zahlungen im Premiumbereich liegt außerhalb des Projektscopes.
+
+- **NZ02 – Externe Kalenderlösungen**
+Die Integration externer Dienste wie V-Calendar oder V-Event ist nicht vorgesehen.
+
+
+## Aufgabenverteilung
+### Konstantin Hintermayer
+Themenstellung: 
+Die individuelle Themenstellung umfasst die Konzeption und Umsetzung der Infrastruktur sowie die Entwicklung von Modulen für Auswertungen und ein Schwarzes Brett innerhalb der Plattform.
+Auflistung der einzelnen Ziele und Anforderungen:
+- HW01
+- HW02
+- HW03
+- HW04/05
+- HW07
+- RED-1
+- SW-4
+- ScB-1–4
+
+### Florian Edlmayer
+Themenstellung: 
+Die individuelle Themenstellung umfasst die Entwicklung eines Premiumbereichs sowie die Umsetzung von Datenschutz- und Informationssicherheitsmaßnahmen, einschließlich Zugriffs- und Profilverwaltung.
+
+Auflistung der einzelnen Ziele und Anforderungen:
+- HZ01
+- HZ05
+- HW12/13
+- SnT-3
+- ZUG-1–4
+- ZUG-6/7
+- PRE-1–3
+- Pro-1–4
+- DB-1
+
+### Adam Gaiswinkler
+Themenstellung: 
+Die individuelle Themenstellung umfasst die Entwicklung einer Hall of Fame, die Implementierung eines Anmeldetools für Treffen sowie die Konfiguration des Content-Management-Systems.
+Auflistung der einzelnen Ziele und Anforderungen:
+- HZ02
+- HZ03
+- HZ06
+- SnT-2
+- SW-1/2
+- HoF-1/2
+- AfT-1–5
+
 
 
 # Allgemeines