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

00-praemble.md

@@ -2,31 +2,17 @@
 
 # Kurzfassung {.unnumbered .unlisted}
 
-Die vorliegende Diplomarbeit dokumentiert die Konzeption, Planung und Entwicklung der Webanwendung „AlumniHub“, einer zentralen Plattform für den Absolventenverein der Höheren Technischen Bundeslehr- und Versuchsanstalt (HTL) Schulzentrum Ungargasse (SZU). Die Ausgangslage des Projekts war die dezentrale und stark manuelle Verwaltung von rund 300 Alumni mittels CSV-Dateien sowie das Auslaufen einer bestehenden Lizenz für Event-Anmeldungen. Der Fokus des Projekts lag darauf, ein modernes, barrierefreies, skalierbares und zukunftssicheres System zu schaffen. Es sollte nicht nur ein reines Verwaltungstool sein, sondern eine interaktive Plattform, die die Kommunikation, die Veranstaltungsorganisation und vor allem das professionelle Networking nachhaltig vereint.
+Die vorliegende Diplomarbeit dokumentiert die Entwicklung der Webanwendung „AlumniHub“, einer zentralen Plattform für den Absolventenverein der HTL Ungargasse, welche die bisherige manuelle Verwaltung durch ein modernes, automatisiertes System ablöst. Ziel war es, eine interaktive Plattform auf Basis von ASP.NET Core, Blazor und dem Oqtane CMS zu schaffen, die Kommunikation, Veranstaltungsorganisation und professionelles Networking vereint.
 
-Die technische Realisierung der Software erfolgte unter Anwendung agiler Projektmanagement-Methoden (Scrum) auf Basis moderner Webtechnologien aus dem Microsoft-Ökosystem. Hauptsächlich kam das auf ASP.NET Core und Blazor aufbauende Content-Management-System (CMS) Oqtane zum Einsatz. Durch dessen modulare Architektur wurden die spezifischen Anforderungen des Absolventenvereins in Form von individuell entwickelten Modulen von Grund auf neu programmiert und nahtlos in ein Gesamtsystem integriert.
-
-Die Teammitglieder teilten sich die Umsetzung des Projekts in klar abgegrenzte, spezialisierte Verantwortungsbereiche auf:
-**Konstantin Hintermayer** (Product Owner) verantwortete als Projektleiter die Konzeption und Bereitstellung der Server-Infrastruktur unter Linux (inklusive Evaluation von Hosting-Anbietern und Migration zu LiveDesign). Er entwickelte die Datenbankarchitektur mit PostgreSQL, implementierte automatisierte Sicherheitsbackups (Disaster Recovery) sowie eine kontinuierliche Bereitstellungspipeline (CI/CD) über Gitea Actions. Inhaltlich programmierte er die Module für das digitale „Schwarze Brett“ als Kommunikationsdrehscheibe und entwickelte automatisierte Modulfunktionen wie grafische Datenauswertungen der Registrierungen sowie tägliche E-Mail-Rundschreiben.
-**Adam Gaiswinkler** konzentrierte sich auf das Frontend und die Benutzeroberfläche. Er entwickelte ein spezifisches, komplett responsives Oqtane-Theme, das stark am offiziellen Schuldesign orientiert ist, und legte dabei besonderen Wert auf eine herausragende User Experience (UX), auch auf mobilen Endgeräten. Zudem implementierte er ein interaktives Anmeldetool für Veranstaltungen sowie das Modul „Hall of Fame“, in dem herausragende berufliche Werdegänge von Absolventinnen und Absolventen in Szene gesetzt werden. Dabei integrierte er eine Lösung für dynamische, maßgeschneiderte PDF-Profil-Exporte via QuestPDF.
-**Florian Edlmayer** konzipierte und entwickelte das Herzstück für erweiterte Zugriffsrechte: Einen exklusiven Premiumbereich. Dieses Feature beinhaltet neben einer zielgerichteten Mitgliedersuche samt Kontaktfunktion auch einen vollständig nachvollziehbaren, digitalen Freigabeworkflow für Ingenieursanträge der Absolventen. Zusätzlich sorgte er durch die Ausarbeitung einer umfassenden Datenschutzerklärung für die notwendige rechtliche Konformität nach DSGVO-Richtlinien und übernahm die informationelle Sicherheit der Plattform, indem er Single-Sign-On Mechanismen über OAuth 2.0 (LinkedIn-Login) sowie rollenbasierte Rechte logisch integrierte.
-
-Als Gesamtergebnis der Arbeit entstand eine leistungsstarke, sicher gehostete und hochgradig benutzerfreundliche Plattform, die den administrativen Aufwand aufseiten des Vereins signifikant reduziert. Den Absolventen der HTL Ungargasse wird durch „AlumniHub“ ein zentraler, digitaler Ort geboten, um miteinander vernetzt zu bleiben, von einem gegenseitigen Erfahrungsaustausch zu profitieren und ihre Karrieren aktiv in die Schulgemeinschaft einzubinden.
+Die technische Umsetzung erfolgte arbeitsteilig: **Konstantin Hintermayer** (Product Owner) verantwortete die Linux-Serverinfrastruktur, die PostgreSQL-Datenbank, CI/CD-Pipelines sowie automatisierte Modulfunktionen wie das interaktive „Schwarze Brett“. **Adam Gaiswinkler** gestaltete ein responsives Schuldesign (UX) und implementierte sowohl ein Event-Anmeldetool als auch eine „Hall of Fame“ mit automatisierten PDF-Profil-Exporten. **Florian Edlmayer** konzipierte den exklusiven Premiumbereich mit digitalem Freigabeworkflow, gewährleistete die Einhaltung der DSGVO-Richtlinien und integrierte ein sicheres Single-Sign-On-Verfahren (OAuth 2.0 via LinkedIn). Im Ergebnis entstand eine leistungsstarke Plattform, die den administrativen Aufwand des Vereins signifikant minimiert.
 
 \cleardoublepage
 
 # Abstract {.unnumbered .unlisted}
 
-This diploma thesis documents the design, planning, and development of the web application "AlumniHub," a centralized digital platform created for the alumni association of the HTL Ungargasse (SZU). The project was initiated to replace the decentralized and highly manual management of approximately 300 alumni, previously handled via simple CSV files, and to provide a new solution for event registrations due to the expiration of a critical software license. The primary goal of the project was to establish a modern, accessible, scalable, and future-proof system. It was designed not merely to function as an administrative tool, but to act as an interactive ecosystem that sustainably unifies member communication, event organization, and professional networking.
+This diploma thesis documents the development of "AlumniHub," a centralized web platform for the alumni association of the HTL Ungargasse, replacing previous manual administration with a modern, automated system. The primary goal was to create an interactive ecosystem based on ASP.NET Core, Blazor, and the Oqtane CMS that unifies communication, event organization, and professional networking.
 
-Technically, the software was realized using agile project management methodologies (Scrum) and advanced web technologies rooted in the Microsoft ecosystem. The core foundation was the Oqtane Content Management System (CMS), built securely on ASP.NET Core and Blazor. Oqtane's modular software architecture enabled the team to code custom features tailored to the exact requirements of the alumni association from scratch and integrate them seamlessly into a cohesive platform.
-
-The project team strategically partitioned the workload into highly specialized areas of responsibility:
-**Konstantin Hintermayer** (Product Owner) operated as the project manager, taking charge of the conceptualization and deployment of the server infrastructure on Linux OS (including the evaluation of hosting providers and subsequent migration to LiveDesign). He designed the relational database architecture using PostgreSQL, implemented automated security backups (Disaster Recovery routines), and configured continuous integration and deployment (CI/CD) workflows via Gitea Actions. In terms of software development, he built the digital "Blackboard" (Schwarzes Brett) module acting as a dynamic communication hub, alongside features for graphical data analytics and scheduled automated email digests.
-**Adam Gaiswinkler** dedicated his efforts to the frontend and user interface design. He developed a fully responsive, custom Oqtane theme closely aligned with the school's corporate design, placing a strong emphasis on providing an exceptional User Experience (UX) across desktop and mobile devices. Furthermore, he engineered an interactive event registration tool and created the "Hall of Fame" module, an area dedicated to showcasing the outstanding career progressions of former students. For this module, he innovatively integrated an automated, customized PDF profile generation engine based on QuestPDF.
-**Florian Edlmayer** was the lead architect and developer for the implementation of advanced access protocols via the creation of an exclusive Premium Area. This expansive module introduces targeted member search functionalities and implements a completely digital, transparent approval workflow for engineering applications submitted by graduates. Recognizing the critical importance of data privacy, he also drafted comprehensive data protection guidelines ensuring strict compliance with the General Data Protection Regulation (GDPR). To robustly secure the application infrastructure, he integrated Role-Based Access Controls alongside Single Sign-On (SSO) authentication mechanisms, leveraging OAuth 2.0 (specifically LinkedIn login).
-
-The resulting product is a high-performing, securely hosted, and remarkably user-friendly platform that considerably minimizes the administrative burden previously borne by the association. Above all, "AlumniHub" serves as a central, digital home for the graduates of HTL Ungargasse, reliably ensuring they stay connected, share valuable professional experiences, and maintain an active relationship with their broader school community.
+The technical implementation was divided into specialized areas: **Konstantin Hintermayer** (Product Owner) managed the Linux server infrastructure, PostgreSQL database, CI/CD pipelines, and automated module functions such as the digital "Blackboard." **Adam Gaiswinkler** designed a responsive, school-branded user interface (UX) and implemented an event registration tool alongside a "Hall of Fame" featuring automated PDF profile exports. **Florian Edlmayer** developed an exclusive Premium Area with a digital approval workflow, ensured GDPR compliance, and integrated a secure Single Sign-On system (OAuth 2.0 via LinkedIn). The resulting product is a high-performing platform that significantly reduces the association's administrative workload.
 
 \newpage
 
@@ -44,6 +30,20 @@ Als wir im Oktober kurzfristig eine neue Produktionsumgebung benötigten, wurde
 
 Für den „frischen Wind“ und das sorgfältige Korrekturlesen der Arbeit bedanken wir uns herzlich bei Frau Prof. Gertrude Brindlmayer. Ihr geschulter Blick auf Details, die dem Team im Arbeitsprozess entgangen waren, stellte eine große Bereicherung für die finale Qualität dieser Arbeit dar.
 
+# Vorwort {.unnumbered .unlisted}
+
+Die vorliegende Diplomarbeit entstand im Schuljahr 2025/2026 an der Höheren Technischen Bundeslehr- und Versuchsanstalt (HTL) Schulzentrum Ungargasse (SZU) in enger Kooperation mit dem lokalen Absolventenverein. 
+
+Unsere Motivation für dieses Projekt entsprang dem gemeinsamen Wunsch, die in die Jahre gekommene Datenverwaltung des Vereins zu modernisieren und eine lebendige, digitale Anlaufstelle für ehemalige Schülerinnen und Schüler zu schaffen. Was zu Beginn als reine schulische Pflichtaufgabe startete, entwickelte sich schnell zu einem Projekt, mit dem wir uns stark identifizierten. Besondere Dynamik erhielt unsere Arbeit durch eine unvorhergesehene Teamverkleinerung im Laufe des Projekts: Aus einer ursprünglich größeren Gruppe wurden schließlich wir drei. Diese Situation zwang uns, weitaus mehr Verantwortung zu übernehmen, unsere Fähigkeiten stark auszubauen und als enges Team zusammenzuwachsen. 
+
+Die Arbeit an *AlumniHub* bot uns dadurch die einmalige Gelegenheit, theoretisches Wissen in einem realen, anspruchsvollen Praxisprojekt anzuwenden. Es war eine herausfordernde, aber äußerst lehrreiche Zeit, auf deren Ergebnis wir sehr stolz zurückblicken.
+
+# Einsatz Künstlicher Intelligenz (KI-Disclaimer)
+
+Die vorliegende Diplomarbeit und die entwickelte Software sind das eigenständige Werk unseres Projektteams. Werkzeuge der Künstlichen Intelligenz wurden lediglich als ergänzendes Hilfsmittel herangezogen. Ihr Einsatz beschränkte sich auf punktuelle Assistenz, wie etwa beim Korrekturlesen, bei Übersetzungen, bei gezielter Recherche sowie als Unterstützung bei der Fehlersuche im Programmiercode. Alle weitreichenden Entscheidungen, die inhaltliche Ausarbeitung sowie der maßgebliche Code stammen exklusiv von uns. Jegliche KI-Vorschläge wurden kritisch hinterfragt, validiert und vollkommen eigenverantwortlich integriert.
+
+
+
 \cleardoublepage
 \pagestyle{empty}
 \pagenumbering{arabic}