bucky-ops/Uhasibu-Platform

Kenya-focused prediction market MVP (academic prototype). Secure PWA with OTP auth, virtual currency trading, admin tools, and safeguards. Built with Next.js, Express, Postgres RLS, Docker, and AWS Africa deployment. # Uhasibu Prediction Market Platform > **Kenya-Focused Web-First Prediction Market MVP (Academic Prototype)** A research platform developed for university academic research to study prediction markets using virtual currency. This platform enables academic research on market dynamics, user behavior, and forecasting accuracy in a controlled environment. ## 🎓 Overview Uhasibu (Swahili for "calculation/prediction") is an academic research tool designed to explore how prediction markets function in the Kenyan context. The platform uses virtual currency (vKES) to simulate real market dynamics while maintaining strict ethical research protocols. ### Key Features - **🔐 Age-Gated Access**: Strict 18+ verification for research participants - **📱 OTP Authentication**: Secure login via Kenyan phone numbers (+254) - **🌍 Bilingual Support**: Full English and Swahili localization - **💰 Virtual Currency**: Play money (vKES) system for risk-free participation - **📊 Market Trading**: Create and participate in prediction markets - **👤 User Profiles**: Demographic data collection for research purposes - **📈 Portfolio Management**: Track positions and performance - **🛡️ Admin Dashboard**: Research oversight and market management ## 🏗️ Architecture ### Tech Stack - **Frontend**: Next.js 14 (Pages Router) + React 18 + Tailwind CSS - **Backend**: Node.js + Express.js - **Database**: PostgreSQL 15 - **Authentication**: JWT + Africa's Talking SMS OTP - **Admin Panel**: Next.js 14 (separate dashboard) - **Containerization**: Docker + Docker Compose - **Reverse Proxy**: Nginx ### Project Structure ``` unasibu/ ├── frontend/ # Next.js user-facing application │ ├── pages/ # Page routes │ ├── components/ # React components │ ├── styles/ # Global styles │ └── public/ # Static assets ├── backend/ # Express.js API server │ ├── src/ │ │ ├── routes/ # API endpoints │ │ ├── middleware/ # Auth & valid …