# User manual

Roles: `user` = student, `volunteer` = team dashboard, `admin` = full admin UI.  
Signup on `/login` makes a student; admins change roles in the admin users tab.

## Login / signup

Open the site (deployed URL or http://localhost:3000).

**Login** — `/login`, email + password. Redirects:

| Role | Route |
|------|--------|
| user | /user-dashboard |
| volunteer | /team-dashboard |
| admin | /admin-dashboard |

**Register** — toggle to sign up, name + email + password. Email confirm depends on Supabase settings.

**Forgot password** — on login page if enabled.

**Logout** — profile / header on dashboards.

## Students

**Dashboard** `/user-dashboard` — overview, tabs for browsing orders, etc.

![User dashboard example](screenshots/userDash.png)

**Browse / cart** — search, filters, add qty.

**Checkout** `/checkout` — pick weekday + time slot + notes, place order. Cart comes from the previous step.

## Volunteers (team)

`/team-dashboard` — overview, inventory, alerts, analytics, pickups (tab names match the UI).

![Team dashboard example](screenshots/teamDash.png)

## Admins

`/admin-dashboard`

![Admin dashboard example](screenshots/adminDash.png)

- Overview / stats  
- Inventory — add/edit/delete items, filters  
- Users — roles  
- Alerts  
- Pickups / orders  
- Settings — pantry name, phone, address, thresholds  
- Activity log  

## Routes

| Path | Who |
|------|-----|
| / | everyone |
| /login | everyone |
| /user-dashboard | students |
| /checkout | students (needs cart) |
| /team-dashboard | volunteers |
| /admin-dashboard | admins |

Logged-out users hitting protected routes get sent to login.

Setup: `Installation_Guide.md`. DB: `Database/README.txt`.
