KJMalaka/SkillProof

SkillProof is a verified skills and work history platform for South African job seekers. Employers and training providers confirm claims directly into a tamper evident ledger, replacing unreliable CVs with real, portable proof, no background checks needed. # SkillProof **A verified skills and work-history trust layer for South African job seekers.** SkillProof lets past employers and training providers directly confirm a candidate's skills and work history into a portable, tamper-evident record — sitting on top of existing job platforms like SAYouth.mobi, not competing with them. --- ## Table of Contents - The Problem - The Solution - Key Features - Architecture - How the Ledger Works - Tech Stack - Project Structure - API Reference - Setup & Running Locally - Demo Walkthrough - What's Simulated vs Production-Grade - Out of Scope for this MVP --- ## The Problem Employers don't trust self-reported CVs, and job seekers can't afford the data or the paper trail of references it takes to prove what they claim. The result: qualified candidates get filtered out by trust, not by skill. ## The Solution SkillProof gives every claim a path to becoming *verified*: a past employer or training provider confirms it with one click (or one WhatsApp reply, or one bulk import for a whole cohort), and that confirmation is written into a SHA-256 hash-chained ledger tied to the candidate. Employers browsing candidates see, for every skill, whether it's **verified** or just **self-reported** — and a transparent trust score that reflects the difference. ## Key Features | Feature | Route | Description | |---|---|---| | Candidate Portal | `/ussd` | A text-first, low-bandwidth UI simulating a feature-phone USSD session. Candidates log in by phone number (or register), add self-reported skills/work history, share their verification code, and check their trust score. | | Employer Dashboard | `/employer` | Post a job, have Groq extract the required skills from the description, and see candidates ranked by a transparent verified-vs-self-reported score breakdown. | | Confirm Portal | `/confirm` | An employer or training provider looks a candidate up by share code and confirms their pending skills/work history with one click, writing a ne …