What is NIVAA?
NIVAA is a blind matchmaking and operations platform for tutoring workflows. It connects parents with tutors through a coordinator-managed process, handling scheduling, session tracking, billing, and communication.
Who is this documentation for?
Coordinators, tutors, and developers who need to understand how the platform works. Each section is written as a practical reference, not a tutorial.
Core Concepts
The platform operates on a blind matching model. Parents never see tutor identities until a match is formally accepted. Coordinators sit in the middle, reviewing applications and pushing the best-fit tutors to parents.
Postings Parents post their tutoring needs. Tutors browse and apply. Coordinators review and push matches.
Sessions Scheduled appointments with check-in/out, notes, AI summaries, and a multi-step approval flow.
Billing Prepaid session packages, monthly billing cycles, tutor payouts, and discount management.
Telegram Bot Real-time session management, reminders, check-in/out, and coordinator dashboards via Telegram.
Quick Links
Architecture Stack, infrastructure, and data flow
Session Lifecycle Statuses, check-in rules, approval flow
Matching & Postings How tutors get matched to students
Billing & Packages Prepaid packages, invoices, payouts
Telegram Bot Commands, reminders, session changes
API Reference Authentication, endpoints, schemas
Platform Roles
| Role | Description | Access |
|---|---|---|
Admin | Platform coordinators who manage all operations | Full access to all data, matching, billing, and admin tools |
Tutor | Educators who deliver tutoring sessions | Own sessions, matched students, postings, payout info |
Parent | Parents/guardians managing their children's tutoring | Children profiles, sessions, approvals, issue reports |
Key Workflows
- 1 Parent registers and creates child profiles with intake information (learning needs, subjects, availability).
- 2 Parent creates a posting describing what they need (subject, schedule, location, special requirements).
- 3 Tutors browse and apply to open postings that match their skills and availability.
- 4 Coordinators review applications, score matches across 5 dimensions, and push the best-fit tutor to the parent.
- 5 Parent accepts or declines. On acceptance, sessions are auto-scheduled and a discount may apply.
- 6 Sessions run weekly with Telegram-based check-in/out, notes, and AI-generated summaries.
- 7 Parents approve sessions and billing is tracked against prepaid packages.