TutorHub Educational Platform

TutorHub is an educational platform connecting students with tutors for personalized learning experiences. Features include tutor profiles, course packs, scheduling, enrollments, and payment processing.

This documentation is designed to be consumed by both humans and AI agents. It provides comprehensive information about the backend services, APIs, data models, and integration patterns.

Detailed Documentation Files

For comprehensive documentation, the following detailed files are available:

Documentation Overview

TutorHub Educational Platform

Version : 1.0.502

TutorHub is an educational platform connecting students with tutors for personalized learning experiences. Features include tutor profiles, course packs, scheduling, enrollments, and payment processing.

How to Use Project Documents

The Tutorhub project has been designed and generated using Mindbricks, a powerful microservice-based backend generation platform. All documentation is automatically produced by the Mindbricks Genesis Engine, based on the high-level architectural patterns defined by the user or inferred by AI.

This documentation set is intended for both AI agents and human developers—including frontend and backend engineers—who need precise and structured information about how to interact with the backend services of this project. Each document reflects the live architecture of the system, providing a reliable reference for API consumption, data models, authentication flows, and business logic.

By following this documentation, developers can seamlessly integrate with the backend, while AI agents can use it to reason about the service structure, make accurate decisions, or even generate compatible client-side code.

Accessing Project Services

Each service generated by Mindbricks is exposed via a dedicated REST API endpoint. Every service documentation set includes the base URL of that service along with the specific API paths for each available route.

Before consuming any API, developers or agents must understand the service URL structure and environment-specific endpoints.

Service Endpoint Structure

Environment URL Pattern Example
Preview https://tutorhub.prw.mindbricks.com/auth-api
Staging https://tutorhub-stage.mindbricks.co/auth-api
Production https://tutorhub.mindbricks.co/auth-api

Replace auth with the actual service name as lower case (e.g., order-api, bff-service, customermanagement-api etc.).

Environment Usage Notes

Frontend applications should be designed to easily switch between environments, allowing dynamic endpoint targeting for Preview, Staging, and Production.

Getting Started: Use the Auth Service First

Before interacting with other services in the Tutorhub project, AI agents and developers should begin by integrating with the Auth Service.

Mindbricks automatically generates a dedicated authentication microservice based on the project’s authentication definitions provided by the architect. This service provides the essential user and access management foundation for the project.

Agents should first utilize the Auth Service to:

Auth Service Documentation

Use the following resources to understand and integrate the Auth Service:

Note: For most frontend use cases, the REST API Guide will be the primary source. The Event Guide and Service Design documents are especially useful when integrating with other backend microservices or building systems that interact with the auth service indirectly.

Using the BFF (Backend-for-Frontend) Service

In Mindbricks, all backend services are designed with an advanced CQRS (Command Query Responsibility Segregation) architecture. Within this architecture, business services are responsible for managing their respective domains and ensuring the accuracy and freshness of domain data.

The BFF service complements these business services by providing a read-only aggregation and query layer tailored specifically for frontend and client-side applications.

Key Principles of the BFF Service

BFF Service Documentation

Tip: Use the BFF service as the main entry point for all frontend data queries. It simplifies access, reduces round-trips, and ensures that data is shaped appropriately for the UI layer.

Business Services Overview

The TutorHub Educational Platform project consists of multiple business services, each responsible for managing a specific domain within the system. These services expose their own REST APIs and documentation sets, and are accessible based on the environment (Preview, Staging, Production).

Usage Guidance

Business services are primarily designed to:

For advanced query needs across multiple services or aggregated views, prefer using the BFF service.

Available Business Services

tutorCatalog Service

Description: Handles tutor public profiles, course packs, public categories, and course pack materials with strict public/private access enforcement for course pack content and materials.

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/tutorcatalog-api
Staging https://tutorhub-stage.mindbricks.co/tutorcatalog-api
Production https://tutorhub.mindbricks.co/tutorcatalog-api

courseScheduling Service

Description: Handles all scheduling: tutor availability, lesson slot management/booking, preliminary meeting scheduling for screened courses. Ensures schedule privacy (authenticated only).

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/coursescheduling-api
Staging https://tutorhub-stage.mindbricks.co/coursescheduling-api
Production https://tutorhub.mindbricks.co/coursescheduling-api

enrollmentManagement Service

Description: Handles enrollments (course booking, lesson/slot allocation, fulfillment/pre-check, and payment via Stripe) and refund workflow (strictly after first lesson only, auto approved, and Stripe-based). Exposes all enrollment/payment/refund status for admins, tutors, and students. All business state transitions are auditable for analytics and compliance.

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/enrollmentmanagement-api
Staging https://tutorhub-stage.mindbricks.co/enrollmentmanagement-api
Production https://tutorhub.mindbricks.co/enrollmentmanagement-api

platformAdmin Service

Description: No description provided.

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/platformadmin-api
Staging https://tutorhub-stage.mindbricks.co/platformadmin-api
Production https://tutorhub.mindbricks.co/platformadmin-api

messaging Service

Description: Real-time messaging service: student-tutor chat (bidirectional), admin-student warnings (one-way), admin-tutor communication (bidirectional). Uses RealtimeHub for WebSocket chat with persistence, typing, and read receipts.

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/messaging-api
Staging https://tutorhub-stage.mindbricks.co/messaging-api
Production https://tutorhub.mindbricks.co/messaging-api

agentHub Service

Description: AI Agent Hub

Documentation:

Base URL Examples:

Environment URL
Preview https://tutorhub.prw.mindbricks.com/agenthub-api
Staging https://tutorhub-stage.mindbricks.co/agenthub-api
Production https://tutorhub.mindbricks.co/agenthub-api

Connect via MCP (Model Context Protocol)

All backend services in the Tutorhub project expose their Business APIs as MCP tools. These tools are aggregated by the MCP-BFF service into a single unified endpoint that external AI tools can connect to.

Unified MCP Endpoint

Environment StreamableHTTP (recommended) SSE (legacy fallback)
Preview https://tutorhub.prw.mindbricks.com/mcpbff-api/mcp https://tutorhub.prw.mindbricks.com/mcpbff-api/mcp/sse
Staging https://tutorhub-stage.mindbricks.co/mcpbff-api/mcp https://tutorhub-stage.mindbricks.co/mcpbff-api/mcp/sse
Production https://tutorhub.mindbricks.co/mcpbff-api/mcp https://tutorhub.mindbricks.co/mcpbff-api/mcp/sse

Authentication

MCP connections require authentication via the Authorization header:

OAuth is not supported for MCP connections at this time.

Connecting from Cursor

Add the following to your project’s .cursor/mcp.json:

{
  "mcpServers": {
    "tutorhub": {
      "url": "https://tutorhub.prw.mindbricks.com/mcpbff-api/mcp",
      "headers": {
        "Authorization": "Bearer sk_mbx_your_api_key_here"
      }
    }
  }
}

Connecting from Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "tutorhub": {
      "url": "https://tutorhub.prw.mindbricks.com/mcpbff-api/mcp",
      "headers": {
        "Authorization": "Bearer sk_mbx_your_api_key_here"
      }
    }
  }
}

What’s Available

Once connected, the AI tool can discover and call all Business API tools from all services — CRUD operations, custom queries, file operations, and more. The MCP-BFF handles routing each tool call to the correct backend service and propagates your authentication context.

Conclusion

This documentation set provides a comprehensive guide for understanding and consuming the TutorHub Educational Platform backend, generated by the Mindbricks platform. It is structured to support both AI agents and human developers in navigating authentication, data access, service responsibilities, and system architecture.

To summarize:

Each service offers a complete set of documentation—REST API guides, event interface definitions, and design insights—to help you integrate efficiently and confidently.

Whether you are building a frontend application, configuring an automation agent, or simply exploring the architecture, this documentation is your primary reference for working with the backend of this project.

For environment-specific access, ensure you’re using the correct base URLs (Preview, Staging, Production), and coordinate with the project owner for any custom deployments.

Table of Contents

Getting Started

Frontend Prompts

Auth Service

Data Objects

Business APIs

Database Buckets

TutorCatalog Service

Data Objects

Business APIs

CourseScheduling Service

Data Objects

Business APIs

EnrollmentManagement Service

Data Objects

Business APIs

PlatformAdmin Service

Data Objects

Business APIs

Messaging Service

Data Objects

Business APIs

Realtime Hubs

AgentHub Service

Data Objects

Business APIs

Bff Service

Notification Service

LLM Documents

API Endpoints Summary

tutorhub-auth-service Service

tutorhub-tutorcatalog-service Service

tutorhub-coursescheduling-service Service

tutorhub-enrollmentmanagement-service Service

tutorhub-platformadmin-service Service

tutorhub-messaging-service Service

tutorhub-agenthub-service Service

Getting Started

  1. Authentication: Start with the Auth Service to register and authenticate users
  2. Data Queries: Use the BFF Service for optimized read-only data queries
  3. Business Operations: Use individual business services for create/update/delete operations

Additional Resources

Generated by Mindbricks Genesis Engine