Skip to content

Repository files navigation

⚡ Zero-Framework, High-Concurrency Multi-Tenant RAG Engine

A production-grade, multi-tenant conversational AI platform designed for educational institutions, sports academies, and subscription-driven organizations.

The system enables parents and customers to:

  • ✅ Check attendance and class participation
  • ✅ View outstanding dues and payment status
  • ✅ Generate real-time payment links
  • ✅ Query handbooks, policies, and FAQs using semantic search
  • ✅ Interact through natural language conversations

Built entirely with native Node.js (ES Modules) and production-oriented cloud services, the platform avoids heavyweight AI orchestration frameworks to maintain complete control over:

  • Token consumption
  • Retrieval logic
  • Multi-turn conversation state
  • Tenant isolation
  • Cost optimization
  • Operational transparency

🏛️ Architecture Overview

This solution follows a Cloud–Local Hybrid Architecture that combines:

  1. Structured business-data retrieval
  2. Semantic document retrieval (RAG)
  3. LLM-powered reasoning
  4. Strict tenant isolation

The system processes natural language queries, extracts business intent, retrieves relevant structured and unstructured data, and generates grounded responses.


🚀 Key Capabilities

Parent & Customer Self-Service

  • Attendance lookup
  • Fee and dues tracking
  • Payment-link generation
  • Subscription status retrieval
  • Policy and handbook search

Multi-Tenant Isolation

Each tenant maintains:

  • Independent vector collections
  • Dedicated business data scope
  • Tenant-aware retrieval pipelines
  • Secure context boundaries

High-Concurrency Design

Engineered for:

  • Large user populations
  • Concurrent conversations
  • Low-latency retrieval
  • Controlled LLM token usage

🧠 Retrieval-Augmented Generation (RAG)

The platform combines:

Structured Retrieval

Used for:

  • Attendance
  • Outstanding balances
  • Subscription status
  • Payment workflows

Semantic Retrieval

Used for:

  • Handbooks
  • Policies
  • FAQs
  • Institutional documentation

Only relevant content is injected into the LLM context window, minimizing hallucinations and reducing token costs.


⚙️ Design Principles

No Heavy AI Frameworks

Instead of abstractions such as:

  • LangChain
  • LlamaIndex

the platform uses custom orchestration to provide:

  • Predictable execution paths
  • Full debugging visibility
  • Fine-grained prompt control
  • Lower operational overhead

Tenant-First Architecture

Every request is resolved using:

  • Tenant context
  • User context
  • Retrieval boundaries
  • Authorization constraints

Cost Efficiency

The system minimizes:

  • Embedding calls
  • Retrieval payload size
  • Prompt inflation
  • Unnecessary LLM invocations

📈 Typical Request Flow

User Question
      │
      ▼
Intent Extraction
      │
      ▼
Parameter Resolution
      │
      ▼
Structured Data Retrieval
      │
      ├── Attendance
      ├── Dues
      └── Payments
      │
      ▼
Semantic Search
      │
      ▼
Context Assembly
      │
      ▼
LLM Response Generation
      │
      ▼
Grounded Answer

🎯 Target Use Cases

  • Schools
  • Coaching institutes
  • Sports academies
  • Dance academies
  • Music academies
  • Subscription-based organizations
  • Membership-driven businesses

🛠 Technology Stack

  • Node.js (ES Modules)
  • Vector Database (Qdrant / equivalent)
  • Embedding Models
  • LLM APIs
  • Cloud Functions / Serverless Compute
  • Firestore / Document Database

📌 Core Objective

Deliver a transparent, scalable, and production-ready conversational AI platform that combines business-data retrieval and semantic search while maintaining strict tenant isolation, operational simplicity, and predictable costs.

About

Multi-tenant conversational AI platform for schools and academies. Provides attendance tracking, fee management, semantic search across handbooks/policies, and strict tenant isolation. Built with Node.js, Firestore, and vector search for hybrid structured + semantic retrieval.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages