# Southend Private School — Management System

Production-ready Laravel school management platform for **Southend Private School, Blantyre, Malawi**.

## Requirements

- PHP 8.3+
- Composer
- MySQL 8 (Laragon) or SQLite (tests)
- Node.js (optional)

## Quick Start (Laragon)

```bash
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve
```

Visit `http://localhost:8000/login` — password for all demo users: `password`

## Portals

| Portal | URL | Roles |
|--------|-----|-------|
| Admin | `/dashboard` | Super Admin, Administrator, Bursar, Accountant, Auditor, Registrar, **Headmaster** |
| Teacher | `/teacher` | Teacher, **Department Head**, Registrar, Administrator |
| Parent | `/parent` | Parent |
| Student | `/student` | Student |
| Staff | `/staff` | Librarian, Front Desk |

## Key modules

- **Accounting & finance** — double-entry journal, billing, invoices, **PayChangu & One Khusa online payments**, expenses (with approval), budgets + forecast, bank recon + **CSV import**
- **School** — students (**CSV import/export**, document uploads), staff, classes, clubs/chat, events, leadership roles
- **Discipline** — multi-stage **case workflow**, evidence uploads, anonymous reporting, parent outcome visibility
- **Portals** — teacher/parent/student/staff with messaging, notifications, timetables
- **API** — Sanctum REST + `/api/docs`

## Demo credentials

| Email | Role |
|-------|------|
| osei@southend.edu | Super Admin |
| headmaster@southend.edu | Headmaster |
| samuel@southend.edu | Teacher (Grade 10A class teacher) |
| depthead@southend.edu | Department Head (Sciences) |
| thandiwe.banda@southend.edu | Student, Head Girl |
| parent.banda@southend.edu | Parent |

## Production

See [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for SMTP, queue worker, cron, and cache commands.  
Payment gateway setup: [docs/PAYMENTS.md](docs/PAYMENTS.md)

```bash
php artisan southend:audit
php artisan test
```

## Reference

- Module registry: `docs/MODULE_REGISTRY.md`
- API spec: `docs/openapi.yaml`
- Developer spec: `docs/originals/SouthendSchool_Developer Guide.docx`
