Studienplaner und Notenübersicht

Ein Kommandozeilenprogramm zur Verwaltung von Veranstaltungen und Studienleistungen

Erstellt wurde das Programm von:

• Adrian Jonkov
• Jakob Watson
• Franz Düchs

Programm kompilieren

Dieses Programm benutzt make als build system. Hier sind einige hilfreiche Befehle:

// Alias für `make all`
make
// Kompiliert das Programm. Output ist in `./build/gradeviewer`. Rekompiliert nur Dateien die sich seit dem letzten Mal geändert haben.
make all
// Kompiliert und führt das Programm aus
make run
// Rekompiliert das ganze Programm von neu (selbst wenn nur minimale/keine Änderungen durchgeführt wurden) 
make run rebuild=1
// Führt die Tests aus
make run test=1
// Mit valgrind nach memory leaks checken
make valgrind
// Mit callgrind profilen
make profile
// Siehe die `Makefile` für weitere Informationen und Features

Falls kein make auf dem System installiert ist, kann der Compiler auch manuell zum Kompilieren aufgerufen werden:

gcc -Wall -Wextra -pedantic -std=c11 src/data/load.c src/data/save.c src/frontend/edit_events/edit_events.c src/frontend/text_formatting/text_formatting.c src/frontend/user_input/user_input.c src/json/internal/config.c src/json/internal/deserialize.c src/json/internal/jsonvalue.c src/json/internal/lexer/main.c src/json/internal/lexer/number.c src/json/internal/parser.c src/json/internal/serialize.c src/json/test/fxx_test.c src/json/test/jsonperf.c src/json/test/jsontestsuite.c src/json/test/test.c src/json/utils/alloc/arena.c src/json/utils/custom_error.c src/json/utils/hashmap/hashmap.c src/json/utils/hashmap/hashmap_node.c src/json/utils/list.c src/json/utils/string/dstring.c src/json/utils/string/file.c src/json/utils/string/string_view.c src/json/utils/unicode/utf16.c src/json/utils/unicode/utf8.c src/json/utils/unicode/wchar.c src/main/main.c src/midend/data.c src/midend/mid.c

Hinweis

Je nach Betriebssystem und Compiler kann es sein, dass Warnungen beim Kompilieren auftreten. In der Angabe war zwar spezifiziert, dass keine Warnungen entstehen dürfen, jedoch ist es virtuell unmöglich dies praktisch umzusetzen, da nicht jeder mögliche Compiler und jedes Betriebssystem getestet werden können. Wir haben versucht alle Warnungen bestmöglich zu eliminieren, jedoch kann es auf bestimmten Systemen doch noch zu einzelnen neuen Warnungen kommen. Besonders unter Windows ist es möglich, dass Fehler wegen dem %zu format specifier für size_t auftauchen. Das liegt daran, dass der Compiler %zu nicht erkennt, selbst wenn die eigentliche Implementation der format specifiers (welche letztenendes beim Ausführen des Prorammes benutzt wird) dies tut. Siehe hier für mehr Informationen dazu.

JSON Parser

Das Programm enthält einen eigens entwickelten JSON Parser unter src/json, der auch als separate Library genutzt werden kann. Unter src/data ist eine beispielhafte Nutzung der Library für dieses Programm zu finden.

• Die Architektur ist ein Lexer-Parser split mit in-memory DOM Darstellung
• Eigene C-Daten können mithilfe der Library serialisiert werden
• Um ohne externe libraries auszukommen wurden viele Datenstrukturen eigens implementiert
• Der Parser wurde intensiv mit den in der Codebase enthaltenen Tools getestet und gebenchmarkt. Er kann teilweise mit bestehenden Implementationen mithalten
• Wenn memory allocations fehlschlagen (z.B. bei OOM) panicked der Parser und bricht das Programm ab, da in diesen Fällen sowieso meist keine sinnvolle error recovery mehr möglich ist.

Nutzungshinweise

Allgemeines

Im folgenden Abschnitt werden Tastatureingaben durch eckige Klammern [] gekennzeichnet (z. B. Taste [q] zum beenden des Programms).

• Mit Ausnahme aller Eingabedialoge, kann von jeder Seite innerhalb des Programms mit [h] die Hilfe aufgerufen werden.
  
  
• Mit Ausnahme aller Eingabedialoge kann das Programm jederzeit über [q] beendet werden.
  
  
• Wird eine ungültige Eingabe getätigt erscheint eine Fehlermeldung die den Nutzer darüber informiert welche Eingaben gültig sind. Anschließend hat der Nutzer erneut die Möglichkeit eine Eingabe zu tätigen.

Wird viermal direkt hintereinander eine falsche Eingabe getätigt ruft das Programm automatisch die **Hilfe** auf.
Wird bei angezeigter **Hilfe** viermal hintereinander eine falsche Eingabe getätigt wird das Programm automatisch beendet.

Programmstart

Nach dem Start des Programms wird zunächst der Startbildschirm angezeigt. Wurde das Programm zum allerersten Mal gestartet wird automatisch eine neue Datei angelegt in der die Veranstaltungen gespeichert werden. Wurden bereits Veranstaltungen angegelegt so wird die entsprechende .json-Datei automatisch geladen.

Fehlerbehandlung Datei laden
Tritt beim laden der Datei ein Fehler auf, erscheint auf dem Startbildschirm eine Fehlermeldung.
Der Nutzer hat drei Möglichkeiten mit dem Fehler umzugehen:

• [r]: Erneut versuchen die Datei zu laden
• [n]: Eine neue Datei anlegen in der die neu hinzugefügten Veranstaltungen gespeichert werden. Hierbei wird die bisher bestehende Datei gelöscht und alle Daten darin gehen verloren.
• [r]: Das Programm wird beendet
  
  

Optionen
Vom Startbildschirm aus gibt es drei verschiedene Optionen:

• [v]: Ruft die Veranstaltungsübersicht auf
• [h]: Ruft die Hilfe des Programms auf
• [q]: Das Programm wird beendet
  
  
  
  

Veranstaltungsübersicht

Die Veranstaltungsübersicht listet alle gespeicherte Veranstaltungen auf.
Die Veranstaltungen können nach Modulgruppe oder nach Semester sortiert angezeigt werden. Über [a] wird die Sortierung umgeschaltet.
Zu jeder Veranstaltung werden der Name, der Status, die Anzahl der Leistungspunkte und die Note angezeigt.
Bei der Sortierung nach Semester, wird zusätzlich die Summe der Leistungspunkte angezeigt die pro Semester erbracht wurden.
Bei der Sortierung nach Modulgruppe wird pro Modulgruppe angezeigt, wie viele Leistungspunkte bereits in der Modulgruppe erbracht wurden und wie viele Leistungspunkte insgesamt in der Modulgruppe zu erbringen sind.

Der Status der Veranstaltung unterscheidet zwischen drei Zuständen:

• ausstehend (es wurde noch keine Prüfung geschrieben)
• nicht bestanden (Note 4.3 oder schlechter)
• bestanden (Note 4.0 oder besser)

Zu jeder bestandenen und nicht bestandenen Veranstaltung wird Note angezeigt. Bei Veranstaltungen mit Status ausstehend wird keine Note angezeigt.

Optionen
Von der Veranstaltungsübersicht aus gibt es folgende Optionen:

• [n]: Neue Veranstaltung hinzufügen
• [m]: Neue Modulgruppe hinzufügen
• [d]: Aktuellen Leistungsstand anzeigen
• [b]: Daten einer bestehenden Veranstaltung bearbeiten
  
  
  
  

Veranstaltung hinzufügen

Die Option zum hinzufügen einer neuen Veranstaltung ist von der Veranstaltungsübersicht und der Anzeige des Leistungsstands aus aufrufbar. Mit [n] wird der Dialog zum hinzufügen einer neuen Veranstaltung aufgerufen. Anschließend müssen schrittweise alle nötigen Daten der Veranstaltung eingegeben werden:

1. Name

2. Modulgruppe
   Jede Veranstaltung muss zwingend einer Modulgruppe zugeordnet werden. Es kann entweder eine bereits bestehende Modulgruppe gewählt oder eine neue Modulgruppe angelegt werden.

3. Semester
   

   1. Auswahl:

      • Wintersemester [w]

      • Sommersemester [s]

   2. Jahreszahl des Semesterbeginns
      Beispielsweise [2025] für Wintersemester 2025/2026 oder [2027] für Sommersemester 2027.

4. Leistungspunkte

5. Note
   Das hinzufügen der Note ist optional.
   Wird [j] gewählt so muss anschließend eine gültige Note eingegeben werden. Entsprechend der Note wird der Status der Veranstaltung automatisch auf bestanden oder nicht bestanden gesetzt.
   Bei der Wahl von [n] muss keine Note eingegeben werden und der Status der Veranstaltung wird automatisch auf ausstehend gesetzt.
   
   Nachdem die Eingabe der Daten abgeschlossen wurde wird automatisch wieder die Seite angezeigt von welcher aus der Dialog zum hinzufügen der Veranstaltung aufgerufen wurde (entweder Veranstaltungsübersicht oder Leistungsstand).

Modulgruppe anlegen

Die Option zum hinzufügen einer neuen Modulgruppe ist von der Veranstaltungsübersicht und der Anzeige des Leistungsstands aus aufrufbar. Mit [m] wird der Dialog zum hinzufügen einer neuen Modulgruppe aufgerufen. Anschließend müssen schrittweise alle nötigen Daten der Modulgruppe eingegeben werden:

1. Name

2. Leistungspunkte
   Es muss die Anzahl der Leistungspunkte eingegeben werden die insgesamt in dieser Modulgruppe erbracht werden müssen.

Nachdem die Eingabe der Daten abgeschlossen wurde wird automatisch wieder die Seite angezeigt von welcher aus der Dialog zum hinzufügen der Modulgruppe aufgerufen wurde (entweder Veranstaltungsübersicht oder Leistungsstand).

Veranstaltung bearbeiten

Die Option zum bearbeiten einer Veranstaltung ist von der Veranstaltungsübersicht und der Seite des Leistungsstands aufrufbar. Mit [b] erscheint der Dialog zum bearbeiten einer Veranstaltung. Zunächst gibt man mithilfe eiens Indexes an, welche Veranstaltung man bearbeiten möchte. Hat man dies ausgewählt wird einem nochmal schön übersichtlich die Veranstaltung angezeigt, die man bearbeitet. Jetzt hat man verschiedene Möglichkeiten zum Bearbeiten des Moduls.

1. [l] Veranstaltung löschen
2. [n] Note ändern/hinzufügen
3. [m] Modulgruppe ändern
4. [v] Zurück zur Veranstaltungsübersicht
5. [c] Andere Veranstaltung wählen Bei jeder Auswahlmöglichkeit kommt man dann zu einer weiteren Auswahl, wie zb.: Neue Note eingeben oder Note auf "ausstehend" setzen.

Notendurchschnitt berechnen (nach FPO 2018 Bachelor Informatik)

Die Seite Leistungsstand wird mit [d] aufgerufen. Dort wird einem dann der Aktuelle Notendurchschnitt nach FPO 2018 Bachelor Informatik und die Summe der erreichten Leistungspunkte angezegit.

Der Notendurchschnitt wird wiefolgt berechnet: Alle bestandenen und benoteten Veranstaltungen werden den jeweiligen Modulgruppen zugeordnet und daraus schrittweise der Gesamtdurchschnitt ermittelt.

Der Ablauf der Berechnung erfolgt wie folgt:

1. Modulgruppen durchlaufen Für jede vorhandene Modulgruppe werden alle zugehörigen Veranstaltungen gesucht.
2. Geeignete Veranstaltungen auswählen Es werden nur Veranstaltungen berücksichtigt, die:
   • bestanden sind
   • eine gültige Note besitzen (note >= 1.0)
   • zur aktuellen Modulgruppe gehören
3. Gruppennote berechnen Aus den ausgewählten Veranstaltungen wird eine Gruppennote als leistungspunkt-gewichteter Mittelwert berechnet.
4. Gewichtung mit Modulgruppen-LP Die Gruppennote wird mit den vorgesehenen Leistungspunkten der Modulgruppe (lp_todo) gewichtet und zum Gesamtergebnis addiert.

Unbenotete oder nicht bestandene Veranstaltungen werden ignoriert. Falls keine bewerteten Leistungspunkte vorhanden sind, gibt die Funktion 0.0 zurück.

Rückgabewert: gewichteter Gesamtnotendurchschnitt (double).

Hilfe

Das Programm enthält eine zentrale Hilfe auf der die wesentlichen Programmfunktionen erklärt werden. Die Seite bietet dem Nutzer eine erste Anlaufstelle bei Fragen zur Nutzung des Programms.

Die Hilfe kann von jeder Seite innerhalb des Programms, mit Ausnahme der Eingabedialoge, über [h] aufgerufen werden.