ConnectBud Platform Architecture
A high-concurrency role-based tutoring and counselling marketplace built around a unified financial ledger, multi-gateway escrow payments, multi-tier referral programs, internal wallets, and centralized operational administration.
Executive Summary
ConnectBud v3 was engineered to solve complex trust, escrow, and multi-sided billing challenges for private tutoring and college counselling. The platform harmonizes 6 distinct user roles across Web and Mobile with a central, immutable ledger.
Project Overview
Problem Statement
- Escrow & Disintermediation Risk: Preventing off-platform payments while eliminating payment fraud for parents and wage uncertainty for tutors.
- Ledger Fragmentation: Consolidating disparate refunds, partial escrow releases, multi-gateway fee deductions, and affiliate commissions into one double-entry ledger.
- Multi-Role Permissions: Enforcing strict, partitioned access boundaries across six concurrent persona types without duplicating core data abstractions.
What the Platform Does
- Discovery & Booking: Parents search verified educators, schedule live sessions, and secure funds in escrow.
- Tutor Workspace: Educators manage custom calendars, deliver curriculum milestones, and execute instant wallet withdrawals.
- Counsellor Vertical: Dedicated admissions counselling booking with minimum-session rules and payout splits.
- Dual Growth Engine: Automated QR/link onboarding for External Agents and internal peer Tutor Buddies.
Scope & Core Subsystems
The production solution encompasses an integrated suite of web, mobile, asynchronous workers, and messaging engines.
| Subsystem | Core Capability & Deliverable |
|---|---|
| Web Portal | Role-aware React SPA: Marketplace catalogue, lesson booking, counsellor portal, and administrative control center. |
| Mobile App | Cross-platform client: Push notifications, live chat, session calendar, mobile wallet passbook, and booking checkout. |
| Mailbud Engine | 30+ transactional and scheduled email flows: Account activation, milestone notifications, escrow receipts, and review requests. |
| Cronjob Orchestrator | Automated background workers: 24h lesson reminders, referral commission expiry calculations, unattended class alerts, and S3 reporting. |
| Tutor Module | Multi-attribute skill tagging, variable hourly pricing, timezone availability calendar, and background verification pipeline. |
| Counsellor Tier | US college credentials vetting, minimum 2-session bundle packaging, client reviews, and direct 82% net settlement. |
| Referral Network | Dual onboarding funnel: External agent partner engine (10%) and peer-to-peer Tutor Buddy incentive network (5%). |
Core Marketplace & Escrow Flows
At the heart of the booking system is the hierarchical ProjectRequest and ProjectMilestone model, ensuring granular accounting for every single lesson.
Escrow Lifecycle & Milestone Governance
Parent books milestone; funds placed in escrow (state: ESCROW_HELD).
Class is delivered; dual verification requires Parent + Tutor completion timestamps.
Escrow transitions RELEASED. Funds credited to Tutor internal wallet.
Automated achievement certificate generated every 25 completed/released classes.
- • Free Demo: Zero-dollar discovery lesson with automated trial guardrails.
- • Milestone: Standard pay-as-you-go sequential lesson progression.
- • Pick Tutor: Direct parent recruitment of curated specialist educators.
- • Summer Camp: Cohort-based multi-week bundled educational intensives.
- • Minimum Commitment: Bundles require a strict minimum of 2 sessions.
- • Flexible Checkout: Payable via Stripe, PayPal, Wallet, or Admin Cash.
- • Webhook Activation: Gateway checkouts activate asynchronously via webhooks; wallet debits finalize synchronously.
- • Net Remittance: Counsellor receives 82% gross revenue upon delivery.
Agent Referral & Tutor Buddy Network
Instead of building fragmented affiliate modules, CBNITS architected a unified Agent model that handles both external acquisition partners and internal educator advocates.
| Program | Target Audience | Commission | Strategic Purpose & Incentive |
|---|---|---|---|
| External Agent | Parents & Students | 10% | Drives top-of-funnel student enrollment through educational consultants and affiliates. |
| Tutor Buddy | New Tutors & Educators | 5% | Incentivizes top-performing tutors to recruit peer educators, ensuring rapid qualified tutor supply. |
Commission Rules & Attribution
Attribution operates via QR codes and unique referral tokens. Commissions are active for up to 1 full year from the referee registration date and trigger on each completed milestone.
Duplicate Prevention
Database unique constraints prevent duplicate commissions per milestone. Admins manage payout batches, view live ledger balances, and audit verified bank coordinates.
Counsellor Vertical Integration
College admissions counselling was built as a premium, additive tier, seamlessly reusing existing authentication, payment orchestration, and moderation infrastructure.
Admin-Vetted Credentials
Counsellor accounts are provisioned via admin; resumes stored in secure private S3 buckets; validated against US university credentials.
Bundle Requirements
Enforces a minimum 2-session purchase to maintain educational continuity; supports all 4 payment pathways.
82% Net Revenue Split
Upon session completion, 82% of gross booking automatically clears to CounsellorWallet, with 18% retained as platform fee.
1-to-1 Verified Reviews
Only verified clients who complete a booking can submit a 1–5 star rating, eliminating astroturfing and fake reviews.
Dedicated Bank Registry
Isolated CounsellorBankDetail schema records routing, account tokens, and KYC statuses for wire settlement.
Admin Publication Control
Operations teams hold granular toggles to publish, pause, or audit profiles and individual client reviews.
Unified Ledger & Wallet Safety Architecture
To prevent multi-gateway reconciliation drift, ConnectBud enforces a single source of financial truth: the central TransactionHistory audit ledger.
Double-Entry Ledger Integrity
Tracks fees, escrow releases, commissions, refunds, and adjustments in real-time.
Supported Gateways & Channels
# Protect concurrent wallet credit/debit:
with transaction.atomic():
wallet = UserWallet.objects.select_for_update().get(user_id=uid)
if wallet.balance >= required_fee:
wallet.balance -= required_fee
wallet.save()
TransactionHistory.record_debit(...)select_for_update() prevents race conditions between simultaneous webhook completions and client withdrawals.Centralized Admin Console & Controls
Operations and financial teams manage all six roles through a unified operational command center.
User Lifecycle Governance
Verification, background-check status toggling, role reassignments, credential resets, and account deactivation across tutors, parents, mentors, and counsellors.
Booking & Project Intervention
Tutor reassignment on unattended classes, skill tag modifications, project closures, milestone dispute arbitration, and certificate regeneration.
Wallet & Payout Authorizations
Manual escrow release overrides, withdrawal review batches, affiliate agent payouts, counsellor ledger adjustments, and refund approvals.
Communication & Content Moderation
Live moderation of student-tutor chat logs, community feed posts, verified reviews, and homepage educator testimonials.
Mailbud — Transactional Email Infrastructure
Mailbud is ConnectBud internal transactional, engagement, and batch communication service designed to handle educational notifications reliably.
Automated Scheduled Workflows
Reporting & Deliverable Artifacts
The platform generates structured data artifacts and operational reports stored securely in AWS S3 and delivered via expiring pre-signed URLs.
Excel (.xlsx) Reports
Comprehensive exports for Operations, Finance, and external partners covering users, transactions, and agent balances.
Pre-Signed S3 URLs
Time-limited, cryptographically signed S3 URLs guarantee confidential exports are delivered only to authorized administrators.
PDF Certificates
Automated PDF generation engine issues student & tutor milestone certificates every 25 successfully completed lessons.
Technical Glossary
Value for Future Engagements
The patterns established in the ConnectBud build provide modular, enterprise-proven building blocks for any organization developing multi-sided transactional applications:
Extensible Role Architecture
New actor personas (such as Counsellor or Tutor Buddy) inherit existing authentication, payments, and admin foundations without separate codebase forks.
Unified Financial Ledger
One immutable ledger acts as the definitive source of truth for audits, automated reconciliation, tax accounting, and operational reporting.
Multi-Gateway Abstraction
Payment providers (Stripe, PayPal, internal wallet, cash) sit behind a unified checkout facade, isolating third-party API changes to localized drivers.
Composable Referral Engine
A single extensible Agent model powers multiple acquisition loops (External Agent + Tutor Buddy) with zero duplicate attribution or payout collision.
Reusable Review Architecture
Counsellor reviews seamlessly extend the marketplace feedback pattern with verified-booking gating, 1–5 star scoring, and admin visibility controls.
Shared Excel + S3 Pipeline
Heavy background reporting exports to .xlsx with expiring pre-signed S3 URLs as a shared platform service across all marketplace modules.
Conclusion
ConnectBud v3 combines tutoring, counselling, referral acquisition, wallets and multi-gateway payments in one operational platform.
Key source-backed scale indicators: 6 roles, 4 project categories, 4 payment methods, 2 referral tiers, 3 wallet types and 30+ email templates, with Excel/S3 reporting and a unified financial ledger.
The Counsellor module adds a second paid service vertical, while Tutor Buddy adds a structured tutor-acquisition channel.
Have an ambitious marketplace or platform initiative?
Schedule a confidential technical scoping session with our senior architects to discuss your platform requirements.