DTO Catalog
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
The module uses 17 scheduling-specific DTOs plus two shared response contracts. Validation below describes where the API or domain validates incoming values; DTO classes themselves use mutable properties without declarative validation attributes.
| DTO | Direction | Purpose | Verified validation | Source |
|---|---|---|---|---|
ShiftSaveRequest | Request | Canonical shift create/update | Time parsing; aggregate name, window, grace, and hour rules | ShiftPolicyDtos.cs |
ShiftDto | Response | Canonical shift projection | Output projection only | ShiftPolicyDtos.cs |
WeeklyOffUpdateRequest | Request | Container for supplied day changes | Requires at least one day | ShiftPolicyDtos.cs |
WeeklyOffDayRequest | Request | Weekday and active state | Day parsing and duplicate rejection | ShiftPolicyDtos.cs |
WeeklyOffRuleDto | Response | Stored weekday rule | Output projection only | ShiftPolicyDtos.cs |
AttendancePolicySaveRequest | Request | Policy create/update | Command and aggregate invariants | ShiftPolicyDtos.cs |
AttendancePolicyRuleRequest | Request | Policy rule input | Aggregate rule validation and duplicate-key rejection | ShiftPolicyDtos.cs |
AttendancePolicyDto | Response | Policy projection | Output projection only | ShiftPolicyDtos.cs |
AttendancePolicyRuleDto | Response | Ordered policy-rule projection | Output projection only | ShiftPolicyDtos.cs |
EmployeeShiftAssignmentCreateRequest | Request | Effective-dated assignment | Active shift, date order, overlap | ShiftPolicyDtos.cs |
EmployeeShiftAssignmentDto | Response | Assignment with optional shift name | Output projection only | ShiftPolicyDtos.cs |
EffectiveAttendancePolicyDto | Response | Resolved calculation values and provenance | Resolver behavior; optional probe calculation | ShiftPolicyDtos.cs |
AttendanceAuditLogDto | Response | Configuration audit projection | Query filtering and bounded count | ShiftPolicyDtos.cs |
AttendanceTimelineDto | Response | Configuration timeline projection | Query filtering and bounded count | ShiftPolicyDtos.cs |
MonolithShiftRequest | Request | Legacy-shaped shift write | Compatibility parser and aggregate validation | ShiftPolicyCompatContracts.cs |
MonolithShiftDto | Response | Legacy-shaped shift read | Output mapping only | ShiftPolicyCompatContracts.cs |
MonolithWeeklyOffDto | Response | Legacy active weekly-off row | Output mapping only | ShiftPolicyCompatContracts.cs |
ApiResponse<T> | Shared response | Native success/error envelope | Factory methods shape success and failure | ApiResponse.cs |
ServiceInfoResponse | Shared response | Service metadata payload | Framework-generated values | ServiceInfoResponse.cs |
Non-DTO bodies
Compatibility weekly-off update binds a bare string list rather than a named request DTO. Compatibility delete returns plain text. The health response is provided by the framework rather than a module DTO.
Serialization
Canonical shift times are emitted at minute precision. Compatibility DTOs preserve legacy camel-cased JSON through the service serializer configuration. No schema version field was found.
Source References
microservices/src/attendance-service/Application/TimeOffice/ShiftPolicyDtos.csmicroservices/src/attendance-service/Application/Compatibility/ShiftPolicyCompatContracts.csmicroservices/src/contracts/Common/ApiResponse.csmicroservices/src/contracts/Common/ServiceInfoResponse.cs
Related Articles
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