Employee Timeline Events

Summary

Only timeline entries added through RecordTimelineEvent raise EmployeeTimelineEventRecorded. Internal lifecycle timeline additions use a separate helper and do not automatically emit this contract.

Audience

• Employee Service developers, QA engineers, and architects

Overview

The aggregate stores timeline entries for several internal actions and for explicitly submitted lifecycle input. The explicit RecordTimelineEvent path both appends the entry and raises a domain event. Infrastructure maps that event to a contract carrying Employee identity, timeline event type, and description.

Confirmed distinctions

Timeline action	Entry persisted	Timeline-recorded event raised
Explicit RecordTimelineEvent	Yes	Yes
Create, profile, manager, department, status, delete helper entry	Yes	No
Add note	Yes	No
Add document reference	Yes	No

The contract comment describes possible cross-module activity feeds, but no subscriber was found. A downstream activity feed is therefore Not implemented from the evidence reviewed.

Information handling

The integration contract includes a free-text description. Producers and consumers should treat it as potentially sensitive and avoid unreviewed logging or forwarding. Approved payload classification and retention rules Require confirmation.

Source References

• microservices/src/employee-service/Domain/Employees/Employee.cs
• microservices/src/employee-service/Infrastructure/EmployeeDbContext.cs
• microservices/src/contracts/Events/EmployeeTimelineEventRecordedEvent.cs
• microservices/src/employee-service/Application/Commands/EmployeeApplicationCommands.cs

Related Articles

• Employee timeline business documentation
• Audit and timeline storage
• Event catalog

See Also

• Consumer landscape
• Contract versioning

Keywords

• Employee timeline event
• Activity feed
• Free-text payload

Revision Information

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