# Developer Sandbox Accounts & Login Helper

This document describes how to set up, seed, and use the sandbox accounts when running the INVEETAIRE application locally or in debug mode.

## Environment Requirements

The sandbox logins and the login autocomplete helpers on the main login screen are **only visible** when the application is running in local development or debugging environments:

- `APP_ENV=local`
- OR `APP_DEBUG=true`

Make sure your `.env` file reflects these configurations.

---

## Seeding Sandbox Accounts

To provision the standard sandbox accounts and their default wedding workspace, run the following command from the root of your application:

```bash
php database/seed_users.php
```

This command is completely **idempotent**. If the accounts already exist, it updates their passwords to the default one below and ensures the default workspace relationship is correct without duplicating database entries.

---

## Sandbox Credentials

The following accounts are created with password **`Test@123`**:

| Role | Username | Password | Default Workspace |
| :--- | :--- | :--- | :--- |
| **Super Admin** | `testsuperadmin` | `Test@123` | *N/A* |
| **Couple** | `testcouple` | `Test@123` | `Test Couple Workspace` (`test-couple-workspace`) |
| **Crew** | `testcrew` | `Test@123` | `Test Couple Workspace` (`test-couple-workspace`) |

---

## Developer Login Helper UI

When debugging or local environment is active, the `/auth/login` page renders a collapsible section titled **Developer Sandbox Accounts**.

- Click on the header of the helper box to expand it.
- Click any of the role buttons (e.g. **Super Admin**, **Couple**, **Crew**) to instantly pre-fill the username and password fields.
- Click **Login** to sign in instantly.