# Who is who?

Cuppa has **three kinds of people**. Each kind has its own place in the panel.

---

## Quick comparison

| Type | Who are they? | Where to manage | Badge |
|------|---------------|-----------------|-------|
| **Employee** | Cuppa team (admins, support, ops) | **People → Employees** | Employee (amber) |
| **Dev** | Developers with extra tools | **People → Employees** | Dev (green) |
| **User** | Regular app customers / members | **People → Users** | User (purple) |
| **Business staff** | Owner, manager, staff of a business | **Businesses → [business] → Staff** | Business role name |

---

## Employees (Cuppa team)

- Work for **Cuppa**, not for a customer business.
- Use the **main admin panel** (Dashboard, Businesses, Roles, etc.).
- Have a **global role** like `SUPER_ADMIN`, `ADMIN`, `MANAGER`.
- Account types: **Employee** (`SYSTEM`) or **Dev** (`DEV`).

**Examples:** super admin, Cuppa support agent, internal manager.

---

## Users (regular platform users)

- Normal people who use the app.
- Do **not** appear in the Employees list.
- Have account type **User** (`USER`).
- Usually have global role `USER` (limited platform access).

**Examples:** app customer, community member, end user.

---

## Business staff

- Belong to a **specific business**.
- Managed inside that business — **not** on Employees or Users pages.
- Have a **business role** (Owner, Manager, Staff, or custom).
- The business owner account has account type **Business** (`BUSINESS`).

**Examples:** café owner, store manager, branch staff.

---

## Two role systems (important)

### 1. Global roles (platform)

- Names: `SUPER_ADMIN`, `ADMIN`, `MANAGER`, `USER`
- Set on **Employees** and **Users** pages
- Control access to admin panel pages (Users, Roles, Businesses, etc.)
- Managed under **System → Roles**

### 2. Business roles (per business)

- Names: Owner, Manager, Staff, or custom
- Set on **Business → Staff** or business detail pages
- Control what someone can do **inside that business**
- Managed under **Business panel → Roles**

> A business staff member may have global role `USER` **and** business role `Manager`. That is normal.

---

## Where data should NOT appear

| Wrong place | Why |
|-------------|-----|
| Business owner on **Users** page | Business accounts use **Businesses** |
| Store manager on **Employees** page | Business staff use **Business → Staff** |
| Cuppa admin on **Business → Staff** | Cuppa team uses **Employees** |

---

## Visual map

```
Cuppa platform
├── Employees page     → SYSTEM + DEV accounts
├── Users page         → USER accounts
└── Businesses
    └── Each business
        ├── Staff      → business members
        ├── Roles      → business permissions
        ├── Locations
        └── Franchises
```

---

## Next steps

- Manage Cuppa team → **[Employees](./03-employees.md)**
- Manage regular users → **[Users](./04-users.md)**
- Manage business people → **[Businesses](./05-businesses.md)** and **[Business panel](./06-business-panel.md)**