Correlation IDs package (HTTP + jobs)

What you get (4 files):

✅ correlation-id-contract.md: The contract every service follows

• Header name and format
• Generation and propagation rules
• What not to do (multiple competing IDs)

📄 AspNetCoreCorrelationIdMiddleware.cs: Inbound request correlation

• Accepts inbound ID or generates one
• Adds response header
• Starts a logging scope with correlation_id

📄 CorrelationIdDelegatingHandler.cs: Outbound propagation for HttpClient

• Copies correlation ID to downstream calls
• Preserves existing header if already set
• Integration hint: register once per HttpClient

📋 README.md: Integration notes

• Where to wire it in API and worker processes
• Recommended log fields to make correlation useful
• Quick verification steps

Quick reference (inline preview):

Correlation contract
- If inbound X-Correlation-Id exists: keep it
- Else: generate a new one
- Always: add it to response headers, dependency calls, and job messages
- Always: include correlation_id in every log event that matters