Softwaretechnik 2 (ST2)

ST2 ist eine Veranstaltung im 4. Semester des Informatik Bachelor. Diese Seite (mit den entsprechenden Unterseiten) wird fortlaufend aktualisiert. Es wäre also sinnvoll, wenn Sie die Seite bookmarken. 

Inhalte dieser Seite

Ziel der Veranstaltung

Die Veranstaltung ST2 versucht Sie mit grundlegenden Überlegungen beim Design und der Implementierung von komplexen Softwaresystemen vertraut zu machen. Im Praktikum wird dabei Wert darauf gelegt, das theoretische Wissen auch praktisch umzusetzen. Folgendes Learning Outcome liegt der Veranstaltung zugrunde - das sollten Sie am Ende können, wenn Sie für sich das Beste aus der Veranstaltung herausholen.

Organisation der Veranstaltung

Wie Sie dem Stundenplan entnehmen können, liegt die ST2-Vorlesung auf dem Montagmorgen, gefolgt vom ST2-Praktikum während des Rests des Montags. Diese Vorgabe werde ich nicht wörtlich umsetzen, sondern in der folgenden Form:

• Klassische Vorlesungen wird es nicht geben. Stattdessen stelle ich den Vorlesungsstoff in eigens produzierten Videos und als begleitendes Script zur Verfügung. 
• Die im Stundenplan vorgesehenen Zeitschlitze werde ich in Form von ganztägigen Workshops nutzen. "Ganztägig" bedeutet hier im Allgemeinen 10:00 - 16:00 mit einer Mittagspause. Nicht jeder Montag ist belegt, siehe Zeitplan unten. 
• An diesen Workshoptagen werde ich in der Regel zum aktuellen Stoff / Praktikums-Meilenstein eine oder mehrere Übungen mit Ihnen machen. Sie bearbeiten die Übungen allein oder in selbstorganisierten Gruppen. Meine Mitarbeiter und ich stehen als Ansprechpartner zur Verfügung. Abschließend besprechen wir die Lösungen. 

Team

Das ist das Beratungsteam für ST2:

Stefan Bente stefan.bente@th-koeln.de	Ansprechpartner für Feedback zur Veranstaltung, weitergehende Fragen / Anregungen / Wünsche, Rückfragen zu Vorlesungsinhalten Erreichbar am besten Discord, wenn es um Fragen von allgemeinem Interesse geht bei persönlichen Anliegen am besten per Email (antwortet in der Regel innerhalb eines Tages, sonst bitte nochmal nachfragen) für weitergehende Anliegen am besten eine Sprechstunde buchen: https://calendly.com/bente/termine (aber bitte probieren Sie erstmal, ob es auch via Discord oder Mail zu klären ist)
Fabian Krampe fabian.krampe@th-koeln.de	Primärer Ansprechpartner für die inhaltlichen Fragen im Praktikum  erreichbar am besten über den Discord, ersatzweise per Email Sie dürfen gerne außerhalb "üblicher" Zeiten Fragen stellen, eine Antwort dauert dann unter Umständen nur etwas länger.
Jann Intveen jann.intveen@th-koeln.de	Ansprechpartner für technische Problem mit Gitlab oder der sonstigen Infrastruktur, sowie in Fragen der Programmierung erreichbar am besten über den Discord-Server, ersatzweise per Email Sie dürfen gerne außerhalb "üblicher" Zeiten Fragen stellen, eine Antwort dauert dann unter Umständen nur etwas länger.
Philipp Schmeier philipp.schmeier@th-koeln.de	Unterstützt zu "Stoßzeiten"

Beratung vorzugsweise via Discord

Als sehr effektive Plattform zur Beratung und Diskussion hat sich bei uns Discord herausgestellt. Sie können daher dem ArchiLab-Discord-Server beitreten: https://discord.gg/YYNYb5whU8. Wählen Sie dann "ST2" als Rolle, und Sie sehen die Channels für diese Veranstaltung. 

Wer Discord nicht nutzen will, kann das ST2-Team auch direkt per Mail kontaktieren. 

Zoom-Link

Für die Workshops nutzen wir immer denselben Zoom-Link: 

• https://th-koeln.zoom.us/j/84123510115?pwd=NlhCTUxaWHNrTld3R1JuK3Nnd3NDUT09
• Meeting ID: 841 2351 0115
  Passcode: st2

Videos und Script

Die Videos zur Vorlesung finden Sie auf dem ArchiLab-Youtube-Kanal: https://www.youtube.com/channel/UC29euiLjp5m-hPoU3QP3nGA/. Die Videos für ST2 werden zu Beginn der Veranstaltung nicht fertig produziert sein. Das ergänze ich während des Semesters nach und nach. Bitte haben Sie Nachsicht, wenn es mal einen Tag länger dauert, bis das Video verfügbar ist. Die Erfahrung zeigt, dass das leider ein sehr aufwändiger Prozess ist. 

Das Skripte zum Inhalt der Videos (also zum Veranstaltungsstoff) finden Sie (fortlaufend ergänzt) auf ILIAS: https://ilias.th-koeln.de/goto.php?target=file_1854728_download&client_id=ILIAS_FH_Koeln

Zeitplan und Inhalt

(die durchgestrichenen Inhalte entfallen aus Zeitgründen)

Praktikum

Das Praktikum besteht aus fünf Meilensteinen (M0 - M4). Es deckt die wesentlichen Teile des Vorlesungsstoffes ab, indem es Aufgaben mit einem konzeptionellen Lernanteil in einer praktischen Implementierung verlangt. 

Anmeldung

Um im Sommersemester 2021 am ST2-Praktikum teilzunehmen, sind zwei Schritte erforderlich:

1. Melden Sie sich in dem ST2-ILIAS-Kurs an
2. Melden Sie sich einmalig unter https://git.st.archi-lab.io/ mit ihrer CampusID an

Die Deadline hierzu ist Freitag, der 09.04.2021 um 16:00 Uhr.

Organisation des Praktikums

• Es wird keine von uns verwaltete Praktikumsgruppen mehr geben. Jede*r Teilnehmer*in liefert eine individuelle Lösung ab. Sie sind aber herzlich eingeladen, sich selber in Lerngruppen zu organisieren.
• Die Abnahme erfolgt durch "git push" auf unseren Gitlab Server.
• Feste Praktikumstermine wird es ebenfalls nicht mehr geben. In den ST-Workshoptagen machen wir Übungen zu dem Stoff der Vorlesung. In der verbleibenden Zeit können Sie schon einmal anfangen, am Praktikum zu arbeiten. Das Betreuerteam ist dann verfügbar, um Fragen zu beantworten. 
• Für den Austausch untereinander sowie Fragen an die Betreuer wurde ein Discord-Server erstellt (siehe oben). Der Beitritt ist freiwillig, allerdings (als einfachste Lösung) zu empfehlen. 

Regeln

1. Das bestandene Praktikum ist Voraussetzung für die Teilnahme an der Klausur
2. Das Praktikum wird nicht benotet. Man kann auch keine Bonuspunkte erwerben.
3. Das Praktikum ist bestanden, wenn alle Meilensteine erfolgreich bestanden wurden
4. Ein Meilenstein kann aus automatisierten und aus manuell bewerteten Aufgaben bestehen. Für beides finden Sie das Feedback in Ihrer personalisierten Feedback-Seite (siehe unten).
5. Ein Meilenstein ist bestanden, wenn alle Aufgaben bestanden sind (also alle automatisierten und alle manuell kontrollierten). 
6. Sind bis zur Deadline nicht alle Tests erfolgreich, so gilt der Meilenstein (und somit das Praktikum) als nicht bestanden.
7. Wer über Discord oder auf anderem Wege ganze Lösungen teilt, begeht einen Täuschungsversuch und wird aus dem Praktikum ausgeschlossen. 
8. Sich gegenseitig zu helfen ist aber ausdrücklich erwünscht! Nutzen Sie Discord (den #praktikum Channel), um über Probleme zu diskutieren. Sie sollen einfach nur nicht Ihre eigenen Lösungen dort posten.

Geänderte Regelung für E2/E3 (SOLID- und Clean-Code-Konformität)

Bei der Bearbeitung des Praktikums haben wir festgestellt, dass ca. 1/4 bis 1/3 der Lösungen einen recht souveränen Umgang mit gutem Code-Stil zeigen. Bei dem Rest sind aber teilweise deutliche Defizite zu erkennen. Deshalb machen wir mit sofortiger Wirkung folgende Änderungen im Praktikumsablauf: 

1. Für das Bestehen von Meilenstein 1 (M1) ist nur noch "E1 grün" notwendig.
2. Die Aufgaben E2 und E3 bleiben aber erhalten - Sie haben dafür bis Ende des Praktikums Zeit. Wer des jetzt (in M1) schon fertig hat, braucht an der Stelle nichts mehr zu tun. Alle anderen müssen irgendwann bis Ende des Praktikums die Konformität mit SOLID und Clean Code nachweisen. 
3. Denjenigen, die E2/E3 noch nicht haben, legen wir die intensive Nutzung von Peer Reviews nahe. Wir unterstützen Sie dabei, einen Peer-Review-Partner zu finden. 
4. Mit den Peer Reviews bereiten Sie die E2/E3-Abnahme vor. Statt einer Begutachtung vereinbaren Sie einen Abnahmetermin mit den ST2-Mitarbeitern. Es gibt nur einen Abnahmetermin (plus ein Nachholversuch). Sie haben also den Anreiz, Ihren Code in Peer Reviews sorgfältig auf die Abnahme vorzubereiten. 
5. Sie können ab sofort also aufhören, um ein Nachsehen von E2/E3 zu bitten. Prüfen Sie stattdessen, ob Sie reif für die Abnahme sind, und vereinbaren Sie dann einen Termin. Details, wie man das macht, folgen. 

Wie funktioniert die Praktikumsbearbeitung und Abgabe?

Alle Meilensteine sind für Sie persönlich individualisiert. Lösungen können also nicht einfach zwischen den Aufgabenstellungen ausgetauscht werden. 

Um die Aufgaben erfolgreich bearbeiten zu können, muss sich der Student sein eigenes Repository lokal clonen (mit Git). Achtung: Um die Funktionalität des Projekts zu gewährleisten, sollen Studenten nichts, was außerhalb des Ordners "src/main" liegt, verändern.

Hier finden Sie noch zusätzliche Infos: 

• Informationen zu zur Benutzung von Git oder zur Java Programmierung: http://staff.pages.st.archi-lab.io/st1/learning-material/
• Zusätzliches Video zur Erklärung, wie man Git benutzt, und was man fürs Praktikum beachten muss: Einführung in Git und DevEnv

Persönliche Feedbackseite

Für jede/n Student*in wird eine persönliche Testseite generiert. Diese listet sämtliche Tests des Übungsprojektes auf und wird bei jeder Codeänderung aktualisiert (dauert teils mehrere Minuten). Erst wenn alle Tests auf der Testseite grün markiert sind, gilt der Meilenstein als bestanden. Anhand der Testseite ist erkennbar, wer die einzelnen Meilensteine besteht und wer nicht. Der Link zur Testseite hängt von dem jeweiligen Repository-Namen ab. Hier eine schrittweise Anleitung, wie man zur jeweiligen eigenen Testseite kommt.

• (1) Als erstes ist es wichtig, die UUID des Projekts herauszufinden. Dazu schauen wir uns den Namen des Projekts an und kopieren die UUID aus dem Ende des Namens. Im folgenden Screenshot ist die UUID rot markiert:

• (2) Diese UUID setzen wir nun an das Ende von folgendem Link: 
  http://students.pages.st.archi-lab.io/st2/meilenstein-0/tests/basics_tests_group_<uuid>
  
  Bei unserem Beispiel würde der Link dann wie folgt aussehen:
  http://students.pages.st.archi-lab.io/st2/meilenstein-0/tests/basics_tests_group_482de55b-e650-4b77-b47d-85c48d9201ff
  
  
• (3) Auf der Testseite sind nun alle relevanten Tests aufgeführt. Grüne Tests sind bestanden und rote nicht bestanden. Auf rote Tests kann geklickt werden, um Informationen bezüglich des Fehlschlagens eines Tests zu erhalten:
  

Tools

SSH

Wer im Gitlab kein Passwort hinterlassen möchte, um auf das remote Repository zu pushen kann sich auch einen ssh key generieren und diesen in gitlab eintragen. Eine Anleitung hierzu findet man hier: https://docs.gitlab.com/ee/ssh/. Da sich durch Nutzung von SSH unter anderem das Protokoll ändert, muss man beim Clonen eines Repositories den Link anpassen. Normalerweise würde man ein Repository mit folgendem Befehl klonen:

git clone https://git.st.archi-lab.io/students/st1/meilenstein-0/basics_group_<uuid>

Durch Nutzung von SSH würde sich dieser Befehl zu folgendem ändern:

git clone ssh://git@git.st.archi-lab.io:22996/students/st1/meilenstein-0/basics_group_<uuid>.git

Java Development

Für die Java-Entwicklung brauchen Sie zwei Arten von Tools: 

• Git: am besten die Git Bash
• IDE: hier bieten sich zwei Optionen an: 
  • IntelliJ Ultimate (frei für Studierende)
  • Visual Studio Code

UML Modelling

UML-Modelle sind kein Schwerpunkt in ST2 (eher in ST1). Es kann aber vorkommen, dass auf Modelle Bezug genommen wird oder eine Modellierung im Praktikum verlangt wird.

Es gibt eine große Menge von dedizierten UML-Modellierungstools und sonstigen Zeichenwerkzeugen, die auch UML können. Keines dieser Tools (jedenfalls keins der freien Tools) finde ich so gut, dass ich eine klare Empfehlung aussprechen möchte. Mit einigen habe ich selbst gearbeitet, und diese drei sind zumindest empfehlenswert:

• Modelio, https://www.modelio.org/
• UMLet, https://www.umlet.com/
• diagrams.net (früher draw.io), https://www.diagrams.net/