Organization Administration
Summary
Platform administrators manage tenant/company control-plane metadata. Tenant organization administrators manage workforce departments, designations, and employee organization assignments through authenticated application boundaries.
Audience
- Platform and tenant administrators
- Implementation, support, architecture, and security teams
Purpose
Use this inventory to assign administrative ownership without relying on internal route tables or environment-specific behavior.
Reference Content
| Capability | Confirmed behavior | Ownership and maturity |
|---|---|---|
| Company profile | Retrieve and update legal/display/contact/locale metadata | Platform; Implemented |
| Company settings and branding | Maintain tenant-scoped settings and client-linked presentation | Platform plus monolith settings compatibility; Transitional |
| Department management | List, create, update, activate/deactivate, and compatibility-delete behavior | Employee Service / monolith; Implemented and Transitional |
| Designation management | List/filter, create, update, activate/deactivate, and compatibility-delete behavior | Employee Service / monolith; Implemented and Transitional |
| Structure updates | Set department parent and head references | Implemented with limited hierarchy validation |
| Employee reassignment | Change an employee’s department and reporting manager; update designation through employee update | Employee Service; Implemented |
| Organization search/lookup | Search employees by department, designation, manager, and workforce fields; list organization masters | Employee Service; Implemented |
| Organization chart | Render searchable user-manager hierarchy | Monolith/UI; Transitional |
| Compatibility routing | Route employee, department, and designation traffic to monolith or Employee Service | Gateway; Transitional |
Architecture
Platform-level administrators own tenant and company control-plane records. Tenant administrators operate workforce organization data only within authorized tenant context. Exact authorization policy names and internal trust mechanisms are intentionally omitted.
Business concepts
Department and designation changes are master-data operations. Reassignment changes the employee aggregate and can create timeline, audit, and outbox records. UI evidence confirms pages for company settings, organization settings, user assignment, and organization charts, but the final route owner depends on cutover configuration.
Technical implementation
Employee Service supports organization commands/queries and compatibility response shapes. The current React settings page can search and maintain departments/designations and select parent/head references. Because backend ownership is transitional, administrators should verify the active deployment boundary through approved operations guidance.
Screenshot placeholder: Company profile/settings administration. Capture only after the final owning interface is approved; remove tenant-identifying and configuration values.
Screenshot placeholder: Department and designation administration. Use synthetic labels and exclude personal data from head/employee selectors.
Screenshot placeholder: Organization chart. Use synthetic people and organization data only.
Source References
microservices/src/platform-service/Api/PlatformAdminEndpoints.csmicroservices/src/employee-service/Application/Organization/Organization.csmicroservices/src/employee-service/Application/Commands/EmployeeApplicationCommands.csmicroservices/src/employee-service/Application/Queries/EmployeeApplicationQueries.csmicroservices/src/employee-service/Api/EmployeeCompatibilityEndpoints.csmicroservices/src/gateway-api/Program.csControllers/CompanySettingsController.csControllers/DepartmentsController.csControllers/DesignationsController.csUI/salary-ui/apps/client-hrms-portal/src/pages/admin/CompanySettingsPage.tsxUI/salary-ui/apps/client-hrms-portal/src/pages/admin/OrganizationSettingsPage.tsxUI/salary-ui/apps/client-hrms-portal/src/pages/OrganizationChartPage.tsx
Related Articles
See Also
Keywords
- Organization administration
- Workforce master data
- Compatibility routing
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly