Hinatadocs

Organisation

In Hinata gibt es drei Rollen für Aufgaben, die über einzelne Projekte hinausgehen. Administratoren betreiben die Plattform. Organisationsadmins kümmern sich um Arbeitszeit, Abwesenheiten und Abrechnung der ganzen Organisation. Moderierende prüfen gemeldete Inhalte und entscheiden über sie. Die drei Rollen sind unabhängig voneinander. Eine Person kann eine davon haben, mehrere oder keine.

Drei Rollen

RolleWofür sie da istWo sie arbeitet
Administrator (ADMIN)Konten, Anmeldung und SSO, Servereinstellungen, E-Mail, Git und das Audit-ProtokollAdminbereich
Organisationsadmin (ORG_ADMIN)Arbeitszeit mit erweiterter Zeiterfassung, Stundenzettel-Freigaben, Abwesenheiten, Feiertagskalender, Zeit-Tags, Ausnahmen vom Sperrdatum, Abrechnung und der Standard für relative FristenSeite Organisation in der App
Moderation (MODERATOR)Gemeldete Inhalte und Personen prüfen und über sie entscheiden, mit einer Begründung an alle BeteiligtenSeite Moderation in der App, siehe Moderation

Alle Rollen vergibst du unter Adminbereich → Benutzer. Organisationsadmins und Moderierende haben keinen Zugang zum Adminbereich.

Regeln für die Rolle Organisationsadmin

  • Als Administrator kannst du dich nicht selbst zum Organisationsadmin machen. Das muss ein anderer Administrator tun. Diese Regel sorgt für Nachvollziehbarkeit, sie ist keine harte Sperre: Wer ein zweites Administratorkonto hat, kann sich die Rolle darüber trotzdem geben. Deshalb wird jede Vergabe im Audit-Protokoll festgehalten, und alle Organisationsadmins bekommen eine Benachrichtigung.
  • Der letzte Organisationsadmin lässt sich nicht entfernen, deaktivieren oder löschen. Ernenne zuerst eine andere Person.
  • Kommt jemand zur Rolle dazu oder gibt sie ab, bekommen alle Organisationsadmins eine Benachrichtigung.
  • Jede Änderung an den Rollen Admin und Organisationsadmin landet im Audit-Protokoll. Das lässt sich nicht abschalten.

Regeln für die Rolle Moderation

  • Niemand gibt sich die Rolle selbst, wie beim Organisationsadmin. Jede Vergabe steht im Audit-Protokoll, und alle, die moderieren, bekommen eine Benachrichtigung.
  • Die letzte Person mit der Rolle lässt sich nicht entfernen, deaktivieren oder löschen. Ernenne zuerst eine andere Person.
  • Mindestens zwei sind gut, damit niemand über eine Meldung gegen sich selbst entscheidet.

Keine dieser Rollen öffnet fremde Projekte

Ein Administrator sieht nur Projekte, Teams, Vorgänge, Boards, Seiten der Wissensdatenbank, Suchtreffer und Zeiteinträge, bei denen er selbst Mitglied ist, genau wie alle anderen. Die Plattform zu betreiben heißt nicht, die Arbeit anderer zu lesen. Auch Organisationsadmins sehen Projektinhalte nur über ihre eigene Mitgliedschaft. Zeiteinträge sehen sie dagegen alle, weil Freigaben, Korrekturen und Abrechnung das verlangen. Wie weit das geht, steht unten unter Berichte und Exporte. Moderierende sehen nur, was gemeldet ist, mit dem nötigsten Umfeld.

Die Seite Organisation

Als Organisationsadmin findest du in deinen Einstellungen die Zeile Organisation. Andere Personen sehen sie nicht. Dort liegt alles, was für die ganze Organisation gilt:

  • Zeiterfassung: die erweiterte Zeiterfassung und ihre Richtlinien, etwa Rundung, Sperrdatum, Stundenzettel-Freigaben, Kalender-Import, Datenschutzhinweis und Aufbewahrung. Siehe Datenschutz der Zeiterfassung.
  • Abwesenheiten: die Abwesenheitsverwaltung mit Arten, Ansprüchen und Konten, dazu die Personen, die sie mitführen dürfen.
  • Feiertage: die Feiertagskalender. Ein Kalender folgt einer Region, kommt aus einer Kalenderadresse oder wird von Hand gepflegt. Mehr dazu unter Feiertage.
  • Zeit-Tags, Ausnahmen vom Sperrdatum und für einzelne Personen geöffnete Tage.
  • Abrechnung: Sätze, Kosten und Rechnungen.
  • Zählweise: ob die Organisation in Kalendertagen oder Werktagen rechnet, für neue relative Fristen und als Standard für Benachrichtigungszeiten.
  • Protokoll: die Einträge des Audit-Protokolls zu Arbeitszeit, Stundenzetteln und Abwesenheiten. Administratoren sehen sie nicht. Mehr dazu unter Das Protokoll der Organisation.

Dazu kommen Aufgaben im Alltag: Organisationsadmins entscheiden Stundenzettel und Abwesenheitsanträge, wenn sonst niemand dafür da ist, öffnen gesperrte Tage auf Anfrage und dürfen Einträge für andere importieren.

Feiertage

Jeder Feiertagskalender bekommt seine Tage aus einer von drei Quellen:

  • Region: die gesetzlichen Feiertage eines Landes oder Bundeslandes, etwa Bayern oder Berlin. Der Server kennt die Regeln selbst und braucht dafür keine Verbindung nach außen. Jedes neue Jahr kommt von selbst dazu.
  • Kalenderadresse: ein Feiertagskalender von Google, Apple oder Outlook. Der Server liest auch hier jedes neue Jahr von selbst ein, sobald die Adresse es enthält.
  • Von Hand: du trägst jeden Tag selbst ein.

Der Server füllt jede Nacht und bei jedem Start das laufende und das nächste Jahr, und zwar jedes Jahr nur einmal. Löschst oder änderst du danach einzelne Tage, bleibt das so. Willst du ein Jahr wieder so haben, wie die Quelle es vorgibt, tippst du auf der Karte des Kalenders auf das Symbol zum Wiederherstellen oder Importieren.

Auf einem neuen Server legt die Plattform den ersten Kalender selbst an: Gesetzliche Feiertage für die Region aus den Plattform-Einstellungen, ohne Angabe für das Land der Zeitzone des Servers. Er trägt das Zeichen Vorgabe der Plattform und ist der Standardkalender, solange es noch keinen anderen gibt. Du kannst ihn umbenennen, Tage ändern, weitere Kalender dazulegen oder ihn löschen. Wählst du für ihn eine andere Quelle, gehört er ganz euch und folgt den Plattform-Einstellungen nicht mehr. Ein gelöschter Kalender kommt nicht zurück, nur eine neue Region in den Plattform-Einstellungen legt wieder einen an.

Kalender-Import

Unter Zeiterfassung entscheidet der Schalter Kalender-Import, ob Personen ihre eigenen Kalender abonnieren und Termine in Einträge übernehmen dürfen. Er ist standardmäßig aus und wirkt nur mit erweiterter Zeiterfassung. Solange du nichts wählst, gilt der Wert des Servers, HINATA_TIME_TRACKING_ICS_IMPORT_ENABLED. Wie das für die Personen aussieht, steht unter Erweitertes Time-Tracking.

  • An: Alle finden Kalender-Abos unter Einstellungen → Zeiterfassung. Ein Abo, seine Adresse, seine Termine und seine Fehler sieht nur, wem es gehört. Du siehst weder die Adressen noch die Termine, nur die Einträge, die jemand übernimmt, wie jeden anderen Eintrag.
  • Aus: Die Kalender zeigen keine Termine, nichts wird abgerufen, und der Server beantwortet Anfragen zu Abos, als gäbe es sie nicht. Was Personen gespeichert haben, bleibt, bis sie es löschen oder ihr Konto gelöscht wird, und ist wieder da, wenn du den Import erneut einschaltest.

Der Server braucht dafür HINATA_ICS_SECRET. Ohne ihn kann niemand ein Abo speichern, und die App sagt, dass auf dem Server HINATA_ICS_SECRET gesetzt sein muss. Wende dich an die Person, die den Server betreibt (siehe Konfiguration). Das Anlegen und Entfernen eines Abos steht im Audit-Log, mit dem Host des Kalenders und nie mit seiner Adresse.

Kalendertermine können viel über eine Person verraten. Haltet in der Betriebs- oder Dienstvereinbarung fest, dass der Import freiwillig ist und wie private Termine behandelt werden, siehe Datenschutz der Zeiterfassung.

Krankmeldungen

Unter Abwesenheiten kannst du Personen nennen, die Abwesenheiten mitführen. Hast du solche Personen genannt, sehen nur sie eine Krankheit als Krankheit. Organisationsadmins sehen dann nur, dass jemand abwesend ist, aber nicht, warum. Ist niemand genannt, kümmern sich die Organisationsadmins selbst um die Abwesenheiten und sehen sie vollständig.

Das Protokoll der Organisation

Das Protokoll auf der Seite Organisation zeigt Einträge zu Arbeitszeit, Stundenzetteln und Abwesenheiten. Einträge zu Abwesenheiten, also Anträge, Krankmeldungen und Konten, sieht dort nur, wer die Abwesenheiten führt. Das ist die benannte Abwesenheitsverwaltung oder, solange niemand benannt ist, die Organisationsadmins.

Welche dieser Ereignisse aufgezeichnet werden, legst du als Organisationsadmin für jedes Ereignis einzeln fest (über die API PUT /api/v1/org/settings mit auditEvents). Administratoren können diese Schalter nicht umlegen, und auch der Hauptschalter für das Audit-Protokoll der Plattform bringt diese Einträge nicht zum Schweigen.

Berichte und Exporte

In Zeitberichten, Exporten, gruppierten Übersichten und bei der Freigabe von Stundenzetteln siehst du Stunden, Person und Projektschlüssel für alle. Vorgangstitel, Vorgangsschlüssel, Beschreibungen und Projektnamen siehst du nur bei Projekten, in denen du Mitglied bist, und bei deinen eigenen Einträgen. Die Suche in den Beschreibungen durchsucht nur Einträge, die du lesen darfst.

Standard für relative Fristen

Mit eingeschalteten Projektvorlagen kann eine Frist als Versatz zum Termin des Projekts gelten, etwa „4 Wochen vorher“. Unter Zählweise legst du fest, ob die Organisation in Kalendertagen oder Werktagen rechnet. Das gilt für solche Fristen und zugleich als Standard für die Benachrichtigungszeiten: Bei Werktagen bekommt jede Person ohne eigene Wahl E-Mail und Push nur an Werktagen von 9 bis 17 Uhr, bei Kalendertagen jederzeit. Solange du nichts wählst, gilt der Standard des Servers, also Kalendertage (siehe HINATA_PROJECT_TEMPLATES_DEFAULT_BASIS in der Konfigurationsreferenz).

Jedes Projekt kann davon abweichen: beim Anlegen, beim Kopieren oder später in seinen Einstellungen unter Fristen zählen in.

Die Einstellung wählt nur vor, womit eine neue Frist startet. Bestehende Fristen behalten ihre eigene Zählweise und verschieben sich nicht.

Nach dem Update

Damit nichts stehen bleibt, wird beim Update jeder bestehende Administrator einmalig auch Organisationsadmin. Alles funktioniert also wie vorher. Diese Übergabe steht für jede Person einzeln im Audit-Protokoll, und jede betroffene Person bekommt eine Benachrichtigung. Sollen die Rollen getrennt sein, nimmst du sie danach unter Adminbereich → Benutzer bewusst auseinander.

Mit dem Update auf eine Version mit Moderation wird außerdem jeder bestehende Administrator einmalig auch Moderator, damit Meldungen von Anfang an jemanden erreichen. Auch das steht je Person im Audit-Protokoll, und die Benachrichtigung empfiehlt, die Rolle an andere zu geben.

Bei einer neuen Installation bekommt die erste Person, die der Einrichtungsassistent anlegt, alle drei Rollen.

Wie es weitergeht