Dies ist eine alte Version des Dokuments!
LU09.A01 - Schulverwaltung
Sie können in einer komplexen Anwendung selbständig
- die Klassen erstellen
- die Beziehungen einpflegen (einseitig, zweiseitig, mehrfache)
- den nötigen Ablauf selbst festlegen
- die gefordeten Ausgaben erzeugen
Vorgehen
- Studieren Sie jeweils das UML-Diagramm sowie die Erklärungen zu den einzelnen Methoden.
- Halten Sie sich an die Reihenfolge bei der Erstellung der Klassen.
- Testen Sie die jeweilige Klasse, bis alle Test erfolgreich ablaufen.
Auftrag
Es ist eine einfache Schulverwaltung gemäss folgendem Klassendiagramm zu implementieren.
Dabei nutzen Sie Ihr Wissen zu ein- und zweiseitiger Beziehung sowie den 4 gezeigten Fällen der Referenzzuweisung. Ebenso verwenden Sie Mehrfachbeziehungen.
Vorgehen
Die Beschreibung der Klassen und Methoden erfolgt von links nach rechts und von oben nach unten. Erstellen Sie selbständig einen Plan, in welcher Reihenfolge Sie die Klassen erstellt wollen. Ein paar Tipps:
- Es lohnt sich zunächst das Gerüst einer Klasse mit allen Methoden zu bauen.
- Klassen die keine Referenzen zu anderen Klassen enthalten, sollten zuerst umgesetzt werden.
- Versuche danach Klassen umzusetzen, bei denen die referenzierte Klasse bereits erstellt ist.
- Der Konstruktor einer Klasse sollte in der Regel zuerst erstellt werden.
- Danach folgen Methoden ohne Logik, z.B.
property
undsetter
. - Bei Methoden die eine Verarbeitungslogik enthalten, wird zunächst einfach ein hart codierter Returnwert zurück gegeben.
Hinweise
- Testen Sie jede Klasse/Methode mit den jeweiligen Unit Tests. Führen Sie die Tests einzeln aus, da vor allem zu Beginn sehr viele Tests scheitern werden.
- Die Methoden
show_…
liefern immer einen String als Returnwert. Derprint
-Befehl wird nur immain()
genutzt.
SchoolClass
Konstruktor
- Die Schreibweise
students[] : Student
im Klassendiagramm zeigt an, dass es sich um eine Liste (Array) handelt.
Initialisieren Sie das Attribut als leere Liste.
add_student
- Fügt einen Studenten in die Liste ein.
- Beachten Sie, dass gemäss Klassendiagramm max. 20 Studenten möglich sind. Das müssen Sie beim Zufügen von Studenten umsetzen.
- Beim Versuch mehr als 20 Studenten einzufügen, soll die Methode einen
OverflowError
werfen.
count_student
- Gibt die Anzahl Studenten zurück.
take_student(index)
- Liefert den Studenten beim angegebenen Index.
- Bei einem ungültigen Index soll ein
IndexError
ausgelöst werden.
show_student_list
- Diese Methode liefert eine Liste aller Studenten an. Die Ausgabe könnte wie folgt aussehen:
Max Pia Cem
show_student_report(name)
- Diese Methode liefert das Zeugnis für einen Studenten mit allen Fächern und dem Notenschnitt an. Die Ausgabe könnte wie folgt aussehen:
...
Student
Konstruktor
- Beachten Sie die Parameter und Defaultwerte.
show_report
- Diese Methode liefert das Zeugnis dieses Studenten mit allen Fächern und dem Notenschnitt.
Die Ausgabe könnte wie folgt aussehen:
...
StudentReport
Konstruktor
- Die Schreibweise
subjects[] : Subject
im Klassendiagramm zeigt an, dass es sich um eine Liste (Array) handelt.
Initialisieren Sie das Attribut als leere Liste.
add_subject
- Beachten Sie, dass gemäss Klassendiagramm max. 3 Fächer möglich sind.
- Beim Versuch mehr als 3 Fächer (
Subject
) einzufügen, soll die Methode einenOverflowError
werfen.
take_subject
- Liefert das Fach (
Subject
) beim angegebenen Index. - Bei einem ungültigen Index soll ein
IndexError
ausgelöst werden.
show_overview
- Diese Methode liefert ein Zeugnis mit allen Fächern und dem entsprechenden Notenschnitt. Eine mögliche Ausgabe kann wie folgt aussehen:
...
show_details
- Diese Methode liefert alle Fächern mit den einzelnen Noten. Eine mögliche Ausgabe kann wie folgt aussehen:
...
Subject
Konstruktor
Die Schreibweise grades[] : Grade
im Klassendiagramm zeigt an, dass es sich um eine Liste (Array) handelt.
Initialisieren Sie das Attribut als leere Liste.
add_grade
- Beachten Sie, dass gemäss Klassendiagramm max. 4 Noten möglich sind. Das müssen Sie beim Zufügen von Noten (
Grade
-Objekte) umsetzen. - Beim Versuch mehr als 4 Noten einzufügen, soll die Methode einen
OverflowError
werfen. - Die untere Grenze von 2 Noten müssen Sie (noch) nicht beachten.
take_grade
- Liefert die Note (
Grade
) beim angegebenen Index. - Bei einem ungültigen Index soll ein
IndexError
ausgelöst werden.
calc_average
- Die Methode berechnet den Notendurchschnitt aus allen
Grade
-Objekten in der Liste. - Falls keine
Grade
-Objekte in der Liste vorhanden sind, wird der Wert0.00
zurück gegeben.
Unit tests
- Testen Sie die Klasse
Subject
mit den Testfällen intest_subject.py
Grade
Die Klasse Grade
wird als @dataclass
realisiert.
Konstruktor
- Initialisieren Sie die Werte
value
unddate
gemäss Klassendiagramm. - Achten Sie auf die Zusicherung für den Wert von
value
. Diese nehmen Sie impost_init
vor.
date.setter
Diese Methode ist bereits vorgegeben.
- Diese Methode schreibt das Attribut
self._date
. - Je nach Art des Inputs wird dieser unterschiedlich verarbeitet:
DateTime
⇒ direkt speichernString
⇒ Umwandeln inDateTime
- Alles andere ⇒ Der aktuelle Zeitstempel wird gespeichert.
main
In der main
-Methode erzeugen Sie die verschiedenen Objekte und zeigen die Zeugnisse an.
- Erzeugen Sie die Objekte in der Reihenfolge, wie sie auch für die Zuweisung in den Konstruktoren nötig sind. Wenn Sie unsicher sind, skizzieren Sie sich den Ablauf des Programms als Sequenzdiagramm auf.
Ausgabe
Das Programm liefert
- eine Liste der Studenten
- pro Student das Zeugnis (Report) mit dem Notenschnitt
- für einen Studenten alle Einzelnoten. Sie können hier frei wählen, für wen die Noten ausgegeben werden.
Dauer
4 - 6 Stunden
Abgabe
Mittels Push ins GitHub Repository
⇒ GitHub Repo für externe Besucher
GitHub Repository https://github.com/templates-python/m319-lu10-a02-reader-module
Lernende am BZZ müssen den Link zum GitHub Classroom Assignment verwenden