Adminmove/MoveEasy

MoveEasy is a shared fintech infrastructure platform built for the South African market. It provides a single technical foundation — one SSO, one unified wallet, once-only KYC, shared PayFast merchant account, and a central AI brain — that powers five distinct consumer and B2B financial products. # MoveEasy — The Central Nervous System for African Fintech **Version:** 2026.1.0 **Reg No:** 2025/104466/07 **Stack:** Node.js · PostgreSQL · AWS af-south-1 · PayFast · Nedbank · Purple Owl Payments **Compliance:** SARB · FICA · POPIA · AML · PCI-DSS --- ## Ecosystem Overview ``` MoveEasy Core Brain (AI Orchestrator) ├── EasyFuel — Geo-locked fuel pre-purchase & FuelFlex BNPL ├── EasyTransect — Mobile money liquidity bridge (SA banks) ├── SafeBet — ZAR→USDC yield savings for bettors ├── GreenWallet — ESG project marketplace & carbon credits └── MMP.ai — Africa-to-China B2B sourcing agent (ARIA) ``` **Shared Infrastructure Backbone:** - Single Sign-On (SSO) via Supabase Auth - Unified Wallet (ecosystem_sync ledger) - Once-only KYC via Smile ID - Shared PayFast merchant account - Purple Owl Payments (Softy Comp) for card processing - Nedbank Nedlink for POS/e-commerce acquiring - AWS af-south-1 (Cape Town — POPIA data residency) --- ## Quick Start ```bash # 1. Clone and install npm install # 2. Set environment variables cp .env.example .env # Fill in all API keys # 3. Initialize database psql -U postgres -f database/schema.sql psql -U postgres -f database/seed.sql # 4. Start backend cd backend && npm run dev # 5. Open any frontend # Open frontend/moveeasy-core/index.html in browser # Or serve: npx serve frontend/moveeasy-core ``` --- ## Directory Structure ``` moveeasy/ ├── backend/ # Node.js API server │ └── src/ │ ├── config/ # DB, env, constants │ ├── middleware/ # Auth, KYC, rate limiting │ ├── routes/ # Per-product API routes │ ├── services/ # Payment & AI integrations │ ├── models/ # PostgreSQL query models │ └── jobs/ # BullMQ async workers ├── database/ │ ├── schema.sql # Full PostgreSQL schema │ └── seed.sql # Demo data ├── frontend/ │ ├── moveeasy-core/ …