Skip to main content

Attendance API Overview

Summary​

The API is implemented with ASP.NET Core minimal API route groups and directly injected application services.

Audience​

Frontend and backend developers, QA engineers, architects, support engineers, and implementation partners.

Overview​

Direct Attendance and Time Office groups use ApiResponse<T> envelopes. Compatibility groups preserve bare monolith-shaped request and response bodies. Internal foundation discovery uses plain anonymous responses. Commands invoke scoped application services, domain calculation or mutation, audit/outbox coordination, and unit-of-work persistence. Queries use tenant-filtered read services and DTO mappings.

Bearer authentication, tenant/caller context, and correlation are composed at runtime. Per-route authorization metadata is not consistently declared, so end-to-end enforcement must be verified for the approved deployment. Swagger/OpenAPI is generated at runtime. No API-versioning registration or versioned URL segment is present. Gateway cutover allows monolith coexistence without changing compatibility client routes.

Internal discovery​

MethodRoutePurposeResponseSuccessMaturity
GET/api/attendance-domain/Bounded-context capability discoveryPlain foundation object200Internal/Foundation
GET/api/attendance-domain/policiesLists declared policy identifiersPlain string array200Internal/Foundation

Both operations have no request body or tenant parameter. Authentication and authorization requirements are Requires confirmation. Example: GET /api/attendance-domain/ returns a 200 discovery object; framework-level error response shape is unspecified. These operations produce no audit or attendance events.

Source References​

  • microservices/src/attendance-service/Program.cs
  • microservices/src/attendance-service/Api/AttendanceDirectEndpoints.cs
  • microservices/src/attendance-service/Api/AttendanceCompatibilityEndpoints.cs
  • microservices/src/attendance-service/Api/AttendanceShiftPolicyEndpoints.cs
  • microservices/src/attendance-service/Api/ShiftPolicyCompatEndpoints.cs
  • microservices/src/attendance-service/Application/Common/Cqrs.cs

See Also​

Keywords​

  • Attendance API
  • Attendance API Overview

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly