Employee UI Validation and Error Messages

Summary

This catalog separates visible client checks from extracted-service validation and generic API/network error handling.

Audience

• HR administrators, developers, QA engineers, and support engineers

Reference Content

Category	Confirmed behavior	Layer/status
Required name	Visible client message and Basic step activation	UI
Employee/login email	Must contain an email separator	UI
Temporary password	Minimum length when manual creation is selected	UI
Direct/hourly compensation	Positive annual amount or hourly rate	UI
Duplicate employee code	Extracted service has tenant-scoped check	Service; UI cutover transitional
Duplicate email	Extracted service has tenant-scoped checks	Service; UI cutover transitional
Invalid department	Extracted service requires active reference	Service
Invalid designation	Extracted service requires active reference and create-time department match	Service
Invalid manager/self-manager	Extracted service requires active manager and prevents self-reference	Service/domain
Missing tenant	Extracted service validator reports missing context	Service
Not found	Update validator and endpoints support not-found outcomes	Service/API
Permission denied	Route unauthorized page; monolith can return forbidden	UI/API
Server/network failure	Generic list/save/status/document messages	UI

Exact monolith duplicate and validation text can differ from extracted-service text. Do not rely on text matching across cutover.

Error presentation

Form validation uses a shared page error and jumps to the relevant step. Save success/failure also uses toast notifications. Load and document errors use page-level or local empty states. Inputs do not have confirmed per-field error association.

Source References

• UI/salary-ui/apps/client-hrms-portal/src/App.tsx
• UI/salary-ui/apps/client-hrms-portal/src/pages/Labor.tsx
• UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
• microservices/src/employee-service/Application/Validators/EmployeeCommandValidators.cs
• Controllers/LaborController.cs

Related Articles

• Validation reference
• Create employee
• Employee creation troubleshooting

See Also

• Employee API
• Employee known limitations

Keywords

• UI errors
• validation messages
• API failure

Revision Information

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