Einleitung: Individueller Teil: Konstantin Hintermayer #64

Merged
Kocoder merged 2 commits from Einleitung-individueller-Teil-Konstantin-Hintermayer into main 2026-03-05 12:41:47 +00:00
Owner
No description provided.
Kocoder added 1 commit 2026-03-04 10:36:03 +00:00
Einleitung: Individueller Teil: Konstantin Hintermayer
All checks were successful
Gemini Writing Review / gemini-review (pull_request) Successful in 1m22s
Word Count / count-words (pull_request) Successful in 32s
c51a6f09b4
gitea-actionsbot requested changes 2026-03-04 10:39:13 +00:00
gitea-actionsbot left a comment

🤖 Gemini Writing Review

I've found some areas for improvement in the documentation. Please see the inline comments below.

### 🤖 Gemini Writing Review I've found some areas for improvement in the documentation. Please see the inline comments below.
@@ -6,0 +17,4 @@
### Motivation
Lernen von ASP.NET und der Entwicklung mit Blazor und Oqtane. Für Webentwicklung habe ich privat Interesse.

Stilistische Verbesserung: Der Satz wirkt etwas abgehackt.

Ich habe ein privates Interesse an der Webentwicklung.
Stilistische Verbesserung: Der Satz wirkt etwas abgehackt. ```suggestion Ich habe ein privates Interesse an der Webentwicklung. ```
Kocoder marked this conversation as resolved
@@ -6,0 +25,4 @@
- Use Cases
## 3. Technische Grundlagen
Mein Aufgabenbereich umfasst einerseits die Entwicklung eigener Module, sowie das Bereitstellen des Services. Als Betriebsystem hab ich mich für Linux entschieden, einfach da ich mit Linux im Serverumfeld die meisten und besten Erfahrungen gemacht habe.

Rechtschreibung und Grammatik: 'Betriebssystem' mit drei 's', 'habe ich' statt 'hab ich' (Formellerer Stil), Komma vor dem Nebensatz 'da'.

Als Betriebssystem habe ich mich für Linux entschieden, einfach, da ich mit Linux im Serverumfeld die meisten und besten Erfahrungen gemacht habe.
Rechtschreibung und Grammatik: 'Betriebssystem' mit drei 's', 'habe ich' statt 'hab ich' (Formellerer Stil), Komma vor dem Nebensatz 'da'. ```suggestion Als Betriebssystem habe ich mich für Linux entschieden, einfach, da ich mit Linux im Serverumfeld die meisten und besten Erfahrungen gemacht habe. ```
Kocoder marked this conversation as resolved
@@ -6,0 +28,4 @@
Mein Aufgabenbereich umfasst einerseits die Entwicklung eigener Module, sowie das Bereitstellen des Services. Als Betriebsystem hab ich mich für Linux entschieden, einfach da ich mit Linux im Serverumfeld die meisten und besten Erfahrungen gemacht habe.
(Diese Entscheidung wurde gemeinsam getroffen:)
Auch steht die Wahl der Programmiersprache und des CMS an. Nachdem wir im Unterricht fast ausschließlich mit C# entwickelt haben und nicht in eine komplett unbekannte Entwicklungsumgebung abdriften wollten, haben wir uns für Webentwicklung mit ASP.NET Core 9 und (upgrade im Lauf der Diplomarbeit auf .NET core 10) dem CMS Oqtane entschieden. Auch hier gab es einige Kandidaten:

Großschreibung: 'Upgrade' und '.NET Core' sollten großgeschrieben werden.

Nachdem wir im Unterricht fast ausschließlich mit C# entwickelt haben und nicht in eine komplett unbekannte Entwicklungsumgebung abdriften wollten, haben wir uns für Webentwicklung mit ASP.NET Core 9 und (Upgrade im Lauf der Diplomarbeit auf .NET Core 10) dem CMS Oqtane entschieden.
Großschreibung: 'Upgrade' und '.NET Core' sollten großgeschrieben werden. ```suggestion Nachdem wir im Unterricht fast ausschließlich mit C# entwickelt haben und nicht in eine komplett unbekannte Entwicklungsumgebung abdriften wollten, haben wir uns für Webentwicklung mit ASP.NET Core 9 und (Upgrade im Lauf der Diplomarbeit auf .NET Core 10) dem CMS Oqtane entschieden. ```
Kocoder marked this conversation as resolved
@@ -6,0 +30,4 @@
(Diese Entscheidung wurde gemeinsam getroffen:)
Auch steht die Wahl der Programmiersprache und des CMS an. Nachdem wir im Unterricht fast ausschließlich mit C# entwickelt haben und nicht in eine komplett unbekannte Entwicklungsumgebung abdriften wollten, haben wir uns für Webentwicklung mit ASP.NET Core 9 und (upgrade im Lauf der Diplomarbeit auf .NET core 10) dem CMS Oqtane entschieden. Auch hier gab es einige Kandidaten:
- Piranha CMS
>Auf den ersten Blick nicht so flexibel wie Oqtane. Basiert auf .NET 8.0. Nicht so aktiv gewartet wie Oqtane.

Stil: Das sind Satzfragmente. In einer Diplomarbeit sind ganze Sätze besser.

Es erscheint auf den ersten Blick nicht so flexibel wie Oqtane, basiert auf .NET 8.0 und wird nicht so aktiv gewartet.
Stil: Das sind Satzfragmente. In einer Diplomarbeit sind ganze Sätze besser. ```suggestion Es erscheint auf den ersten Blick nicht so flexibel wie Oqtane, basiert auf .NET 8.0 und wird nicht so aktiv gewartet. ```
Kocoder marked this conversation as resolved
@@ -6,0 +32,4 @@
- Piranha CMS
>Auf den ersten Blick nicht so flexibel wie Oqtane. Basiert auf .NET 8.0. Nicht so aktiv gewartet wie Oqtane.
- Umbraco
>Viel Arbeit mit Partials, welche in der Admin Oberfläche geschieht. Aber sehr gut Dokumentiert. Wirkt nicht so flexibel.

Kleinschreibung: 'dokumentiert' ist ein Adjektiv.

Aber es ist sehr gut dokumentiert. Es wirkt jedoch nicht so flexibel.
Kleinschreibung: 'dokumentiert' ist ein Adjektiv. ```suggestion Aber es ist sehr gut dokumentiert. Es wirkt jedoch nicht so flexibel. ```
Kocoder marked this conversation as resolved
@@ -6,0 +34,4 @@
- Umbraco
>Viel Arbeit mit Partials, welche in der Admin Oberfläche geschieht. Aber sehr gut Dokumentiert. Wirkt nicht so flexibel.
- DNN / Dot Net Nuke
>Platzhirsch. Kennt man, wird von der DNN Foundation gewartet. Arbeitet mit dem Dotnet Framework, welches nicht unter Linux läuft. Und ein Windows Server stelle ich nicht einfach so ins Internet, ganz von den Lizenzkosten abgesehen.

Grammatik/Stil: 'würde stellen' (Konjunktiv) und 'abgesehen von'.

Und einen Windows Server würde ich nicht einfach so ins Internet stellen, abgesehen von den Lizenzkosten.
Grammatik/Stil: 'würde stellen' (Konjunktiv) und 'abgesehen von'. ```suggestion Und einen Windows Server würde ich nicht einfach so ins Internet stellen, abgesehen von den Lizenzkosten. ```
Kocoder marked this conversation as resolved
@@ -6,0 +36,4 @@
- DNN / Dot Net Nuke
>Platzhirsch. Kennt man, wird von der DNN Foundation gewartet. Arbeitet mit dem Dotnet Framework, welches nicht unter Linux läuft. Und ein Windows Server stelle ich nicht einfach so ins Internet, ganz von den Lizenzkosten abgesehen.
- Oqtane
>Schlecht Dokumentiert, auf den ersten Blick sehr Modular und Flexibel.

Kleinschreibung: 'dokumentiert', 'modular' und 'flexibel' sind Adjektive.

Schlecht dokumentiert, auf den ersten Blick jedoch sehr modular und flexibel.
Kleinschreibung: 'dokumentiert', 'modular' und 'flexibel' sind Adjektive. ```suggestion Schlecht dokumentiert, auf den ersten Blick jedoch sehr modular und flexibel. ```
Kocoder marked this conversation as resolved
@@ -6,0 +40,4 @@
Am Ende haben wir uns für das Oqtane Framework trotz seiner schlechten Dokumentation entschieden.
Im Bereich der Datenbanken musste ich mich mir ein paar Fragen stellen.

Grammatik: 'mich' ist hier überflüssig (Reflexivpronomen-Fehler).

Im Bereich der Datenbanken musste ich mir ein paar Fragen stellen.
Grammatik: 'mich' ist hier überflüssig (Reflexivpronomen-Fehler). ```suggestion Im Bereich der Datenbanken musste ich mir ein paar Fragen stellen. ```
Kocoder marked this conversation as resolved
@@ -6,0 +42,4 @@
Im Bereich der Datenbanken musste ich mich mir ein paar Fragen stellen.
1. Auf welche Art Datenbank setzen wir? SQL, NoSQL, Graph, ...
2. Mit welcher speziellen Implementiereung bekommen wir support und haben Wissen im Team?

Rechtschreibung: 'Implementierung' und 'Support' (Großschreibung).

2. Mit welcher speziellen Implementierung bekommen wir Support und haben Wissen im Team?
Rechtschreibung: 'Implementierung' und 'Support' (Großschreibung). ```suggestion 2. Mit welcher speziellen Implementierung bekommen wir Support und haben Wissen im Team? ```
Kocoder marked this conversation as resolved
@@ -6,0 +45,4 @@
2. Mit welcher speziellen Implementiereung bekommen wir support und haben Wissen im Team?
3. Ist das auserkorene System kompatibel mit dem CMS auf dem wir aufbauen?
Es war von Anfang an klar, dass es ein SQL basiertes System wird, da wir im Team nur mit SQL basierten Systemem erfahrungen haben. Außerdem unterstützt unser CMS (Oqtane) nur SQL basierte Systeme. In der Linuxwelt kommen jetzt nur noch ein paar Datenbanken in die Auswahl: PostgreSQL, MySQL / MariaDB, SQLite. Da ist die Wahl auf ProstgreSQL gefallen. Grund dafür war meine Vorerfahrung mit diesem DBMS, welche ich im Nebenjob errungen habe.

Rechtschreibung/Grammatik: 'Systemen', 'Erfahrungen' (Groß), 'PostgreSQL' (Tippfehler) und 'erworben' statt 'errungen'.

Es war von Anfang an klar, dass es ein SQL-basiertes System wird, da wir im Team nur mit SQL-basierten Systemen Erfahrungen haben. Außerdem unterstützt unser CMS (Oqtane) nur SQL-basierte Systeme. In der Linuxwelt kommen jetzt nur noch ein paar Datenbanken in die Auswahl: PostgreSQL, MySQL / MariaDB, SQLite. Da ist die Wahl auf PostgreSQL gefallen. Grund dafür war meine Vorerfahrung mit diesem DBMS, welche ich im Nebenjob erworben habe.
Rechtschreibung/Grammatik: 'Systemen', 'Erfahrungen' (Groß), 'PostgreSQL' (Tippfehler) und 'erworben' statt 'errungen'. ```suggestion Es war von Anfang an klar, dass es ein SQL-basiertes System wird, da wir im Team nur mit SQL-basierten Systemen Erfahrungen haben. Außerdem unterstützt unser CMS (Oqtane) nur SQL-basierte Systeme. In der Linuxwelt kommen jetzt nur noch ein paar Datenbanken in die Auswahl: PostgreSQL, MySQL / MariaDB, SQLite. Da ist die Wahl auf PostgreSQL gefallen. Grund dafür war meine Vorerfahrung mit diesem DBMS, welche ich im Nebenjob erworben habe. ```
Kocoder marked this conversation as resolved

Stil: Zahlen von eins bis zwölf schreibt man im Fließtext üblicherweise aus.

Ein Modul in Oqtane besteht aus vier Projekten: Server, Client, Shared und Package.
Stil: Zahlen von eins bis zwölf schreibt man im Fließtext üblicherweise aus. ```suggestion Ein Modul in Oqtane besteht aus vier Projekten: Server, Client, Shared und Package. ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'Startup-Logik' (Bindestrich bei Komposita).

Im Server-Projekt liegt Sourcecode, welcher serverseitig ausgeführt werden soll. In der Praxis bedeutet das: alle Repositories, Controller, Manager, Migrationen und Server-Services (entwickelt nach einem Interface definiert im Client) und Server-Startup-Logik.
Rechtschreibung: 'Startup-Logik' (Bindestrich bei Komposita). ```suggestion Im Server-Projekt liegt Sourcecode, welcher serverseitig ausgeführt werden soll. In der Praxis bedeutet das: alle Repositories, Controller, Manager, Migrationen und Server-Services (entwickelt nach einem Interface definiert im Client) und Server-Startup-Logik. ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'Startup-Logik' und 'Interfaces' (Tippfehler).

Also Client-Startup-Logik, Client-Services (+ Interfaces dafür, die Services hier sollen lediglich die Server-Services über HTTP aufrufen), Ressourcendateien (.resx), die Komponenten / das User Interface und die Moduldefinitionen für jedes Modul.
Rechtschreibung: 'Startup-Logik' und 'Interfaces' (Tippfehler). ```suggestion Also Client-Startup-Logik, Client-Services (+ Interfaces dafür, die Services hier sollen lediglich die Server-Services über HTTP aufrufen), Ressourcendateien (.resx), die Komponenten / das User Interface und die Moduldefinitionen für jedes Modul. ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'Package-Projekt' (Bindestrich).

Im Package-Projekt findet man Skripte zum Debuggen und Releasen eines Moduls und die NuGet-Spezifikation.
Rechtschreibung: 'Package-Projekt' (Bindestrich). ```suggestion Im Package-Projekt findet man Skripte zum Debuggen und Releasen eines Moduls und die NuGet-Spezifikation. ```
Kocoder marked this conversation as resolved

Grammatik: 'SOLID-Prinzipien' (Durchkopplung mit Bindestrich).

Das Dependency-Inversion-Principle (DIP / auf Deutsch: Abhängigkeits-Umkehr-Prinzip) ist eines der fünf `SOLID`-Prinzipien in der Softwareentwicklung.
Grammatik: 'SOLID-Prinzipien' (Durchkopplung mit Bindestrich). ```suggestion Das Dependency-Inversion-Principle (DIP / auf Deutsch: Abhängigkeits-Umkehr-Prinzip) ist eines der fünf `SOLID`-Prinzipien in der Softwareentwicklung. ```
Kocoder marked this conversation as resolved

Grammatik: Subjekt-Verb-Kongruenz ('die Implementierung soll').

- Die Abstraktionen sollen nicht von Implementierungsdetails abhängig sein, sondern die Low-Level-Implementierung soll gemäß der Abstraktionsschicht implementiert werden. [^3]
Grammatik: Subjekt-Verb-Kongruenz ('die Implementierung soll'). ```suggestion - Die Abstraktionen sollen nicht von Implementierungsdetails abhängig sein, sondern die Low-Level-Implementierung soll gemäß der Abstraktionsschicht implementiert werden. [^3] ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'Injection' statt 'Injektion' für Konsistenz mit dem restlichen Text.

Dependency Injection ist in .NET genauso wie Konfiguration, Protokollierung und das Optionsmuster ins Framework integriert. [^4]
Rechtschreibung: 'Injection' statt 'Injektion' für Konsistenz mit dem restlichen Text. ```suggestion Dependency Injection ist in .NET genauso wie Konfiguration, Protokollierung und das Optionsmuster ins Framework integriert. [^4] ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'danach' mit einem 'n'.

Beim Instanziieren einer Klasse werden alle im Konstruktor erwarteten Dependencies bereitgestellt, bzw. selbst instanziiert und danach bereitgestellt. [^4]
Rechtschreibung: 'danach' mit einem 'n'. ```suggestion Beim Instanziieren einer Klasse werden alle im Konstruktor erwarteten Dependencies bereitgestellt, bzw. selbst instanziiert und danach bereitgestellt. [^4] ```
Kocoder marked this conversation as resolved

Grammatik: 'eine Dependency' (feminin).

Wir haben einen Service (Klasse Worker), eine Dependency (Klasse MessageWriter) und eine Abstraktionsebene von der Dependency (Interface IMessageWriter).
Grammatik: 'eine Dependency' (feminin). ```suggestion Wir haben einen Service (Klasse Worker), eine Dependency (Klasse MessageWriter) und eine Abstraktionsebene von der Dependency (Interface IMessageWriter). ```
Kocoder marked this conversation as resolved

Rechtschreibung: 'danach' mit einem 'n'.

Bei Programmstart wird zuerst manuell der Service-Container erstellt, danach alle Module registriert.
Rechtschreibung: 'danach' mit einem 'n'. ```suggestion Bei Programmstart wird zuerst manuell der Service-Container erstellt, danach alle Module registriert. ```
Kocoder marked this conversation as resolved

🤖 Word Count Report

Word count for Diplomarbeitsbuch-individueller-teil-Konstantin-Hintermayer.md

Word count: 1308

### 🤖 Word Count Report #### Word count for `Diplomarbeitsbuch-individueller-teil-Konstantin-Hintermayer.md` Word count: 1308
Kocoder added 1 commit 2026-03-04 10:51:22 +00:00
Apply Gemini-Dokumentation-Review-Suggestions
All checks were successful
Word Count / count-words (pull_request) Successful in 32s
fea6d6bdda

🤖 Word Count Report

Word count for Diplomarbeitsbuch-individueller-teil-Konstantin-Hintermayer.md

Word count: 1327

### 🤖 Word Count Report #### Word count for `Diplomarbeitsbuch-individueller-teil-Konstantin-Hintermayer.md` Word count: 1327
Kocoder merged commit 104cfca699 into main 2026-03-05 12:41:47 +00:00
Kocoder deleted branch Einleitung-individueller-Teil-Konstantin-Hintermayer 2026-03-05 12:41:53 +00:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Diplomarbeit-Absolventenverein/pm#64