Skip to main content

Workforce Scheduling Technical Documentation

Audience

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

Overview

This page records source-verified technical behavior and boundaries for the workforce-scheduling capability.

Summary

Workforce scheduling is implemented as the shift-policy slice of the Attendance Service. The canonical model covers shifts, effective-dated employee assignments, weekly-off rules, and attendance policies. It is Transitional: a direct service surface coexists with a legacy-shaped compatibility surface and gateway-controlled ownership.

Technical scope

This set documents verified code structure and behavior. It does not define API contracts, deployment instructions, infrastructure topology, or production operating procedures.

Documentation map

Start with architecture, runtime composition, project structure, and layer dependencies. Continue through the domain model, shift, assignment, and effective-date resolution.

Integration pages cover attendance, leave, payroll, and holidays and weekly offs. Engineering references cover the application layer, commands, queries, validation, repositories, persistence, security, tenant isolation, observability, compatibility, testing, limitations, and source map.

Requires confirmation

Production authorization enforcement, service objectives, operational dashboards, assignment-edit lifecycle, scheduling ownership outside individual assignments, and compatibility retirement criteria require confirmation.

Source References

  • microservices/src/attendance-service/Program.cs
  • microservices/src/attendance-service/attendance-service.csproj
  • microservices/src/attendance-service/Domain/TimeOffice/Shift.cs
  • microservices/src/attendance-service/Application/Services/AttendancePolicyResolver.cs

See Also

Keywords

  • Workforce scheduling
  • Shift policy
  • Attendance integration

Revision Information

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