Compare commits

...

14 Commits

Author SHA1 Message Date
f6718139cc Align texts at the top of a page 2026-04-19 20:17:26 +02:00
b944048df3 neuste version meiner präsi 2026-04-19 18:52:22 +02:00
7eb4e0761e Video Skript angepasst 2026-04-19 14:04:57 +02:00
1bfd8b3a96 Merge branch 'main' of https://git.kocoder.xyz/Diplomarbeit-Absolventenverein/pm 2026-04-18 19:24:07 +02:00
020707c380 Neue Version 2026-04-18 19:23:49 +02:00
e623ca9340 Fix: Theme Linking?
Some checks failed
build-debian-package / Convert to PDF (push) Failing after 15s
2026-04-18 16:12:07 +02:00
76e0d6b65f Use the correct path
Some checks failed
build-debian-package / Convert to PDF (push) Failing after 15s
2026-04-18 16:10:18 +02:00
b408cb0d0f Fix: mermaid diagrams
Some checks failed
build-debian-package / Convert to PDF (push) Failing after 12s
2026-04-18 16:07:01 +02:00
23fe2c0863 Update: Submodule
Some checks failed
build-debian-package / Convert to PDF (push) Failing after 36s
2026-04-18 15:24:58 +02:00
dd8eb9d269 Rename and use newer pandoc container
Some checks failed
build-debian-package / Convert to PDF (push) Failing after 29s
2026-04-18 15:20:02 +02:00
c8f95f5169 Update .gitea/workflows/create-presentation.yml
Some checks failed
build-debian-package / Build the debian package (push) Failing after 11s
2026-04-18 13:13:02 +00:00
450509008d Update .gitea/workflows/create-presentation.yml
Some checks failed
build-debian-package / Build the debian package (push) Failing after 10s
2026-04-18 13:10:42 +00:00
c780145790 Update .gitea/workflows/create-presentation.yml
Some checks failed
build-debian-package / Build the debian package (push) Failing after 9s
2026-04-18 13:08:35 +00:00
9d96f7eafc Update .gitea/workflows/create-presentation.yml
Some checks failed
build-debian-package / Build the debian package (push) Failing after 9s
2026-04-18 12:57:52 +00:00
13 changed files with 180 additions and 104 deletions

View File

@@ -6,7 +6,7 @@ on:
jobs: jobs:
build: build:
name: Build the debian package name: Convert to PDF
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
@@ -16,24 +16,26 @@ jobs:
run: git checkout "${{ gitea.sha }}" run: git checkout "${{ gitea.sha }}"
- name: "Submodules auschecken" - name: "Submodules auschecken"
run: git submodule update --init run: git submodule update --init
- uses: docker://git.kocoder.xyz/docker/ga-pandoc:c6eaa45b623c284e80f37434872621defc00f864 - name: "Debug"
run: ls -la ./Defensio
- uses: docker://git.kocoder.xyz/docker/ga-pandoc:d2995fb914e313703da2c7754763e7fa01dae88f
name: Pandoc name: Pandoc
with: with:
env: TEXINPUTS=.:./libs/awesome-beamer/:./libs/smile/ env: TEXINPUTS=./Defensio:./Defensio/libs/awesome-beamer/:./Defensio/libs/smile/
command: pandoc command: pandoc
args: >- args: >-
./Defensio/01_Praesentation_Allgemein.md \ /workspace/Diplomarbeit-Absolventenverein/pm/Defensio/01_Praesentation_Allgemein.md
./Defensio/02_Praesentation_Konstantin_Hintermayer.md \ /workspace/Diplomarbeit-Absolventenverein/pm/Defensio/02_Praesentation_Konstantin_Hintermayer.md
./Defensio/03_Praesentation_Florian_Edlmayer.md \ /workspace/Diplomarbeit-Absolventenverein/pm/Defensio/03_Praesentation_Florian_Edlmayer.md
./Defensio/04_Praesentation_Adam_Gaiswinkler.md \ /workspace/Diplomarbeit-Absolventenverein/pm/Defensio/04_Praesentation_Adam_Gaiswinkler.md
-t beamer \ -t beamer
--template ./Defensio/00_preamble.tex \ --template /workspace/Diplomarbeit-Absolventenverein/pm/Defensio/00_preamble.tex
--pdf-engine=pdflatex \ --pdf-engine=pdflatex
--slide-level=2 \ --slide-level=2
--number-sections \ --number-sections
--lua-filter ./_extensions/diagram/diagram.lua \ --lua-filter /workspace/Diplomarbeit-Absolventenverein/pm/_extensions/diagram/diagram.lua
--syntax-definition ./_extensions/razor/razor.xml \ --syntax-definition /workspace/Diplomarbeit-Absolventenverein/pm/_extensions/razor/razor.xml
--syntax-definition ./_extensions/nginx/nginx.xml \ --syntax-definition /workspace/Diplomarbeit-Absolventenverein/pm/_extensions/nginx/nginx.xml
-o defensio.pdf -o defensio.pdf
- name: "Create release" - name: "Create release"
uses: akkuman/gitea-release-action@v1 uses: akkuman/gitea-release-action@v1

1
.gitignore vendored
View File

@@ -1 +1,2 @@
diplomarbeitsbuch.pdf diplomarbeitsbuch.pdf
defensio.pdf

View File

@@ -1,4 +1,4 @@
\documentclass[aspectratio=169]{beamer} \documentclass[aspectratio=169,t]{beamer}
\providecommand{\tightlist}{% \providecommand{\tightlist}{%
\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}} \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
@@ -81,7 +81,7 @@
{ {
\begingroup \begingroup
\nonumberson \nonumberson
\begin{frame}[noframenumbering,plain]{Agenda} \begin{frame}[c,noframenumbering,plain]{Agenda}
\tableofcontents[currentsection] \tableofcontents[currentsection]
\end{frame} \end{frame}
\endgroup \endgroup
@@ -93,7 +93,7 @@
\begingroup \begingroup
\nonumberson \nonumberson
\begin{frame}[noframenumbering,plain]{Agenda} \begin{frame}[c,noframenumbering,plain]{Agenda}
\tableofcontents \tableofcontents
\end{frame} \end{frame}
\endgroup \endgroup

View File

@@ -39,29 +39,12 @@
- **Problem**: Datenverlust (Hardware, Software, Cyberangriffe). - **Problem**: Datenverlust (Hardware, Software, Cyberangriffe).
- **Lösung**: Vollautomatisiertes Backup-Skript. - **Lösung**: Vollautomatisiertes Backup-Skript.
```mermaid **Automatischer Ablauf (täglich 02:30 Uhr):**
graph LR 1. Cronjob startet → Konfiguration wird geladen
Start((Start: Cronjob 02:30)) --> Init[Initialisierung] 2. Datenbank-Backup wird erstellt
Init --> Vars[Konfiguration laden] 3. Restliches Dateisystem wird komprimiert
4. Fehlerüberprüfung → bei Fehler: Log-Eintrag & Abbruch
subgraph Sicherungsphase 5. Rotation: Nur die letzten 30 Backups bleiben erhalten, ältere werden automatisch gelöscht
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))
```
--- ---
@@ -97,22 +80,10 @@ graph LR
## Der Premium-Bereich (2) ## Der Premium-Bereich (2)
**Architektur des Premium-Bereich-Moduls:** **Architektur des Premium-Bereich-Moduls:**
```mermaid **Technische Architektur:**
graph LR - **Frontend**: Blazor WebAssembly (Oqtane) → ruft API auf
subgraph Client [WebAssembly] - **Backend**: ASP.NET Core Controller → Service-Schicht mit Rechteverwaltung
UI[Benutzeroberfläche] --> SvcC[Service Client] - **Datenbank**: EF Core → PostgreSQL mit Audit-Trail (jede Premium-Vergabe nachvollziehbar)
end
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:** **Datensparsame Mitgliedersuche & Kontaktfunktion:**
![Mitgliedersuche und Kontaktfunktion für Premium-Mitglieder](../Diplomarbeitsbuch/images/04-Florian/premium-mitglieder-suche.png) ![Mitgliedersuche und Kontaktfunktion für Premium-Mitglieder](../Diplomarbeitsbuch/images/04-Florian/premium-mitglieder-suche.png)

View File

@@ -3,17 +3,18 @@
## Individueller Teil: Adam Gaiswinkler ## Individueller Teil: Adam Gaiswinkler
**Entwicklung von CMSModulen & Frontend-Design** **Entwicklung von CMSModulen & Frontend-Design**
- Schwerpunkt: Oqtane-Theme, Hall-of-Fame-Modul & Anmeldetool - **Schwerpunkt**:
- Ziel: Moderne, responsive Website für den HTL-Absolventenverein - Oqtane-Theme
- Hall-of-Fame-Modul
<!-- BILD: Logo HTL Ungargasse + Vereinslogo nebeneinander --> - Anmeldetool
- **Ziel**: Moderne, responsive Website für den HTL-Absolventenverein
--- ---
## Ausgangslage & Motivation ## Ausgangslage & Motivation
- **Ausgangssituation**: Moderne FrontendPlattform für den Absolventenverein (responsive, neue Features). - **Ausgangssituation**: Moderne FrontendPlattform für den Absolventenverein (responsive, neue Features).
- **Persönliche Motivation**: - **Persönliche Motivation**:
- TeamVerkleinerung (6 → 3) → mehr Verantwortung. - TeamVerkleinerung (63) → mehr Verantwortung.
- Projektidentifikation & PraxisBlazor/ASP.NET. - Projektidentifikation & PraxisBlazor/ASP.NET.
- **Ziele**: - **Ziele**:
- OqtaneModule (Anmeldetool, HallofFame). - OqtaneModule (Anmeldetool, HallofFame).
@@ -22,67 +23,138 @@
--- ---
## Eingesetzte Technologien ## Eingesetzte Technologien
- **TechStack**: Bootstrap+CustomCSS, QuestPDF, Gitea, VS2022wechsel zu VSCode (macOS).
<!-- BILD: Logos der verwendeten Tools (Bootstrap, QuestPDF, Gitea, VS Code) nebeneinander --> ::: columns
:::: column
- **TechStack**:
- Bootstrap
- CustomCSS
- QuestPDF
- Gitea
- Visual Studio 2022 → Visual Studio Code (macOS).
::::
:::: column
\begin{tikzpicture}
\node[inner sep=0pt, rounded corners=5pt, clip] {\includegraphics[width=0.8\columnwidth]{Images/Technologien.png}};
\end{tikzpicture}
::::
:::
--- ---
## Umsetzung: Oqtane Theme ## Oqtane Theme
::: columns
:::: column
- EigenNavigation (bootstrap Komponenten haben nicht gepasst ). - EigenNavigation (bootstrap Komponenten haben nicht gepasst ).
- Systemseiten per LINQ ausblenden. - Systemseiten per LINQ ausblenden.
- Responsive CSSMediaQueries + reines CSSBurgerMenu. - Responsive CSSMediaQueries + reines CSSBurgerMenu.
- ControlPanel & CookieConsent. - CookieConsent (erforderlich für dsgvo konformität und gesamtheit der website ).
![Theme Burger Ansicht](Images/ThemeBurgerMenu.png) ::::
<!-- BILD: Screenshot der Website-Navigation auf Desktop (volle Menüleiste) -->
<!-- BILD: Screenshot des Burger-Menüs auf Mobile (aufgeklappt) --> :::: column
\begin{tikzpicture}
\node[inner sep=0pt, rounded corners=5pt, clip] {\includegraphics[width=0.55\columnwidth]{Images/BurgerMenuLiveDesign.png}};
\end{tikzpicture}
::::
:::
--- ---
## Umsetzung: Hall of Fame ## Hall of Fame
::: columns
:::: column
- **KartenGrid**: Responsive Übersicht, LiveSuche & Sortierung **in Echtzeit kein Seitenreload** (Blazor). - **KartenGrid**: Responsive Übersicht, LiveSuche & Sortierung **in Echtzeit kein Seitenreload** (Blazor).
- **DetailSeite**: GlasmorphismusDesign (halbtransparente Karten mit Blur-Effekt). - **DetailSeite**: GlasmorphismusDesign (halbtransparente Karten mit Blur-Effekt).
- **Workflow**: RichTextEditor, BildUpload mit **Live-Vorschau** (max5MB), Status (Entwurf/Veröffentlicht) inkl. EigentümerCheck. ::::
- **PDFExport**: Professionelle Profil-PDFs server-seitig mit QuestPDF.
- **Moderation**: Meldesystem über separates InterfacesPaket → saubere Logik-Trennung. :::: column
![Screenshot eines generierten PDFs](Images/HallOfFameBeispiel.png) \begin{tikzpicture}
![Screenshot HallOfFame](Images/HallOfFame.png) \node[inner sep=0pt, rounded corners=5pt, clip] {\includegraphics[width=0.55\columnwidth]{Images/HallOfFameBeispiel.png}};
<!-- BILD: Screenshot des Karten-Grids mit mehreren Alumni-Einträgen --> \end{tikzpicture}
<!-- BILD: Screenshot der Detailseite (Glasmorphismus-Design) --> ::::
<!-- BILD: Screenshot eines generierten PDFs -->
:::
--- ---
## Umsetzung: Anmeldetool ## Hall of Fame Workflow & Export
- Klar getrennte Ja/NeinButtons (grün/rot).
- **LiveFeedback via Blazor**: Statusänderungen sofort sichtbar andere Teilnehmer sehen Updates direkt.
- Mobile-optimiert: kein Overlay-Clipping, sauberes Touch-Handling.
- Saubere Trennung: UI-Komponente & Backend-API getrennt.
<!-- BILD: Screenshot Anmeldetool mit gruenem Ja- und rotem Nein-Button --> ::: columns
<!-- BILD: Screenshot auf Mobile (Overlay-Ansicht) -->
:::: column
- **Workflow**: RichTextEditor, BildUpload mit **Live-Vorschau** (max 5 MB), Status (Entwurf/Veröffentlicht) inkl. EigentümerCheck.
- **PDFExport**: Professionelle Profil-PDFs server-seitig mit QuestPDF.
- **Moderation**: Meldesystem über separates InterfacesPaket → saubere Logik-Trennung.
::::
:::: column
\begin{tikzpicture}[
node distance=12mm,
every node/.style={font=\small},
state/.style={rectangle, rounded corners=3pt, draw=accent, fill=accent!10, minimum width=2.4cm, minimum height=8mm, align=center, font=\small\bfseries},
arr/.style={->,>=stealth,thick,accent}
]
\node[coordinate] (start) {};
\node[state, right=10mm of start] (draft) {Entwurf};
\node[state, below=18mm of draft] (pub) {Veröffentlicht};
\draw[arr] (start) -- node[above] {\scriptsize Erstellen} (draft);
\draw[arr] (draft) to[out=135, in=45, looseness=4] node[above] {\scriptsize Speichern} (draft);
\draw[arr, bend left=25] (draft) to node[right] {\scriptsize Veröffentlichen} (pub);
\draw[arr, bend left=25] (pub) to node[left] {\scriptsize Zurückziehen} (draft);
\end{tikzpicture}
::::
:::
---
## Anmeldetool
- **UI**: Ja/NeinButtons (grün/rot)
- **LiveFeedback**: Sofortige Statusänderung via Blazor
- **Mobile**: Sauberes Touch-Handling
- **Architektur**: UI & Backend-API getrennt
--- ---
## Herausforderungen & Lösungen ## Herausforderungen & Lösungen
- **Plattformwechsel** Windows → macOS: Oqtane stark an Windows gebunden → **Visual Studio Code** als plattformübergreifende Lösung. - **Plattformwechsel** Windows → macOS
- **Hosting-Ausfall** (Hetzner, Sommer 2025): kurz vor einem Event → schnelle **Node.js/HTML-Übergangslösung** sicherte Event-Anmeldung. - Oqtane stark an Windows gebunden
-**Visual Studio Code** als plattformübergreifende Lösung
<!-- BILD: Screenshot von Visual Studio Code auf macOS --> - **Keine funktionsfähige Website** (Sommer 2025)
- Kurz vor einem Event, kein funktionierendes CMS
- → Schnelle **Node.js/HTML-Übergangslösung** sicherte Event-Anmeldung
--- ---
## Learnings ## Learnings
- **Technisch**: Git, CSSFlexbox, Blazor.
- **Methodisch**: Aufgabenverteilung, regelmäßige Meetings. \vspace{1cm}
- **Persönlich**: Eigeninitiative & Verantwortung. \begin{tikzpicture}[remember picture, overlay]
\node at (current page.center) {
\renewcommand{\arraystretch}{1.5}
\begin{tabular}{c c c}
\textbf{Technisch} & \textbf{Methodisch} & \textbf{Persönlich} \\
\hline
Git & Aufgabenverteilung & Eigeninitiative \\
CSS-Flexbox & Regelmäßige Meetings & Verantwortung \\
Blazor & & \\
\end{tabular}
};
\end{tikzpicture}
--- ---
## Fazit & Ausblick ## Fazit & Ausblick
- Theme final, mobil, Hall of Fame & Anmeldetool funktionsfähig. - **Ergebnis**:
- **Erweiterungen**: TeilnehmerAuswertung, AnmeldeLimit, automatische EMailErinnerungen. - Theme final & mobil-optimiert
- Hall of Fame funktionsfähig
<!-- BILD: Gesamtansicht der fertigen Website (Desktop) als Abschluss-Screenshot --> - Anmeldetool einsatzbereit

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

View File

@@ -0,0 +1,3 @@
{
"args": ["--no-sandbox"]
}

View File

@@ -1,11 +1,9 @@
# Video Text Skript # 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. Anfang: Vernetzung, die wirklich funktioniert willkommen beim AlumniHub. Wir haben im Rahmen unserer Diplomarbeit an unserer HTL 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. 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. 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. 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. Nun wollen wir Ihnen unsere Webanwendung genauer vorstellen.
@@ -20,3 +18,6 @@ Schwarzes Brett Modul:
Premiumbereich Modul: Premiumbereich Modul:
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.

View File

@@ -151,6 +151,11 @@ local mermaid = {
compile = function (self, code) compile = function (self, code)
local mime_type = self.mime_type or 'image/svg+xml' local mime_type = self.mime_type or 'image/svg+xml'
local file_extension = extension_for_mimetype[mime_type] local file_extension = extension_for_mimetype[mime_type]
-- Resolve puppeteer config path
local puppeteer_config = pandoc.path.join({pandoc.system.get_working_directory(), 'puppeteer-config.json'})
return with_temporary_directory("diagram", function (tmpdir) return with_temporary_directory("diagram", function (tmpdir)
return with_working_directory(tmpdir, function () return with_working_directory(tmpdir, function ()
local infile = 'diagram.mmd' local infile = 'diagram.mmd'
@@ -158,7 +163,7 @@ local mermaid = {
write_file(infile, code) write_file(infile, code)
pipe( pipe(
self.execpath or 'mmdc', self.execpath or 'mmdc',
{"--pdfFit", "--iconPacksNamesAndUrls", "mdi#https://unpkg.com/@iconify-json/mdi@1.2.3/icons.json", "--input", infile, "--output", outfile}, {"--pdfFit", "--iconPacksNamesAndUrls", "mdi#https://unpkg.com/@iconify-json/mdi@1.2.3/icons.json", "-p", puppeteer_config, "--input", infile, "--output", outfile},
'' ''
) )
return read_file(outfile), mime_type return read_file(outfile), mime_type
@@ -167,6 +172,24 @@ local mermaid = {
end, end,
} }
-- Source - https://stackoverflow.com/a/27028488
-- Posted by hookenz, modified by community. See post 'Timeline' for change history
-- Retrieved 2026-04-18, License - CC BY-SA 4.0
function dump(o)
if type(o) == 'table' then
local s = '{ '
for k,v in pairs(o) do
if type(k) ~= 'number' then k = '"'..k..'"' end
s = s .. '['..k..'] = ' .. dump(v) .. ','
end
return s .. '} '
else
return tostring(o)
end
end
--- TikZ --- TikZ
-- --

3
puppeteer-config.json Normal file
View File

@@ -0,0 +1,3 @@
{
"args": ["--no-sandbox"]
}