# OpenFinance — SACCO Management Demo

OpenFinance is a GitHub-safe portfolio version of a SACCO management system. It preserves the operational concepts of members, contributions, loans, guarantors, ledger, receipts, expenses, communications, support and reporting while deliberately removing production dependencies.

**Demo domain:** `https://system-sacco.valron.co.ke`  
**Public website:** `https://sacco.valron.co.ke`

## How the demo works

- PHP sessions provide a lightweight demo sign-in.
- No password or external identity provider is required.
- Seeded records are stored in JavaScript and copied into browser `localStorage`.
- New demo records persist only in that browser until “Reset demo data” is used.
- No MySQL database is required.
- No M-Pesa, card, SMS, email, Firebase, KYC or other APIs are called.
- The `integrations/` folder documents where production adapters would be introduced.

## Run locally

```bash
php -S localhost:8081
```

Then open `http://localhost:8081` and enter the demo workspace.

## Production note

This is not a production core-banking or SACCO system. A production fork needs a proper database, authentication/authorization, audit logs, encryption, secrets management, transaction integrity, backups, API integrations, tests and an independent security/compliance review.