Employees And Users
Explains employee profile forms, employee listing/detail tables, document uploads, notes, and user account forms.
Workflow
- ProfileHR: Create the employee with code, contact, branch, department, shift, and manager.
- AccessAdmin: Create or link the user account and assign roles.
- EvidenceHR: Attach documents, notes, and emergency/contact details.
- ReviewManager / HR: Use profile tabs for attendance, leave, payroll, documents, and notes.
| Stage | Actor | Action | Result |
|---|---|---|---|
| Profile | HR | Create the employee with code, contact, branch, department, shift, and manager. | The person exists in workforce records. |
| Access | Admin | Create or link the user account and assign roles. | The employee or manager can log in. |
| Evidence | HR | Attach documents, notes, and emergency/contact details. | The profile is complete for operations. |
| Review | Manager / HR | Use profile tabs for attendance, leave, payroll, documents, and notes. | People-level history is easy to audit. |
Essential fields
Admin / HR
Employee create/edit form
Stores the HR profile used by attendance, leave, roster, payroll, reports, and employee portal.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Employee code | Unique staff identifier. | EMP-1002 |
Required and should remain stable. |
| First / last name | Employee legal or display name. | Ali Ahmed |
Required. |
| Work email | Business email. | ali@ovion.tech |
Recommended and often unique. |
| Branch / department | Where the employee belongs. | Head Office / Operations |
Required for filtering and reports. |
| Designation | Job title. | Support Executive |
Recommended. |
| Shift | Default work shift. | General 9 to 6 |
Important for attendance evaluation. |
| Manager | Approver or reporting manager. | Ayesha Manager |
Used in manager views. |
Essential fields
Admin / HR
Employee document and note forms
Attach contracts, policies, IDs, files, and timeline notes to an employee profile.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Expires at | Document expiry date. | 2027-06-30 |
Optional but useful for compliance. |
| Visible to employee | Whether portal user can see it. | Yes |
Be careful with confidential files. |
| Remarks / note | Human explanation. | Signed handbook |
Recommended. |
Essential fields
Admin
User account create/edit form
Creates or updates login accounts and links them to employees and roles.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Name | Login display name. | Ali Ahmed |
Required. |
| Login email. | ali@ovion.tech |
Required and unique. | |
| Account status | Active, suspended, banned, locked, etc. | active |
Controls login access. |
| MFA method/enabled | Extra security method. | none / otp / totp |
Use for sensitive roles. |
| Assigned roles | Access groups. | Employee |
Required for useful access. |
| Linked employee | HR profile attached to login. | EMP-1002 |
Required for portal features. |
| Password | Temporary password for new user. | Demo@12345 |
Required for new user; blank keeps existing on edit. |
Essential table
Database listing
Employee listing table
Main HR list for finding staff and opening profile records.
Filters: Search, Branch, Department, Designation, Shift, Status
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Employee | Avatar, name, and email. | employees table. | Ali Ahmed / ali@ovion.tech. |
| Employee ID | Staff code. | employee_code. | EMP-1002. |
| Organization | Branch, department, and designation. | linked master data. | Head Office / Operations. |
| Shift | Default shift. | shifts table. | General 9 to 6. |
| Status | Employment state. | employment_status. | Active means included in daily operations. |
| Status | Current workflow state for the row. | The record status field or computed workflow state. | Pending means someone still needs to act. |
Available actions
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Essential table
Database listing
User account table
Lists login accounts and their connection to employees and roles.
Filters: Search, Role, Status, Link state
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| User | Account name, email, and contact. | users table. | Ali Ahmed. |
| Roles | Assigned access groups. | model_has_roles. | Employee. |
| Linked employee | HR profile attached. | employee relationship. | EMP-1002. |
| MFA | Security method and enabled state. | user MFA fields. | OTP enabled. |
| Status | Can the user log in? | status field. | Suspended means blocked until restored. |
| Status | Current workflow state for the row. | The record status field or computed workflow state. | Pending means someone still needs to act. |
Available actions
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Full field appendix
Main docs show essential fields only. Open Documentation Coverage for every detected source field, action, column, route hint, controller hint, and test hint.