MargaretT-ux/EduFees-school-fee-tracker

Python school fee tracker for African schools — offline, simple, free main.py # EduFees 💰 — School Fee Tracker. A command-line Python tool that helps school administrators and teachers in African schools track student fee payments, generate collection reports, and manage outstanding balances — simply and without internet. Built by Thato Lepelesana — EdTech developer from Lesotho 🇱🇸, building practical tools for African schools. --- ## 🎯 Problem This Solves Many schools across Lesotho and Africa track fee payments using paper registers or basic spreadsheets. Records get lost, balances are miscalculated, and parents receive no receipts. EduFees replaces this with a simple, reliable, offline system any school administrator can use. --- ## ✨ Features - 👤 **Enrol students** — name, grade, guardian, phone, and annual fee - 💳 **Record payments** — by term, payment method, with auto-generated receipt number - 📋 **View all students** — with paid amount and outstanding balance at a glance - 🔍 **Search students** — by name or ID, with full payment history - 📊 **Fee collection report** — summary of fully paid, partial, and unpaid students - 💾 **Data saved automatically** — stored in a local JSON file, no database needed - 📶 **Fully offline** — works without internet on any computer --- ## 🛠️ Tech Stack | Technology | Purpose | |---|---| | Python 3 | Core application logic | | JSON | Lightweight local data storage | | datetime | Receipt generation and timestamps | | os | Cross-platform terminal support | No external libraries required — runs on pure Python. --- ## 🚀 Getting Started ### Prerequisites - Python 3.6 or higher installed ### Installation ```bash # Clone the repository git clone github.com # Navigate into the project cd edufees-tracker # Run the app python main.py ``` --- ## 📸 Menu Overview ``` ────────────────────────────────────────────────── 🎓 EduFees — Main Menu School Fee Tracker · Lesotho 🇱🇸 ────────────────────────────────────────────────── STUDENTS [1] Add new studen …