This guide covers adding, editing, and managing employees in CHRIS.
Prerequisites
- Admin or HR Manager role
- At least one team created (for assignment)
- Holiday scheme set up (for contract)
Add a New Employee
Step 1: Open Employee Form
- Navigate to Employees
- Click Add Employee
Step 2: Enter Basic Information
| Field | Required | Description |
|---|---|---|
| Yes | Login email (must be unique) | |
| First Name | Yes | Employee's first name |
| Last Name | Yes | Employee's last name |
| Role | Yes | admin, hr_manager, or employee |
| Team | No | Team assignment |
Step 3: Set Role
Choose the appropriate role:
| Role | Capabilities |
|---|---|
employee |
Submit requests, view own data |
hr_manager |
Above + approve any request, view all employees |
admin |
Full access including settings |
Step 4: Contract Details (Optional)
| Field | Description |
|---|---|
| Position | Job title |
| Start Date | Employment start date |
| End Date | Contract end (if applicable) |
| Contract Type | Full-time, Part-time, etc. |
| Leave Entitlement | Annual leave days per year |
| Holiday Scheme | Which public holidays apply |
| Rate Type | Hourly, Monthly, Yearly |
| Rate Amount | Salary/rate value |
| Currency | Payment currency |
Step 5: Create Employee
Click Create Employee. The system will:
- Create the user account in Supabase Auth
- Create the employee profile
- Send a welcome email with login instructions
!!! note "Email Delivery" Ensure SMTP is configured for the welcome email to be sent.
View Employee List
Navigate to Employees to see all employees:
- Search: Filter by name or email
- Filter by Role: Show only admins, HR, or employees
- Filter by Status: Active or inactive employees
- Sort: By name, email, or creation date
Edit Employee Profile
Basic Information
- Click on an employee to view their profile
- Click Edit
- Modify fields as needed:
- Name (first, last)
- Email (requires re-verification)
- Role
- Team assignment
- Click Save
Contract Information
- In the employee profile, go to Contracts tab
- Click Edit Contract or Add Contract
- Update contract details
- Save changes
Upload CV/Resume
- In the employee profile, find Documents section
- Click Upload CV
- Select a PDF or document file
- The file is stored securely in Supabase Storage
Profile Photo
- In the employee profile, click on the avatar
- Upload an image
- Crop as needed
- Save
Change Employee Role
- Navigate to the employee profile
- Click Edit
- Change the Role dropdown
- Save changes
!!! warning "Role Change Effects" - Upgrading to admin: User gains full system access - Downgrading from admin: User loses settings access - The user may need to sign out and back in
Deactivate an Employee
For employees who leave or take extended leave:
- Open the employee profile
- Click Deactivate
- Confirm the action
Effects of deactivation:
- Employee cannot sign in
- Their data is preserved
- Pending requests are cancelled
- They don't appear in active employee lists
Reactivate an Employee
- Go to Employees with "Show Inactive" filter
- Find the employee
- Click Reactivate
- They can now sign in again
Reset Employee Password
If an employee forgets their password:
- Go to their profile
- Click Reset Password
- Choose delivery method:
- Send reset email
- Set temporary password
- The employee can then set a new password
Admin Masquerade
Admins can view the system as any user:
Enable Masquerade
- As admin, go to Employees
- Find the employee
- Click View As (masquerade button)
- You now see the system as that employee
While Masquerading
- A banner shows you're in masquerade mode
- You see exactly what the employee sees
- Your actions are logged as admin (not employee)
Exit Masquerade
Click Exit Masquerade in the banner to return to admin view.
!!! tip "Use Cases for Masquerade" - Troubleshooting user-reported issues - Training employees on how to use features - Verifying permission configuration
Delete Employee
!!! danger "Permanent Action" Deleting an employee is permanent. Consider deactivation instead.
- Open the employee profile
- Click Delete Employee
- Confirm by typing the employee's email
- All data associated with the employee is removed
Deleted data includes:
- Profile information
- Leave request history
- Uploaded documents
- Contract information
Bulk Operations
Import Employees
For adding multiple employees:
- Navigate to Employees > Import
- Download the CSV template
- Fill in employee data
- Upload the completed CSV
- Review and confirm the import
Export Employee Data
- Go to Employees
- Click Export
- Select format (CSV)
- Download the file
Best Practices
Email Addresses
- Use work email addresses for employee accounts
- Ensure emails are unique in the system
- Verify email format before saving
Role Assignment
- Start employees with minimal permissions
- Elevate to hr_manager only if needed
- Limit admin access to essential personnel
Data Maintenance
- Regularly review inactive employees
- Update contracts when terms change
- Keep holiday scheme assignments current