Health and API Discovery
Summary
Recruitment maps framework process health, shared service information, and tenant-scoped Recruitment count diagnostics. Swagger generation and UI middleware are registered. No dependency-readiness health model or curated lifecycle OpenAPI document was found.
Audience
Developers, QA, support, platform operators, and solution architects.
Verified health surfaces
| Surface | Content | Tenant | Maturity |
|---|---|---|---|
| Process health | Framework health result | None | Foundation |
| Service information | Service name, description, environment label, timestamp, correlation envelope | None | Foundation |
| Recruitment health data | Tenant entity counts including onboarding and seeded-stage summary | Required | Foundation diagnostic |
Exact method/route pairs are listed once in the endpoint catalog.
Readiness limitations
The inspected health registration does not add checks for Recruitment persistence, message transport, Employee Service, Document Service, Workflow Service, outbox backlog, or downstream projection lag. A successful process-health result is not proof that onboarding completion can succeed.
OpenAPI discovery
Recruitment and gateway register endpoint exploration, Swagger generation, and Swagger UI middleware. No explicit lifecycle document metadata, version set, security requirements, response annotations, or generated artifact committed as the module contract was found. Default middleware locations are intentionally not documented as guaranteed public URLs.
Requires confirmation
- Production publication and access control for Swagger discovery.
- Dependency-readiness checks and service-level objectives.
- Whether tenant count diagnostics should be exposed outside controlled environments.
- Ownership of a curated lifecycle OpenAPI contract.
Source References
microservices/src/recruitment-service/Program.csmicroservices/src/recruitment-service/Api/RecruitmentEndpoints.csmicroservices/src/shared-kernel/Extensions/EndpointRouteBuilderExtensions.csmicroservices/src/gateway-api/Program.cs
Related Articles
See Also
Keywords
- Process health
- Dependency readiness
- OpenAPI discovery
Revision Information
- Status: Draft
- Last reviewed: 2026-07-20
- Review cycle: Quarterly