ifeanyiokomba/trustscore

Trust infrastructure for transactions, identity and reputation across Africa. Nigeria-first. Next.js 16 + TypeScript + Prisma + shadcn/ui. Mock-provider sandbox. # TrustScore > **The trust infrastructure for transactions, identity and reputation across Africa.** Nigeria-first. Before you send money, extend credit, hire, rent, sell on credit, or enter a transaction — obtain a fast, **explainable** trust assessment. TrustScore sits *above* existing KYC/identity infrastructure as a trust-decision and reputation layer, normalizing authorized evidence from identity, banking, telecom and reputation systems. > ⚠️ **This deployment uses MOCK sandbox providers only.** No live government or bank integration is claimed or implied. Every verification result is simulated to exercise provider-resilience paths. ## Product principles 1. **Trust over growth** — never generate fake verification data; never imply a mock is a live integration. 2. **Evidence before score** — a score is an aggregation of evidence, never an unexplained number. 3. **Explainability** — every score returns its signals, dimensions and policy version. 4. **Human appeal** — a person can contest a materially harmful decision (Flag → Resolution). 5. **Data minimization** — raw NIN/BVN are **hashed**; only masked references are stored centrally. 6. **Provider independence** — Primary → Secondary → Fallback → Manual Review. ## Stack - **Next.js 16** (App Router) + **TypeScript 5** - **Tailwind CSS v4** + **shadcn/ui** (New York) + **Lucide** icons + **Framer Motion** - **Prisma ORM** + SQLite (evidence-graph domain model) - **Recharts** (B2B analytics) + **next-themes** (dark mode) + **Zustand** (nav state) + **Sonner** (toasts) ## Trust Decision Engine | Dimension | Range | |---|---| | Identity confidence | 0 – 200 | | Account confidence | 0 – 200 | | Phone confidence | 0 – 100 | | Reputation / risk | −250 … +100 | | Resolution / consistency | −100 … +100 | Final score constrained `300 ≤ score ≤ 1000` (or `−1` = `UNKNOWN` when evidence is insufficient). | Band | Range | Decision | |---|---|---| | CRITICAL | 300–449 | Decline | | HIGH | 450–549 | Decline | | ELEV …