Jama-Barre-hub/GradeVault

Role-based school results management system for Somali schools. Teachers record marks; grades, averages and class positions compute automatically; students see only their own results; every grade change is audited. # GradeVault **A role-based school results management system for Somali schools.** Teachers record marks. Grades, averages and class positions are computed automatically. Students sign in with a unique username and see only their own results. Every change to a grade is permanently audited. > **Status:** In development. Data model, computation, web interface and > multi-school isolation are complete and tested; not yet publicly deployed. > See PROPOSAL.md for the full plan and roadmap. | Done | | |---|---| | **Data model** | institutions, years, terms, classes, subjects, grading scales, students, teachers, enrolment, teaching assignments, assessments, marks | | **Audit trail** | append-only; every grade change attributable and unremovable | | **Computation** | subject totals, percentages, letter grades, term averages, class position | | **Web interface** | portal layout, role dashboards, teacher mark entry, class rankings, student results | | **Report cards** | printable, per student per term, with signature lines | | **Public page** | explains the software to a visitor who has no account | | **Sign-in limits** | ten failed attempts pause an account for twenty minutes | | **Isolation** | each school sees only its own data, enforced and tested | | **Tests** | 238, including permission and tenancy tests that pass only when access is refused | | Not done | | |---|---| | **Somali translation** | withdrawn until it can ship complete — see Language | | **Public deployment** | configuration ready, not yet hosted | | **Independent security review** | every test here was written by the author | --- ## Why this exists In many Somali primary and secondary schools, results live on paper registers or in a spreadsheet on a single laptop. Files are lost, averages are computed by hand and contain errors, students wait weeks for results, and there is no record of who changed a mark. GradeVault addresses all four. --- ## Roles | Role | Can do | |---|---| | **Administra …