API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · shift_fairness_records

Shift Fairness Record Schema

Schema-ID
shift_fairness_record
Collection
shift_fairness_records
Permissions
  • Lesenshift_fairness_record_view
  • Anlegenshift_fairness_record_create
  • Ändernshift_fairness_record_edit
  • Löschenshift_fairness_record_delete

Felder

Shift Fairness Record Schema

shift_fairness_records4 Permissions

Per-period fairness tracking for an employee (Fairness-Ledger)

schedulePeriodIduuiderforderlich
employeeIduuiderforderlich
userIduuiderforderlich
orgUnitIduuiderforderlich
periodStartDatedateoptional
periodEndDatedateoptional
schedulePeriodNamestringoptional
max 200 Zeichennullable
generatedByuuidoptional
nullable
totalShiftsAssignednumberoptional
≥ 0Default: 0
desirableShiftCountnumberoptional
≥ 0Default: 0
undesirableShiftCountnumberoptional
≥ 0Default: 0
neutralShiftCountnumberoptional
≥ 0Default: 0
weekendShiftCountnumberoptional
≥ 0Default: 0
holidayShiftCountnumberoptional
≥ 0Default: 0
nightShiftCountnumberoptional
≥ 0Default: 0
onCallShiftCountnumberoptional
≥ 0Default: 0
totalScheduledHoursnumberoptional
≥ 0Default: 0
contractualHoursnumberoptional
≥ 0Default: 0
overtimeHoursnumberoptional

Positive = overtime, negative = undertime

Default: 0
preferenceScorenumberoptional

How well preferences were satisfied (0-100)

0 – 100nullable
fairnessScorenumberoptional

Composite fairness score (0-100, higher = more fairly treated)

0 – 100nullable
neverViolationCountnumberoptional
≥ 0Default: 0
colleaguePreferenceSatisfiednumberoptional
≥ 0Default: 0
colleaguePreferenceViolatednumberoptional
≥ 0Default: 0
qualificationUtilizationnumberoptional

How often qualified for assigned shifts (0-100)

0 – 100nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/shift_fairness_records — Liste, paginiert + filterbar
  • GET /api/v1/shift_fairness_records/<id> — Einzelne Entity
  • POST /api/v1/shift_fairness_records — Anlegen
  • PATCH /api/v1/shift_fairness_records/<id> — Teil-Update
  • DELETE /api/v1/shift_fairness_records/<id> — Soft-Delete
  • GET /api/v1/shift_fairness_records/<id>/timeline — Audit + Aktivitäten

Suche