Setting Override Schema

Dotted lowercase key, e.g. "working_time.weekly_hours", "approval.budget_limit_eur", "hr.required_documents". The catalog of well-known keys is documented in ADR 0098.

Scope this override applies to. The settings-resolver tries USER → POSITION → OU-chain → TENANT and returns the first non-null hit.

UUID of the scoped entity. Null only when scope=TENANT (the row applies to the whole tenant).

Effective value when this override wins resolver evaluation.

Effective from this date (inclusive). Null = since-forever. Useful for working-time changes that take effect on a specific date.

Effective until this date (inclusive). Null = open-ended.

When true (e.g. working-time changes at TENANT/ORG_UNIT scope requiring Betriebsrat approval), the override only applies once approvalState=APPROVED.

Workflow state. Resolver only honours overrides with state=APPROVED. DRAFT rows are visible to admins but do not affect resolution.

Free-text justification for the override (audit trail / Betriebsrat-Vorlage).