Skip to main content

Organization Lifecycle

Summary​

The confirmed lifecycle starts with Platform company setup, continues through department/designation masters and employee assignments, and supports updates and inactive states. Deletion and restoration differ between extracted and monolith implementations.

Audience​

  • Platform and tenant administrators
  • Implementation, support, development, architecture, and product teams

Purpose​

This flow separates organization setup from employee lifecycle and identifies where lifecycle parity remains transitional.

Architecture​

Business concepts​

  • Company setup — Implemented: Platform can create/update tenant-linked company metadata and settings.
  • Department and designation setup — Implemented: tenant-scoped masters can be created and updated.
  • Employee and manager assignment — Implemented: initial creation and separate change commands support organization references.
  • Organizational update — Implemented: department, designation, employee department, and manager data can change with audit/timeline support where applicable.
  • Deactivation — Implemented: extracted department/designation operations use inactive state; active department assignment blocks department deactivation.
  • Deletion — Transitional: monolith controllers physically delete unreferenced masters, while extracted services deactivate them.
  • Restore/reactivate — Foundation: update contracts accept active state, but approved restoration policy and UI behavior require confirmation.
  • Company archival/deletion — Requires confirmation: no organization-specific company archival workflow was confirmed beyond Platform tenant lifecycle behavior.

Technical implementation​

Employee changes raise domain events where supported and are translated to the outbox during the same persistence operation. Department/designation master updates create audit records but not dedicated integration events. Organization administrators should treat active-state changes as governed master-data changes.

Source References​

  • microservices/src/platform-service/Api/PlatformAdminEndpoints.cs
  • microservices/src/employee-service/Application/Organization/Organization.cs
  • microservices/src/employee-service/Application/Commands/EmployeeApplicationCommands.cs
  • microservices/src/employee-service/Domain/Organization/Organization.cs
  • microservices/src/employee-service/Domain/Employees/Employee.cs
  • Controllers/DepartmentsController.cs
  • Controllers/DesignationsController.cs

See Also​

Keywords​

  • Organization lifecycle
  • Master-data deactivation
  • Employee reassignment

Revision Information​

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