Planning

Schichten und Ressourcen

MarktplatzPersonal und ProjekteVersion 0.1.0manifest

Wofür sie gedacht ist ​

Plan shifts for employees from reusable templates. A shift with nobody assigned is an open shift; the workflow runs from open through published to confirmed by the employee.

Was das Paket leistet und was nicht ​

Shifts for employees, with roles and reusable templates. A shift has a day and a start and end in minutes since midnight (0 to 1439; 540 is 09:00). A shift with no employee is an open shift. Workflow: open, published, confirmed by the employee. Needs the Human Resources package.

Modelle ​

planning_role ​

A role a shift is planned for, for example cashier or electrician

Lesegruppe: planning.user. Schreibgruppe: planning.manager.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
nametextnoneneinplanning.userim KlartextRole name
notelongtextnoneneinplanning.userim KlartextWhat the role involves

planning_template ​

A reusable shift pattern to copy into shifts

Lesegruppe: planning.user. Schreibgruppe: planning.manager.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
nametextnoneneinplanning.userim KlartextTemplate name, for example Morning shift
role_idref → planning_rolenoneneinplanning.userim KlartextThe role the template is for
start_minutenumbernoneneinplanning.userim KlartextStart in minutes since midnight (540 is 09:00)
end_minutenumbernoneneinplanning.userim KlartextEnd in minutes since midnight (1020 is 17:00)

planning_shift ​

A slot of work on one day for one role, optionally assigned to an employee

Lesegruppe: planning.user. Schreibgruppe: planning.manager.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
nametextnoneneinplanning.userim KlartextShort title, for example Opening shift
role_idref → planning_rolenoneneinplanning.userim KlartextThe role needed
employee_idref → hr_employeeinternaljaplanning.usermaskiertEmployee the shift is assigned to; empty for an open shift
work_datedatenoneneinplanning.userim KlartextDay of the shift (YYYY-MM-DD)
start_minutenumbernoneneinplanning.userim KlartextStart in minutes since midnight, 0 to 1439 (540 is 09:00)
end_minutenumbernoneneinplanning.userim KlartextEnd in minutes since midnight, 0 to 1439 (1020 is 17:00)
notelongtextnoneneinplanning.userim KlartextInstructions for whoever works the shift
stateselect (open, published, confirmed)noneneinplanning.userim KlartextShift status: open, published, confirmed

Workflows ​

planning_shift ​

AktionBewegtWer sie ausführen darfFreigabe
planning_shift.publishstate: open → publishedplanning.managernein
planning_shift.unpublishstate: published → openplanning.managernein
planning_shift.confirmstate: published → confirmedplanning.managernein

Berechtigungsgruppen ​

Von dieser App verwendete Gruppen:

  • planning.manager
  • planning.user

Freigabeschritte ​

Kein Schritt dieser App braucht eine Freigabe, abgesehen vom Löschen von Datensätzen.

Was Agenten tun können und was nicht ​

Ein Agent kann Datensätze dieser App lesen, durchsuchen, anlegen und aktualisieren sowie Aktionen ausführen, die keine Freigabe brauchen, und zwar innerhalb der Berechtigungsgruppen seines Tokens.

Diese Schritte kann er nur vorschlagen, und eine Person muss sie freigeben: planning_role.delete, planning_template.delete, planning_shift.delete.

Personenbezogene Daten werden als Platzhalter maskiert: planning_shift.employee_id.

Abhängigkeiten ​

  • hr

Installation ​

Installieren Sie sie in der App Customize (Marktplatz) oder über die Kommandozeile:

bash
obop modules install-from planning

Erfordert eine Datenbank und Administratorrechte.

Selbst bauen ​

Der Modulleitfaden zeigt, wie Apps wie diese geschrieben werden