New: Pandoc pipeline

.gitea/workflows/create-presentation.yml

@@ -0,0 +1,28 @@
+name: build-debian-package
+on:
+  push:
+    tags:
+      - "doc:*"
+
+jobs:
+  build:
+    name: Build the debian package
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Git clone"
+        run: git clone ${{ gitea.server_url }}/${{ gitea.repository }}.git .
+      - name: "Git checkout"
+        run: git checkout "${{ gitea.sha }}"
+      - name: "Submodules auschecken"
+        run: git submodule update --init
+      
+      - name: "Install dependencies"
+        run: sudo apt-get install pandoc
+
+      - name: "Build .deb"
+        run: cd ./Defensio && ./pandoc.sh
+      - name: "Create release"
+        uses: akkuman/gitea-release-action@v1
+        with:
+          files: |-
+            ./Defensio/defensio.pdf

.gitmodules

@@ -1,6 +1,6 @@
 [submodule "Defensio/libs/awesome-beamer"]
 	path = Defensio/libs/awesome-beamer
-	url = https://codeberg.org/LukasPietzschmann/awesome-beamer
+	url = https://git.kocoder.xyz/kocoded/awesome-beamer
 [submodule "Defensio/libs/smile"]
 	path = Defensio/libs/smile
 	url = https://codeberg.org/LukasPietzschmann/smile

Artikel_Schulhomepage.md

@@ -0,0 +1,34 @@
+# AlumniHub – Die neue digitale Plattform des Absolventenvereins
+
+Im Rahmen ihrer Diplomarbeit an der HTL SZU Ungargasse haben **Konstantin Hintermayer**, **Florian Edlmayer** und **Adam Gaiswinkler** (5BHITN, Schuljahr 2025/26) eine moderne Webanwendung für den Absolventenverein entwickelt: den **AlumniHub**.
+
+## Worum geht es?
+
+Der Absolventenverein der HTL Ungargasse verwaltet rund 300 Alumni – bisher über Excel-Tabellen und abgelaufene Softwarelizenzen. Das Diplomarbeitsteam hat eine zentrale Plattform geschaffen, die Mitgliederverwaltung, Event-Organisation und Kommunikation unter einem Dach vereint.
+
+## Was kann der AlumniHub?
+
+- **Anmeldetool für Treffen** – Veranstaltungen erstellen, Einladungen verschicken und Anmeldungen verwalten
+- **Hall of Fame** – Absolventen können ihre Erfolge präsentieren, inklusive PDF-Export
+- **Schwarzes Brett** – Ein interaktiver Feed für Neuigkeiten, Events und Jobangebote
+- **Premiumbereich** – Exklusive Inhalte für Premiummitglieder mit eigenem Freigabe-Workflow
+- **LinkedIn-Login** – Sichere Anmeldung über OAuth 2.0
+- **DSGVO-konform** – Datenschutz von Anfang an mitgedacht
+
+## Die Technik dahinter
+
+Die Anwendung basiert auf dem Content-Management-System **Oqtane** mit **ASP.NET Core** und **Blazor**. Gehostet wird das Ganze auf einem Linux-Server mit PostgreSQL-Datenbank – betrieben in der Schulinfrastruktur. Gearbeitet wurde agil nach **Scrum** in zweiwöchigen Sprints.
+
+## Das Team
+
+| Name                    | Schwerpunkt                                                        |
+| :---------------------- | :----------------------------------------------------------------- |
+| Konstantin Hintermayer  | Projektleitung, Serverinfrastruktur, Schwarzes Brett, Auswertungen |
+| Florian Edlmayer        | Premiumbereich, LinkedIn-OAuth, Datenschutz (DSGVO)                |
+| Adam Gaiswinkler        | Anmeldetool, Hall of Fame, CMS-Konfiguration, UI/UX-Design        |
+
+**Betreuung:** Ing. Thomas Gürth & Johannes Kreuzer
+
+---
+
+*Das Projektteam bedankt sich bei allen Unterstützern – insbesondere beim Absolventenverein als Auftraggeber und bei der Schule für die Bereitstellung der Infrastruktur.*

Defensio/00_preamble.tex

@@ -2,6 +2,17 @@
 
 \providecommand{\tightlist}{%
   \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+\makeatletter
+\newsavebox\pandoc@box
+\newcommand*\pandocbounded[1]{% scales image to fit the slide if it's too large
+  \sbox\pandoc@box{#1}%
+  \ifdim\wd\pandoc@box>\linewidth
+    \makebox[\linewidth][c]{\resizebox{\linewidth}{!}{\usebox\pandoc@box}}%
+  \else
+    \usebox\pandoc@box
+  \fi
+}
+\makeatother
 
 \usepackage[T1]{fontenc}
 \usepackage[utf8]{inputenc}
@@ -12,7 +23,11 @@
 \newcommand{\imagepath}{Images}
 
 \definecolor{orange}{HTML}{f87a01}
-\usetheme[german, color, coloraccent=orange]{awesome}
+\usetheme[german, color, coloraccent=orange, notoc]{awesome}
+\makeatletter
+\newcommand{\nonumberson}{\awesome@nonumbersinframetitletrue}
+\newcommand{\nonumbersoff}{\awesome@nonumbersinframetitlefalse}
+\makeatother
 
 % \usepackage{firamath-otf}
 \usepackage{pgfplots}
@@ -57,21 +72,32 @@
 \institute{Schulzentrum HTL HAK Ungargasse}
 \uni{Schulzentrum HTL HAK Ungargasse}
 \location{Wien}
-\background{background.png}
+\background{./Images/images/background/title-slide/background.png}
 \logo{\includegraphics[width=3cm]{\imagepath/images/logos/logo.png}}
-\date\today
+\date{22. April 2026}
+
 
 \AtBeginSection[]
 {
+  \begingroup
+  \nonumberson
   \begin{frame}[noframenumbering,plain]{Agenda}
-  \tableofcontents[currentsection, hideothersubsections]
+    \tableofcontents[currentsection]
   \end{frame}
+  \endgroup
   }
   
   \begin{document}
   
   \maketitle
   
+  \begingroup
+  \nonumberson
+  \begin{frame}[noframenumbering,plain]{Agenda}
+    \tableofcontents
+  \end{frame}
+  \endgroup
+  
   $body$
   
   \end{document}

Defensio/02_Praesentation_Konstantin_Hintermayer.md

@@ -2,7 +2,37 @@
 
 ## Rolle im Projekt
 
-## Infrastruktur & CI/CD
+::: columns
+
+:::: column
+Aufgabenbereiche:
+
+- Infrastruktur & CI/CD
+- Product Owner
+- Kundenschnittstelle
+- Softwareentwicklung:
+  - Event Registration
+  - Black Board
+  - Report System
+  - Mass Mailer
+::::
+
+:::: column
+
+\begin{tikzpicture}
+    \clip (0,0) circle (3em);
+    \node at (0,0) {\includegraphics[width=6em]{./Images/images/konstantin/profile.jpg}};
+    \draw[accent, line width=3pt] (0,0) circle (3em);
+\end{tikzpicture}
+
+::::
+
+:::
+
+## Infrastruktur 
+
+::: columns
+:::: column
 
 Systemaufbau: 
 
@@ -11,18 +41,47 @@ Systemaufbau:
 - NginX
 - Asp.Net Core
 
+::::
+:::: column
+
+Entwicklungsumgebung:
+
+- Gitea Server
+- Wireguard
+- Docker
+- Transfer: GitHub
+- Gitea Actions 
+  
+::::
+:::
+
+
+## CI/CD
+
 CI: 
 
 - Gitea Actions
 - Debian Packages (.deb)
+- Code-Reviewing:
+  - KI
+  - Git-Flow
 
 ## Softwarearchitektur
 
 - Open-Closed Principle
+- Strategy Pattern
 - Dependency Injection
   
 ## Technischer Vergleich
 
+Bisherige Erfahrungen:
+
+- Go
+- Typescript
+- GRPC (interprozess Kommunikation)
+
+Untersuchungsgebiete:
+
 - Typisierung
 - Konsistenz
 
@@ -39,3 +98,5 @@ right
 ::::
 
 :::
+
+## Fazit

Defensio/03_Praesentation_Adam_Gaiswinkler.md

@@ -18,12 +18,10 @@
 ---
 
 ## Eingesetzte Technologien
-- **Backend & Core**: C#, ASP.NET Core
+
-- **Frontend**: Blazor (für interaktive Weboberflächen direkt in C#)
-- **CMS**: Oqtane Framework
 - **Styling**: Bootstrap & Custom CSS
 - **Spezielle Tools**: QuestPDF (PDF-Generierung), Gitea (Versionskontrolle)
-- **Entwicklungsumgebung**: Visual Studio 2022 & JetBrains Rider (macOS)
+- **Entwicklungsumgebung**: Visual Studio 2022 & Visual Studio Code (macOS)
 
 ---
 
@@ -31,7 +29,7 @@
 - **Ziel**: Modernes, schlichtes Design im Stil der HTL Ungargasse (szu.at).
 - **Technische Highlights**:
   - Vollständige Eigenentwicklung der Navigationslogik (über `PageState.Pages`).
-  - Dynamisches Ausblenden von Systemseiten via LINQ.
+  - **Dynamisches Ausblenden von Systemseiten via LINQ**.
   - **Responsive Design**: Einsatz von CSS Media Queries und einer komplett CSS-basierten Burger-Menü-Lösung.
   - Integration eines `ControlPanels` und Cookie-Consent.
 
@@ -53,8 +51,7 @@
 - **PDF-Export**: Dynamische Generierung eines ansprechenden Profil-PDFs mittels *QuestPDF*.
 - **Moderation**:
   - Integriertes Meldesystem (Reporting) direkt über ein separates Interfaces-Paket angesteuert.
-- **Datenbank & Persistenz**: 
+
-  - Entity Framework Core inkl. Migrationen (`HallOfFame` und `HallOfFameReport` Tabellen).
 
 ---
 
@@ -74,7 +71,7 @@
 - **Zeitdruck & Infrastruktur-Ausfälle**: 
   - Probleme mit Hosting (Hetzner).
   - **Lösung**: Entwicklung einer schlanken "Übergangslösung" (Node.js/HTML) im Sommer 2025 zur zeitgerechten Event-Abwicklung.
-- **Entity Framework Concurrency Issues**: Gelöst durch Transaktions-Gliederung bei Löschvorgängen (Reports vs. Main Entity).
+
 
 ---
 
@@ -85,11 +82,11 @@
 
 ---
 
-## Fazit & Ausblick
+## Fazit & Mögliche Erweiterungen
 - **Erreichtes**:
   - Theme ist final in Oqtane integriert und mobil optimiert.
   - Hall of Fame und Anmeldetool sind voll funktionstüchtig.
-- **Ausblick**: 
+- **Mögliche Erweiterungen**: 
   - Integration einer umfassenden Teilnehmerlisten-Auswertung (Datenbank).
   - Limit-Funktion für maximale Anmeldungen bei Veranstaltungen.
   - Automatische E-Mail-Erinnerungen für Events.

Defensio/04_Praesentation_Florian_Edlmayer.md

@@ -6,13 +6,14 @@
 ---
 
 ## Ausgangslage & Zielsetzung
-- **Ausgangssituation**: Fehlen einer sicheren, datenschutzkonformen digitalen Vernetzung der Absolventen der HTL Ungargasse.
+- **Ausgangssituation**: 
+  - Keine digitale, sichere Absolventen-Vernetzung.
 - **Mein Beitrag**:
-  - DSGVO-konforme Datenschutzimplementierung.
+  - Datenschutz (DSGVO).
-  - Robuste, automatisierte Backups & Restore-Systeme.
+  - Automatisierte Backups & Restore.
-  - Externes Login mittels LinkedIn (OAuth 2.0).
+  - LinkedIn-Login (OAuth 2.0).
-  - Konzeption und Entwicklung des Premium-Bereichs.
+  - Premium-Bereich.
-- **Nutzen**: Rechtskonformer Betrieb, hohe Ausfallsicherheit, einfache Nutzung, Förderung des Engagements.
+- **Nutzen**: Rechtssicherheit, Ausfallsicherheit, hohes Engagement.
 
 ---
 
@@ -25,71 +26,105 @@
 ---
 
 ## DSGVO & Datenschutz
-- **Notwendigkeit**: Einhaltung gesetzlicher Rahmenbedingungen (DSGVO, DSG).
+- **Rechtliche Basis**: Einhaltung von DSGVO & DSG.
 - **Umsetzung**:
-  - Erstellung und Einbindung einer rechtskonformen Datenschutzerklärung.
+  - **Datenschutzerklärung**: Rechtskonform integriert.
-  - **Datenminimierung**: Es werden nur absolut notwendige Daten für den Vereinszweck erhoben.
+  - **Datenminimierung**: Nur zwingend benötigte Daten.
-  - **Vertraulichkeit**: TLS/HTTPS-Verschlüsselung, lokales Hosting der Daten in Österreich (LiveDesign).
+  - **Vertraulichkeit**: TLS/HTTPS & lokales Austria-Hosting.
-  - Sicherstellung aller Betroffenenrechte (Auskunft, Löschung).
+  - **Betroffenenrechte**: Auskunft & Löschung garantiert.
 
 ---
 
 ## Backup- & Restore-Systeme (1)
-- **Problem**: Schutz der Daten vor Hardwareausfällen, Softwarefehlern oder Cyberangriffen.
+- **Problem**: Datenverlust (Hardware, Software, Cyberangriffe).
-- **Lösung: Vollautomatisiertes Backup-Skript**
+- **Lösung**: Vollautomatisiertes Backup-Skript.
-  - **Cronjob** führt Skript nachtschlafend (`02:30 Uhr`) aus.
+
-  - Sichert die `PostgreSQL`-Datenbank im Custom-Format (`pg_dump -Fc`).
+```mermaid
-  - Komprimiert den gesamten App-Dateibaum mittels `tar -cvpzf`.
+graph LR
-  - Alle Backups erhalten UTC-Zeitstempel für ordentliche Strukturierung.
+    Start((Start: Cronjob 02:30)) --> Init[Initialisierung]
+    Init --> Vars[Konfiguration laden]
+
+    subgraph Sicherungsphase
+        Dir[Erstelle Backup-Ordner] --> DB[Datenbank-Backup]
+        DB --> Files[Dateisystem sichern]
+    end
+
+    Files --> Check{Fehler?}
+    Check -- Ja --> Mail[Log Error & Abbruch]
+    Check -- Nein --> Rotate[Lade Backups-Liste]
+
+    subgraph Speicherverwaltung
+        Rotate --> Count{Anzahl > 30?}
+        Count -- Ja --> Delete[Älteste löschen]
+        Count -- Nein --> Finish[Abschluss]
+        Delete --> Finish
+    end
+
+    Finish --> Ende((Ende))
+```
 
 ---
 
 ## Backup- & Restore-Systeme (2)
-- **Retention Management**:
+- **Speichermanagement (Retention)**:
-  - Automatische Bereinigung alter Backups (Rotation). Nur die neuesten 30 Backups (`RETAIN=30`) bleiben vorhanden, um Speicherplatz zu sparen.
+  - Automatische Backup-Rotation. 
+  - Limit: Letzte 30 Tage (Speicherplatz-Optimierung).
 - **Restore-Skript**:
   - Kontrollierter Wiederherstellungsprozess.
-  - Integrierte Sicherheitsabfrage (`ja/nein`) vor dem Überschreiben.
+  - Sicherheitsabfrage vor Überschreiben.
-  - Umbenennen bestehender Ordner als "Rückversicherung".
+  - Backup als "Rückversicherung" vor Import.
-  - Neuanlage der Datenbank (`dropdb` / `createdb`) & Einspielen via `pg_restore`.
+  - DB-Neuanlage & automatischer Import.
 
 ---
 
 ## Authentifizierung mit LinkedIn (OAuth 2.0)
-- **Ziel**: Reduzierung von Registrierungshürden und Steigerung der Plattformsicherheit (keine Passwörter im eigenen System speichern).
+- **Ziel**: 
-- **Ablauf**:
+  - Abbau von Registrierungshürden. 
-  - Nutzer klickt auf "Via LinkedIn Anmelden".
+  - Keine sensiblen Passwörter im eigenen System.
-  - Weiterleitung an LinkedIn -> Freigabe durch den Nutzer.
+
-  - Oqtane External Login fängt Authorization Code ab, tauscht diesen gegen ein Access Token.
+![Ablauf der OAuth-Authentifizierung](Images/oauth-flow-new.png)
-  - Automatisches Mapping auf lokales Benutzerkonto mithilfe der definierten *Claims* (Name, System-ID).
 
 ---
 
 ## Der Premium-Bereich (1)
-- **Zweck**: Anreiz für aktives Engagement im Absolventenverein.
+**Zweck**: Motivation für aktives Mitglieder-Engagement.
-- **Ingenieur-Antrags-Workflow**:
+
-  - Nutzer können *Ingenieur-Anträge* (PDF) via Oqtane FileManager hochladen (`Entity: EngineerApplication`).
+![](../Diplomarbeitsbuch/images/04-Florian/ingenieur-antrag-status.png){width=20em}
-  - Nach Prüfung und Freigabe durch Admins (`Approved`) wird automatisch für 12 Monate der Premium-Status vergeben (`UserPremium`).
+
-- **Bibliothek**:
+![](../Diplomarbeitsbuch/images/04-Florian/ingenieur-antraege-liste.png){width=20em}
-  - Premium-Mitglieder können eine Übersicht aller genehmigten Vorzeige-Anträge einsehen.
 
 ---
 
 ## Der Premium-Bereich (2)
-- **Mitgliedersuche & Kontakt**:
+**Architektur des Premium-Bereich-Moduls:**
-  - Gezielte, datensparsame Suchfunktion nach anderen Absolventen.
+```mermaid
-  - Die Suche filtert sensible Daten serverseitig heraus, bevor es zum Client geschickt wird.
+graph LR
-  - **Kontakt-Mechanismus**: In-App Nachrichtensystem *ohne* Preisgabe der persönlichen E-Mail-Adresse. Oqtane übernimmt als Broker die Zustellung.
+    subgraph Client [WebAssembly]
-- **Architektur**:
+        UI[Benutzeroberfläche] --> SvcC[Service Client]
-  - Umsetzung über EF Core (Tabellen: `UserPremium`, `EngineerApplication`, `PremiumEvent` wg. Audit-Trails).
+    end
-  - Rollenbasierte Zugriffskontrollen tief in der Service-Schicht (`IsAuthorized`).
+
+    subgraph Server [ASP.NET Core]
+        SvcC --> Ctrl[API Controller]
+        Ctrl --> SvcS[Service Schicht]
+    end
+
+    subgraph Data [Datenbank]
+        SvcS --> EF[EF Core]
+        EF --> DB[(PostgreSQL)]
+    end
+```
+
+**Datensparsame Mitgliedersuche & Kontaktfunktion:**
+![Mitgliedersuche und Kontaktfunktion für Premium-Mitglieder](../Diplomarbeitsbuch/images/04-Florian/premium-mitglieder-suche.png)
 
 ---
 
 ## Fazit & Ausblick
 - **Erreichtes**:
-  - Sensible Mitglieder-Daten sind DSGVO-konform geschützt.
+  - DSGVO-konformer Datenschutz.
-  - Die Betriebssicherheit wird durch fehlerresistente Bash-Backups bewahrt.
+  - Hohe Ausfallsicherheit (automatisierte Bash-Backups).
-  - Der nahtlose Login mit LinkedIn reduziert Barrieren stark.
+  - Barrierefreier Zugang (LinkedIn-Login).
-  - Der Premium-Bereich samt Ingenieur-Anträgen stiftet echten Mehrwert für die Alumni-Community.
+  - Echter Mehrwert durch Premium-Funktionen.
-- **Ausblick**: Evaluierung weiterführender OAuth-Anbieter sowie Ausbau der Premium-Pfeiler zur Steigerung der Mitglieds-Dauerhaftigkeit.
+- **Ausblick**: 
+  - Weitere OAuth-Anbieter (z.B. Google, Microsoft).
+  - Ausbau zukünftiger Premium-Features.

Video_Text_Skript.md

@@ -0,0 +1,22 @@
+# Video Text Skript
+
+Anfang: Willkommen zu unserem Video über den AlumniHub. Wir sind Konstantin Hintermayer, Florian Edlmayer und Adam Gaiswinkler und wir haben im Rahmen unserer Diplomarbeit an der HTL SZU Ungargasse eine moderne Webanwendung für den Absolventenverein entwickelt.
+Zu beginn unseres Projekts sind wir auf viele Probleme gestoßen. Im Sommer beschäftigten wir uns mit einer Übergangslösung um das kommende Treffen der Absolventen im Jahr 2025 zu ermöglichen. Ein weiteres Problem war unser Team Downsizing von 6 auf 3 Mitglieder. Dadurch mussten wir unsere ursprünglichen Pläne stark überdenken und uns auf das Wesentliche konzentrieren.
+Außerdem sind wir immer wieder auf Probleme mit unserer Serverinfrastruktur gestoßen.
+
+Ein zentraler Teil unserer Arbeit ist die kontinuierliche Integration unserer Software. Wir haben uns für Git als Versionsverwaltungssystem entschieden und hosten eine Gitea Instanz. Bei veröffentlichen eines tags wird automatisch ein neues Debian Paket gebaut und in unsererem Debian Package Registry bereitgestellt.Durch diese automatisierung ist die veröffentlichung von neuen Softwareversionen stark vereinfacht worden.
+
+Das Hauptziel des Projektes war es eine moderne Webanwendung für den Absolvenntenverein zu kreieren. Die es ermöglicht einfach Events und treffen zu organisieren mithilfe unseres EventRegistration Moduls. Weiter Funktionen sind die Hall of Fame, wo Absolventen ihre Erfolge präsentieren können, das Schwarze Brett für Neuigkeiten und Jobangebote und der Premiumbereich für exklusive Inhalte. Diese sind im Laufe der Entwicklung hinzugekommen.
+
+Nun wollen wir Ihnen unsere Webanwendung genauer vorstellen.
+
+EventRegistration Modul:
+
+
+Hall of Fame Modul:
+
+
+Schwarzes Brett Modul:
+
+
+Premiumbereich Modul: