Skip to main content

API Validation

Audience​

Developers, QA engineers, support engineers, security engineers, solution architects, and implementation partners.

Reference Content​

This page records source-verified Workforce Scheduling API behavior and boundaries.

Summary​

Validation is implemented procedurally rather than through a dedicated validator framework or DTO attributes.

Request validation​

Route constraints require integer identifiers where declared. Query values use framework conversion. Shift times accept specific culture-independent hour/minute formats with optional seconds. Weekdays accept a supported name or numeric representation.

Business validation​

Commands require tenant context; shift and policy names are checked for active duplicates; shift deletion checks active assignments; assignment creation verifies an active shift and rejects overlapping active ranges; weekly-off updates reject missing and duplicate day entries.

Domain validation​

Shifts enforce tenant, name, unequal boundaries, grace, standard-hours, and overtime bounds. Policies enforce name, hour thresholds, grace, ordering relationships, active-default rules, and unique rule keys. Assignments enforce positive references and ordered inclusive dates.

Persistence validation​

Storage enforces one tenant default policy and unique tenant weekday rules. It does not enforce assignment-range exclusion or case-insensitive active shift-name uniqueness.

Missing validation​

Positive path identifiers are not uniformly checked on read/update/delete routes before repository access. Probe-hour bounds are not explicitly validated at the endpoint. No body-size, concurrency-token, idempotency-key, or declarative model-validation behavior was found.

Source References​

  • microservices/src/attendance-service/Application/Services/ShiftPolicyCommands.cs
  • microservices/src/attendance-service/Application/TimeOffice/ShiftPolicyMappings.cs
  • microservices/src/attendance-service/Domain/TimeOffice/Shift.cs
  • microservices/src/attendance-service/Domain/TimeOffice/AttendancePolicy.cs
  • microservices/src/attendance-service/Domain/TimeOffice/EmployeeShiftAssignment.cs

See Also​

Keywords​

  • Workforce Scheduling API
  • Shift endpoints
  • Attendance policy API

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20