RuralConnect

Community WiFi hotspot billing system for a 5-village cluster in Ghana.

Architecture

MikroTik Router ──RADIUS UDP 1812/1813──► Node.js RADIUS Server (VPS)
                                               │
                                               ├── MongoDB (sessions + users)
                                               └── Cloudflare Worker API
                                                        │
                                          ┌─────────────┴─────────────┐
                                   Portal (connect.vclasses.xyz)  Admin Panel

Components

Directory	Purpose
ruralconnect-radius/	Node.js RADIUS server — auth, accounting, session management
ruralconnect-worker/	Cloudflare Workers — portal UI, admin panel, payment webhook
RuralConnect-Setup.md	Full VPS migration + setup guide

Quick Start

See RuralConnect-Setup.md for the complete setup guide including:

• VPS provisioning
• RADIUS server setup
• Cloudflare Workers deploy
• MikroTik configuration
• DNS setup
• PM2 process management

Features

• Prepaid data bundles (daily, weekly, monthly, midnight)
• Paystack payment integration
• Per-plan bandwidth control (Mikrotik-Rate-Limit)
• Night window bundles (10pm–6am, configurable from admin)
• Voucher-based access
• Admin panel: Customers, Devices, Data Plans, Settings
• KV-backed session mirror for offline resilience
• Fallback bridge: RADIUS → HTTPS → Cloudflare → KV