# Local access — Southend School

## Why https://southend.test may not load

Laragon created the Apache vhost, but **`southend.test` is missing from your Windows hosts file** (other projects like `accounting.test` are listed; this one was never added).

The Laravel app itself is healthy (database, migrations, tests all pass).

---

## Option A — Fix Laragon domain (recommended)

1. **Right-click** `setup-local.ps1` → **Run with PowerShell (Admin)**  
   — or right-click `fix-southend-hosts.bat` → **Run as administrator**

2. Approve the UAC prompt.

3. In Laragon: **Menu → Apache → Reload**

4. Open **https://southend.test/login**

**Verify hosts entry saved:**
```cmd
findstr southend C:\Windows\System32\drivers\etc\hosts
```
Must show: `127.0.0.1      southend.test`

**Manual hosts edit** (if scripts fail):  
Notepad **as Administrator** → open `C:\Windows\System32\drivers\etc\hosts` → add after `villagebank.test`:
```
127.0.0.1      southend.test        #laragon magic!
```
Save, then run `ipconfig /flushdns`.

---

## Option B — Dev server (works immediately, no hosts edit)

Double-click **`start-dev.bat`** in the project folder.

Open: **http://127.0.0.1:8000/login**

---

## Demo login

| Email | Password | Role |
|-------|----------|------|
| osei@southend.edu | password | Super Admin |
| headmaster@southend.edu | password | Headmaster |
| parent.banda@southend.edu | password | Parent |

Full list: `docs/users-credentials.txt`

---

## If you already ran setup

```bash
php artisan migrate --seed   # first time only
php artisan optimize:clear
php artisan test
php artisan southend:audit
```