kingenious0/student-hub

LaHustle is a powerful marketplace for students in USTED (FORMALY AAMUSTED) and students across Ghana LaHustle (Student Marketplace & Hub) A premium, secure campus marketplace and vendor engagement platform designed for university student micro-economies. --- ## 👨‍💻 Lead Developer & Author * **Lead Developer & System Architect:** **Elliot Paakow Entsiwah (Kingenious)** * **Role:** Student Founder & Lead Software Engineer * **University Affiliate:** USTED --- ## 📖 Project Overview **LaHustle** is an all-in-one student micro-marketplace platform. It connects student buyers with trusted campus vendors in a unified ecosystem. The platform enforces security through a custom-built escrow payment settlement loop, dynamic verification, and logical hotspot geolocation tracking. The repository contains: * **`student-hub/`**: The Next.js App Router merchant dashboard, administrative command centers, and API backend. * **`student-mobile/`**: The companion React Native (Expo SDK 54) mobile app targeting on-the-go student users. --- ## 🛠️ Core Tech Stack * **Frontend & Server Components**: Next.js 16 (App Router + Turbopack) | React 19 | Tailwind CSS v4 * **Database & Persistence Layer**: PostgreSQL | Prisma ORM 5.10.2 (Cloud-optimized configuration) * **Authentication & Identity**: Clerk (Custom session synchronization and JWT verification) * **Media Assets**: Cloudinary CDN (Signed uploads for product images, vendor stories, and verification) * **Payments Infrastructure**: Paystack Inline SDK v2 (Live/Sandbox gateway with automated webhook signature validation) --- ## 🚀 Key Architectural Highlights ### 1. QR-Escrow Settlement Loop 🛡️ To eliminate peer-to-peer transaction risk on campus: * Payments made via Paystack are held securely in a database-backed `HELD` state. * The buyer receives an AES-256 encrypted transaction payload encapsulated in a QR code. * To complete the order and release the funds to the seller, the vendor scans the QR code at the physical handover. The system decrypts the payload and triggers a single, atomic database transaction to …