Software Challenge : Neue Saison anlegen

This page last changed on Mar 18, 2015 by svk.

Wenn eine neue Saison der Software Challenge anliegt, wird generell ein neues Spiel sowie eine darauf angepasste Saisondefinition benötigt.

Benötigt werden sowohl der SimpleClient (als jar file) sowie das Plugin mit den entsprechenden Bibliotheken, alles als jar file.

Zu erstellende Definitionsdateien

  • Im Verzeichnis /config/games eine Datei [spielname].rb (z.B. cartagena.rb). In dieser Datei wird das Spiel sowie die Punktewertungen für das Spiel im Wettkampf festgelegt. Für Details siehe Neues Spiel im Wetkampfsystem einrichten.
  • Im Verzeichnis /config/seasons eine Datei [jahreszahl].rb (z.B. 2013.rb). In dieser Datei wird die Wettkampfaufteilung festgelegt.

  • In /public/clients/ ist eine Datei [spielname].zip (z.B. cartagena.zip) zu erstellen (auf diese muss in [spielname].rb verwiesen werden) welche den SimpleClient enthält (mit den Namen [spielname]_player.jar) sowie das plugin (lib/[spielname]-plugin.jar). Falls der neue Client zum Zeitpunkt der Saisonerstellung noch nicht fertig ist (was eigentlich immer der Fall ist, da wir die neue Saison schon sehr früh erstellen um eine Voranmeldung zu ermöglichen), kann man auch ein Archiv ohne Inhalt nehmen, welches dem Namensschema aus dem vorherigen Punkt folgt.

Den Inhalt der Dateien kann man recht gut aus den "alten" Jahren kopieren, man muss in der Regel nur kleine Änderungen vornehmen. Unter anderem sind die Jahreszahlen und der Spielname zu ersetzten. In der [jahreszahl].rb kann man die IDs der teilnehmenden Teams auf die entsprechenden Gruppen verteilen. Dies kann aber erst geschehen wenn sich alle Teams (verbindlich) angemeldet haben. Alternativ kann man einfach eintragen, dass die Zuordnung manuell geschehen soll (mit select_contestants :manually).

In der [spielname].rb ist vor allem die Sortierungsreihenfolge für die Tabelle anzugeben.

Umfragen

Diese finden sich in socha-webapp/surveys/ . Da sind generell auch nur ein paar (offensichtliche) Sachen auszutauschen. Bitte beachten:  Umfragen. Die Umfragedateien muessen erstellt werden und der Rake-Task zum hinzufuegen der Umfragen muss ausgefuehrt werden bevor die neue Sasion im Wettkampfsystem angelegt wird.

Startseite

Wenn die Voranmeldung für die neue Saison schon gestartet werden soll, während die alte noch läuft, dann empfielt es sich, eine Verlinkung auf der Hauptseite der laufenden Saison einzufügen.

Es wird ausserdem eine spezifische Startseite für die Saison benötigt. Die Datei muss den namen p_[jahreszahl].erb haben und in /app/views/seasons/pages liegen. jahreszahl ist diejenige, welcher beim anlegen der Saison für die Definitionsdatei (siehe oben) angegeben wurde.

Für die Ansicht in der Voranmeldung muss man in den locals (/config/locales/) in de.yml im Parameter new_school_note_step_3 das Schuljahr anpassen.