Connect Mavumium

Connect Mavumium: Complete Features & Architecture Guide

By Edward M, Founder of Mavumium

Executive Summary: Connect Mavumium is a verified business discovery and procurement platform for Southern Africa. People can search trusted businesses, compare services, request AI-generated quotations, and post or accept work — with verification and trust signals built in at every step. This is the single reference for what the platform does and how it is built.

Part 1 — User Features

Discovery & Search

  • Public directory of businesses, service providers and members across the SADC region.
  • Navigation search overlay — choose what you are looking for and search by industry, service or location.
  • Relevance-ranked results with verification badges, trust scores and distance.
  • Filters & sorting by reviews, date added, country, price and popularity.
  • No-account browsing: visitors can search and share profiles; creating or accepting work requires an account.

Profiles & Trust

  • Rich profiles: logo, gallery, services, overview, contact, map link and one-click WhatsApp.
  • Verification tiers (phone, document, site) with a composite Trust Score.
  • Reporting of fake, fraudulent or inappropriate profiles, rate-limited per user.

Sharing

  • Share any profile anywhere — WhatsApp, X, Facebook, Telegram, LinkedIn, Email, plus copy-link for Instagram and TikTok.
  • On mobile, the device share sheet is offered as a one-tap option.

Jobs & Hiring

  • Business and Service-Provider accounts can create jobs (title, description, salary, currency, location).
  • Invitations from a profile's menu, restricted to the creator's country.
  • Fair-use limits: weekly job creation quota and a monthly cap on invitations a free account can receive.
  • Accept / Decline with full job details; on acceptance the job card reveals contact details and the WhatsApp click-through.
  • Job creators see which offers were accepted or declined, and the accepter's details card.

Quotations, Notifications & Analytics

  • AI quotation engine producing structured quotes and production-grade PDFs (reference number, issue date, validity, non-binding legal footer).
  • Notifications (in-app + email) for quotation ready, new lead, invitation received, and offer accepted/declined.
  • Analytics: creators see jobs created/accepted/declined and profile views; providers see jobs accepted/declined; businesses see views, quote requests, conversion, rating trend and ranking.

Part 2 — Architecture

Server

Node.js native HTTP server (ESM), no heavy framework — fast and simple to host.

Data

Supabase (PostgreSQL) with Row-Level Security and role-based access.

Storage

Cloudflare R2 (S3 API) for logos, galleries, products and verification documents.

Payments

Paddle for the single paid tier and billing.

Frontend

Server-served static HTML + one vanilla-JS module and a shared stylesheet. Installable PWA with offline fallback.

Observability

PostHog (KPIs), Sentry (errors), with security telemetry for Wazuh and Grafana Loki.

Security posture

  • File-upload security: extension + MIME allowlist (images, PDF, DOCX), a hard 2MB limit, and magic-number sniffing that rejects content whose bytes don't match an allowed type. Executables and archives are refused.
  • Headers: HSTS, a locked-down Content-Security-Policy, X-Content-Type-Options, X-Frame-Options, Referrer-Policy and Permissions-Policy, applied to every response.
  • Sessions: HttpOnly, SameSite cookies with provider-honoured expiry.
  • Rate limiting plus feature-level quotas (searches, job creation, invitations, reports).
  • Privacy & compliance: published Privacy Policy, Terms and Cookie Policy; POPIA/GDPR-aware data export and account deletion.

Image pipeline

Uploads are compressed to high-quality WebP under 2MB on the user's device (including inside the installed PWA) before they ever leave the device, saving bandwidth and storage. The storage layer re-validates content and serves images with long-lived, immutable cache headers via the CDN.

Part 3 — What it is becoming

Connect Mavumium is more than a directory or a quote tool. It is growing into a verified marketplace with real trust scoring, a procurement intelligence engine for faster decisions, and a feedback-driven system that improves over time.

Built for faster decisions, better procurement, and visible trust across Southern Africa. — Edward M, Founder of Mavumium

← Back to Resources