SindyMl/-div-elopers

Stokvel Management Platform for South African savings groups. Web app with member onboarding, contribution tracking, payout scheduling, meeting management, payment gateway integration, live SA prime lending & repo rate display, and analytics dashboards. Built by a team of 6 using Agile, CI/CD, and TDD. # Stockpal — Stokvel Management Platform > A web-based platform for South African savings groups (stokvels) to manage contributions, payout schedules, group meetings, and financial insights — replacing spreadsheets and chat threads with a transparent, role-aware system. --- ## Table of Contents 1. Overview 2. Features 3. Tech Stack 4. Database Schema 5. SA Financial Data Integration 6. Project Structure 7. Getting Started 8. User Roles 9. Team --- ## Overview Stokvels are a cornerstone of South African financial culture — informal savings clubs where members pool money and take turns receiving the total. Stockpal digitises this process, providing: - Role-based access for **Members**, **Treasurers**, and **Admins** - Real-time group and contribution tracking backed by Cloud Firestore - Meeting scheduling with agenda and minutes management - A live SA financial data widget (SARB prime rate, repo rate, USD/ZAR) - Deployed as a public web app on Azure Static Web Apps --- ## Features | Feature | Description | |---|---| | **Authentication** | Firebase Auth with email/password; role-based access control (Admin, Treasurer, Member) | | **Group Management** | Create stokvel groups with a contribution amount, payout order, and meeting frequency; invite members by email | | **Contribution Tracking** | Members view contribution history; Treasurers confirm payments and flag missed contributions | | **Payment Integration** | PayFast payment gateway for secure card and EFT payments (ZAR only) | | **Meeting Management** | Schedule meetings (08:00–20:00), post agendas, record minutes; real-time notifications via Firestore `onSnapshot` | | **SA Data Widget** | Live prime rate, repo rate, inflation rate, and USD/ZAR exchange with a projected savings growth calculator | | **Dashboard** | Personalised view of group stats, upcoming meetings, and SA financial indicators | --- ## Tech Stack | Layer | Technology | |---|---| | Frontend | HTML5 / CSS3 / Vanilla JavaScript (ES …