Glossar

> Hier sind wichtige Begriffe und Konzepte der Projekt-Einreichung und des Jurytools aufgeführt.

> Diese Informationen sind für die Redakteure, Entwickler und First-Level-Support Benutzer.

> Hinter einigen Begriffen steht in Klammern der Name der jeweiligen Datenbanktabelle, in der das Objekt gespeichert wird.

> Aus Gründen der Lesbarkeit werden dort die Datenbank-Prefixe tx_lnsaward_domain_model und tx_lnsworkflow_domain_model weggelassen.

Admin (fe_users)

Auch „Head-Judge“ genannt. Admin-Benutzer haben separate Frontend-Ansichten, die erweiterte Informationen zu den Projekten und Projekt-Kategorien preisgeben. Zum Beispiel sehen Admins die Projekt-Bewertungen aller Juroren. Ebenso dürfen Admins den Status der Projekte ändern. Sie sorgen damit dafür, dass die Projekte durch den wechsel des Projektstatus durch die Phasen des Awards laufen. Admins sind in der Lage, die Jurygruppen und Juroren im TYPO3 Backend zu verwalten. Ebenso dürfen Admins Reports der Bewertungen exportieren. Siehe Admin-Benutzergruppe.

Admin-Benutzergruppe (fe_groups)

Pro Award gibt es eine Admin-Benutzergruppe. Beispiel: „GDA Head Judge / Admin“. Diese Gruppe enthält alle Admin-Benutzer, die für die Verwaltung des Awards und dessen Projekte zuständig sind. Es gibt Admin-Benutzer beim technischen Dienstleister und beim Kunden, der die Webseite betreibt. In der Admin-Benutzergrupope müssen alle Unter- und Zusatz-Kategorien zugewiesen werden!

Auswertung (evaluation)

Eine Auswertung ist die Punkt-Bewertung (1-10) einer einzelnen Frage eines Bewertungskriteriums durch einen Juror für ein Projekt. Die Auswertung wird im Frontend durchgeführt. Die Auswertung wird in der Bewertung gespeichert.

Auszeichnung (distinction)

Eine Auszeichnung die für ein Projekt vergeben wurde in einer bestimmten Unterkategorie oder Zusatzkategorie. Zum Beispiel „Special Mention“ für das Projekt „Marken Neupositionierung Schaffrath schafft“ in der Unterkategorie „Excellent Communications Design und Brand Identity“. Diese Zuordnung wird im Projekt gespeichert. Nicht zu verwechseln mit Projekt-Auszeichnung. Wenn eine Auszeichnung im Backend ausgeblendet (hidden) ist, ist das gleichzusetzen mit "nicht vergeben".

Award (award)

Ein Award ist im TYPO3 technischen Sinn ein einzelner Award aus einem bestimmten Jahr. Zum Beispiel ist der „GDA 2024“ ein Award. Der „GDA 2025“ oder der „German Brand Award 2021“ sind weitere Awards. Ein Award ist in mehreren Phasen eingeteilt. Diese können über das TYPO3 Backend bestimmt werden.

Backend

Das TYPO3 Backend ist die Administrations-Oberfläche des TYPO3-Systems. Hier werden die Seiten, Inhaltselemente und die Daten des Jurytools gepflegt und verwaltet. Das Backend ist nur für Benutzer mit einem Backend-Zugang zugänglich. Diese Zugänge sind nur für den technischen Dienstleister sowie Redakteuren und dem Betreiber der Webseite üblich. Der Login des TYPO3-Backends ist immer unter der URL /typo3 erreichbar. Juroren haben keinen Zugriff auf das Backend. Sie nutzen das Frontend.

Backend-Benutzer

Ein Backend-Benutzer ist ein Benutzer, der Zugriff auf das TYPO3 Backend hat. Backend-Benutzer können Seiten, Inhaltselemente und die Daten des Jurytools pflegen. Backend-Benutzer sind in der Regel Mitarbeiter des technischen Dienstleisters oder des Kunden, der die Webseite betreibt.

Bewertung (summary)

In einer Bewertung wird ein Projekt von einem Juror für eine bestimmte Unterkategorie oder Zusatzkategorie bewertet. Die Bewertung enthält zu jedem Bewertungskriterium die Auswertung(Evaluation) mit den Bewertungspunkten ODER eine Enthaltung. Der Juror bewertet die Projekte im Frontend. Die Bewertungen aller Juroren kann auch durch den Admin im Frontend eingesehen werden (Im Backend sowieso).

Bewertungskriterien (criteria)

Bewertungskriterien sind die Kriterien, nach denen die Einträge in einer Kategorie durch die Juror:innen bewertet werden. Sie sind in einer Hauptkategorie definiert. Zusatzkategorien haben eigene Bewertungskriterien. Unterkategorien erben die Bewertungskriterien der Hauptkategorie.

Einreichung (project)

Siehe Projekt.

Enthaltung (abstention)

Ein Juror kann sich bei der Bewertung eines Projektes enthalten (abstention). Das bedeutet, dass der Juror keine Bewertung abgibt. Die Enthaltung wird in der Bewertung (summary) gespeichert. Die Auswertungen in dieser Bewertung werden im Falle einer Enthaltung komplett ignoriert.

Frontend

Das TYPO3-Frontend ist die Benutzeroberfläche, die für die Besucher der Website sichtbar ist. Hier können Kunden ihre Projekte einreichen und die Juror:innen die Projekte bewerten. Das Frontend ist für alle Besucher der Website zugänglich. Bestimmte Seiten des Frontends können aber auch durch einen Login geschützt sein. In diesem Fall spricht man von einem Frontend-Login. Zum Beispiel sind die Seiten für die Einreichung eines Projektes oder für die Jury Projekt-Bewertung durch Logins geschützt. Die Frontend-URL ist die normale URL der Website. Siehe auch Backend.

Hauptkategorie (sys_category)

Oberste Kategorie-Ebene unterhalb des jeweiligen Awards. Über die Hauptkategorie werden die Bewertungskriterien definiert. Des Weiteren gibt es Unterkategorien, welche die Bewertungskriterien der Hauptkategorie erben. Zusatz-Kategorien sind spezielle Unterkategorien, die eigene Bewertungskriterien haben. Jedes Projekt benötigt exakt eine Hauptkategorie.

Head-Judge (fe_users)

Siehe Admin.

Juror:in (fe_users)

Eine Juror:in darf bestimmte Projekte bewerten. Über Jurygruppen wird definiert, welche Projekte Juror:innen bewerten können. Der/Die Juror:in ist Mitglied einer oder mehrerer Jurygruppen. Technisch gesehen ein TYPO3-Core-Frontend-Benutzer.

Jurygruppe (fe_groups)

Eine Jurygruppe ist eine Gruppe von Juror:innen, die gemeinsam die Projekte einer Unterkategorie bewerten können. Siehe Teiljury. Technisch ist das eine TYPO3-Core-Frontend-Benutzergruppe.

Kategorien (sys_category)

Hauptkategorien wie „Excellent Architecture“, Unterkategorien wie „Urban Space and Infrastructure“ und Zusatzkategorien. Siehe auch im Bereich Kategorie. Wir nutzen die TYPO3-Core-System-Kategorien. Jedes Project benötigt exakt eine Hauptkategorie und eine oder mehrere Unterkategorien und/oder Zusatzkategorien unterhalb der gewählten Hauptkatagorie.

Phase (phase)

Eine Phase fasst mehrere Projekt-Status für einen Award zusammen und ist nur für einen bestimmten Zeitraum gültig. Damit können bestimmte Aktionen innerhalb einer Phase durchgeführt werden. Zum Beispiel kann eine Phase „Jurierung“ sein, in der die Juroren die Projekte bewerten können. Die Phase „Einreichung“ dient der Einreichung der Projekte durch die Kunden. Phasen können den Awards zugeordnet werden und sind dann für die Projekte dieses Awards für einen Zeitraum aktiv. Phasen und Status, sowie die Zuordnung der Phasen zu den Awards, können im TYPO3 Backend frei konfiguriert werden.

Projekt (project)

Ein Projekt (oder „Einreichung“) kann in einer Kategorie eines Awards bewertet werden. Das Projekt muss dazu immer einer Hauptkategorie zugeordnet werden und kann (muss aber nicht) einer Zusatzkategorie zugeordnet sein. Jedes Projekt enthält auch Zuweisungen zu Unterkategorien. Ein Projekt hat einen Status der zum Beispiel „eingereicht“, „In Jurierung“ lauten kann. Projekte werden von Juror:innen bewertet und von Admin-Usern kann der Status geändert werden. Ein Projekt kann auch eine Auszeichnung erhalten. Projekte können im Frontend eingereicht werden, wenn das "Einreichungs-Tool" fertiggestellt wurde. Zurzeit (8/2024) werden Projekte nach Absprache aus Salesforce importiert.

Projekt Auszeichnung (award-distinction)

Eine Auszeichnung die für einen Award zur Verfügung steht. Zum Beispiel „Gold“ für den GDA. Die Zuordnung zum Award erfolgt zum einen über den Storage im TYPO3-Backend: Die Projekt-Auszeichnung muss im gleichen Storage liegen wie der Award. Das kann im TYPO3 Backend konfiguriert werden. Zum zweiten findet die Zuordnung über den Award statt. Die im Awrad zugeordnete Award-Distinction kann vom Admin-User in der Ansicht "Top3" manuell zugewiesen und wieder entfernt werden. Siehe Auszeichnung.

Pseudostatus

Der Pseudostatus ist technischer Natur und wird für spezielle Aktionen und Abläufe verwendet. Er wird nicht im TYPO3 Backend konfiguriert. Redakteure und Admins kommen damit nicht in Berührung. Ein Projekt nimmt den Pseudostatus niemals an wie bei einem Status. Es gibt somit niemals Projekte die im Pseudostatus „_save“ sind. Satt dessen nutzen Pseudostatus die zugrunde liegende Technik der StateMachine aus der Extension lns_workflow.

Vorhandene Pseudostatus sind:

_save (Juroren: Speichern der Bewertung. Juror:innen können die Bewertung später fortsetzen)
_finish (Juroren: Für Juroren zum Abschließen der Bewertung einer (Zusatz-)Kategorie)
_togglewinner (Admin: Ein Projekt als Gewinner markieren)
_movePresentationPlace (Admin: Änderung der Presentation Place Number per Drag & Drop aus dem Frontend)

Die beiden Pseudostatus _save und _finish können nur von Juroren verwendet werden. Admins haben darauf keine Berechtigung. Der Pseudostatus _togglewinner kann nur von Admins verwendet werden.

Redakteur (be_users)

Ein Redakteur verwaltet die Inhalte einer TYPO3 Webseite. Er hat Zugriff auf das TYPO3 Backend und kann dort Seiten, Inhaltselemente und die Daten des Jurytools pflegen. Der Redakteur hat nicht automatisch Zugriff auf alle Bereiche das Frontend. Der Redakteur ist in der Regel ein Mitarbeiter des Kunden, der die Webseite betreibt.

Report

Admin Benutzer können über das Frontend Reports der Jury-Bewertungen erstellen. Diese Reports werden als CSV-Datei exportiert. Ein Report enthält die Bewertungen aller Juroren für alle Projekte eines Awards. Dazu wird ein TYPO3-Plugin verwendet, das im Backend auf eine beliebige Seite platziert werden kann.

Sonderkategorie (sys_category)

Siehe Zusatzkategorie.

Status (state)

Ein Status ist der aktuelle Zustand eines Projektes. Zum Beispiel kann ein Projekt den Status „eingereicht“ haben. Ein Projekt kann auch den Status „In Jurierung“ haben. Ein Status kann auch „abgelehnt“ sein. Nur Admin Benutzer können den Status eines Projektes ändern (Ausnahmen: Pseudostatus). Ob eine Änderung möglich ist, hängt von der Phase und den erlaubten Status-Übergängen ab. Jeder Status muss einen Kurznamen haben. Um die Dinge so einfach wie möglich zu halten, haben einige dieser Kurznamen Sonderbedeutung. Status und Phasen können im TYPO3 Backend frei konfiguriert werden.

Status-Kurzname (state)

Jeder Status muss mit einem Kurznamen versehen werden. Dieser wird an einigen Stellen statt einer Id verwendet, da die Bedeutung des Status damit für Menschen lesbar und sprechend wird. Im Gegensatz zu einer Id die nur aus Ziffern besteht. Ein Kurzname ist ein eindeutiger Name, der nur aus Kleinbuchstaben und Unterstrichen bestehen darf. Zum Beispiel „evaluation“. Der Kurzname muss im TYPO3 Backend im Status-Datensatz eingetragen werden. Einige Kurznamen haben eine Sonderbedeutung oder lösen Aktionen im Frontend aus. Siehe Pseudostatus.

Status-Kurznamen mit Sonderbedeutung

evaluation (Juroren mit entsprechender Berechtigung können ihre Bewertung abgeben. Ob das angeboten wird, ist von weiteren Faktoren abhängig. Neben dem Status noch von der Phase und den Kategorie-Berechtigungen des Jurors/der Jurorin abhängig.)

Status-Übergang (state)

Ein Status-Übergang ist eine Änderung des Status eines Projektes. Nur Admin-Benutzer haben die Berechtigung dazu. Ein Status-Übergang kann nur durchgeführt werden, wenn der Ziel-Status in einer aktiven Phase ist und die Status-Übergangsregeln dies erlauben.

Status-Übergangsregeln (state)

In jedem Status kann definiert werden, welche Status-Übergänge erlaubt sind. Zum Beispiel kann ein Projekt nur in den Status „In Jurierung“ wechseln, wenn es zuvor den Status „eingereicht“ hat.Es können auch mehrere Status-Übergänge definiert werden. So kann ein Projekt beispielsweise von „eingereicht“ in den Status „abgelehnt“ oder „zugelassen“ wechseln. Die Status-Übergangsregeln können im TYPO3 Backend komplett frei konfiguriert werden.

Teiljury (fe_groups)

Eine Teiljury ist eine Gruppe Juroren, die eine Unterkategorien und/oder Zusatzkategorie bewerten darf. Ein einzelner Juror kann Mitglied in mehreren Teiljurys sein.

Unterkategorie (sys_category)

Eine Unterkategorie ist eine Kategorie, die einer Hauptkategorie untergeordnet ist. Eine Unterkategorie erbt die Bewertungskriterien der Hauptkategorie. Unterkategorien vom Typ Zusatzkategorie haben eigene Bewertungskriterien. Einem Projekt muss mindestens einer Unterkategorie ODER Zusatzkategorie zugeordnet sein. Es können mehrere Unterkategorien und/oder Zusatzkategorien zugewiesen werden. Diese müssen sich alle unterhalb der gewählten Hauptkategorie befinden. Neue Unterkategorien müssen in der jeweiligen Admin-Benutzergruppe aktiviert werden.

Zusatzkategorie (sys_category)

Auch „Sonderkategorie“ genannt, ist eine Unterkategorie mit eigenen Bewertungskriterien. Eine Zusatzkategorie wird im Frontend meist visuell hervorgehoben. Im Backend sind diese mit einem ❇️ markiert. Einem Projekt kann eine Zusatzkategorie zurgeordnet werden. Die gewählte Zusatzkatagorie muss sich unterhalb der gewählten Hauptkategorie befinden. Neue Zusatzkategorien müssen in der jeweiligen Admin-Benutzergruppe aktiviert werden.