# Business panel

When you **own a business** or **impersonate one**, the sidebar changes to the business panel.

**URL base:** `/dashboard/business`

---

## Panel pages

| Page | What you do here |
|------|------------------|
| **Overview** | Stats, your access, quick links |
| **Locations** | Branches / physical sites |
| **Franchises** | Group locations under regions |
| **Staff** | People who work for this business |
| **Roles** | Business permissions (Owner, Manager, Staff, custom) |

---

## Overview

Shows counts for locations, franchises, staff, and roles.

- **Your access** — shows **your business role** for this business (e.g. Owner), not every role in the system.
- Click stat cards to jump to that section.

---

## Locations

1. Go to **Locations**.
2. Click **Add location**.
3. Enter name, address, city, country, etc.
4. Save.

Edit or delete from the list. Assign **location staff** from the location detail if available.

---

## Franchises

1. Go to **Franchises**.
2. Click **Add franchise**.
3. Enter name and description.
4. Link locations to the franchise as needed.

Use franchises when one brand has multiple regions or sub-brands.

---

## Staff

1. Go to **Staff**.
2. Add a member (existing user or invite flow as implemented).
3. Assign a **business role** (Owner, Manager, Staff, or custom).

**Important:** Staff here are **business people**, not Cuppa employees and not regular Users page entries.

Each staff member has:

- A **user account** (often `BUSINESS` or `USER` account type)
- A **business role** for this business only

---

## Roles (business)

1. Go to **Roles**.
2. View system templates (Owner, Manager, Staff) and custom roles.
3. Each role lists **business permissions** (what they can do in this business).

These permissions are **separate** from global admin permissions on **System → Roles**.

> Super admin global permissions do **not** appear here. You only see business-scoped permissions.

---

## Who sees the business panel?

| User | How they get in |
|------|-----------------|
| Business owner | Logs in with business account |
| Business staff | Logs in; has business membership |
| Cuppa super admin | **Impersonates** the business |

Main admin dashboard (`/dashboard`) redirects business panel users to `/dashboard/business`.

---

## Exit business panel (impersonation)

If you impersonated a business, click **Exit** on the blue banner at the top. You return to the main admin panel.

---

## Common mistakes

| Mistake | Fix |
|---------|-----|
| Looking for staff on Employees page | Use **Business → Staff** |
| Assigned global `ADMIN` instead of business role | Edit staff row; pick business role |
| Two sidebar items active at once | Refresh — should be fixed; report if it persists |
| Franchises empty | Create franchise first, then link locations |

---

## Related guides

- [Businesses](./05-businesses.md)
- [Who is who?](./02-who-is-who.md)
- [Roles & permissions](./07-roles-and-permissions.md)