# Employees

Manage **Cuppa internal team** accounts here.

**Menu:** People → **Employees**  
**URL:** `/dashboard/employees`

---

## Who appears on this page?

| Shows | Does not show |
|-------|----------------|
| Employee (`SYSTEM`) | Regular users |
| Dev (`DEV`) | Business owners |
| | Business staff |

---

## Badge icons

| Icon + label | Meaning |
|--------------|---------|
| Employee | Standard Cuppa team member |
| Dev | Developer account (extra debug tools) |

Each person also has a **global role** badge (e.g. `SUPER_ADMIN`, `ADMIN`).

---

## Add an employee

1. Go to **People → Employees**.
2. Click **Add employee**.
3. Fill in:
   - First name, last name
   - Username (unique, lowercase)
   - Email
   - Password
4. Under **Access & status**:
   - Choose **Employee** or **Dev**
   - Pick a **global role** (controls panel access)
   - Keep **Active account** checked
5. Click **Create**.

---

## Edit an employee

1. Find the person in the list (use search if needed).
2. Click the **pencil** icon.
3. Change details as needed.
4. Leave password blank to keep the current password.
5. Click **Update**.

---

## Deactivate vs delete

| Action | Effect |
|--------|--------|
| **Uncheck Active account** | Person cannot log in; record stays |
| **Delete** | Removes the account permanently |

Prefer deactivating unless you are sure you want to delete.

---

## Impersonate (super admin / permitted users)

1. Click the **mask** icon on a row.
2. You now see the app **as that employee**.
3. A yellow banner appears at the top.
4. Click **Exit impersonation** to return to your account.

Use this to debug issues or verify permissions.

---

## Permissions needed

| Action | Permission |
|--------|------------|
| View list | `USERS_VIEW` |
| Add | `USERS_CREATE` |
| Edit | `USERS_UPDATE` |
| Delete | `USERS_DELETE` |
| Impersonate | `USERS_IMPERSONATE` |

Super admin can do everything.

---

## Common mistakes

| Mistake | Fix |
|---------|-----|
| Added a business owner here | Create them under **Businesses** instead |
| Gave `USER` global role to Cuppa staff | Use `ADMIN` or `MANAGER` for team members |
| Person can't see Roles page | Edit their global role and add permissions |

---

## Related guides

- [Who is who?](./02-who-is-who.md)
- [Roles & permissions](./07-roles-and-permissions.md)
- [Impersonation](./08-impersonation.md)