---
title: GHSS Backend
emoji: 🏫
colorFrom: purple
colorTo: indigo
sdk: docker
pinned: false
app_port: 7860
---

# Gifted Hands Senior School — Backend API

FastAPI backend for the GHSS school management system.
Runs on Hugging Face Spaces (port 7860).

## Environment Variables (HF Secrets)
| Variable | Description |
|---|---|
| `SUPABASE_URL` | Your Supabase project URL |
| `SUPABASE_SERVICE_KEY` | Supabase service role key |
| `GOOGLE_SERVICE_ACCOUNT_JSON` | Google Drive service account JSON |
| `SMS_API_KEY` | Africa's Talking API key |
| `SMS_USERNAME` | Africa's Talking username |
| `SMS_SENDER_ID` | Registered sender ID (leave blank for sandbox) |
| `JWT_SECRET` | Random secret string for JWT signing |
| `B2_KEY_ID` | Backblaze B2 application key ID |
| `B2_APPLICATION_KEY` | Backblaze B2 application key |
| `B2_BUCKET_NAME` | B2 bucket name (default: ghss-files) |
| `B2_BUCKET_ID` | B2 bucket ID |
| `AIRTEL_CLIENT_ID` | Airtel Money client ID |
| `AIRTEL_CLIENT_SECRET` | Airtel Money client secret |
| `AIRTEL_ENV` | sandbox or production |
| `MTN_CLIENT_ID` | MTN MoMo client ID |
| `MTN_CLIENT_SECRET` | MTN MoMo client secret |
| `MTN_SUBSCRIPTION_KEY` | MTN MoMo subscription key |
| `MTN_ENV` | sandbox or production |

## Default Admin Login
- Login ID: `admin`
- Password: `admin123`
- **Change immediately after first login**

## Login ID Formats
- **Teachers**: GHSS001, GHSS002 …
- **Students**: GHSS0012026 (auto-generated on enrolment)
- **Parents**: registered by email