Backend Services

The backend logic is distributed across several key services, each responsible for a specific domain of the Bosca Framework.

Backend Services

The backend logic is distributed across several key services, each responsible for a specific domain of the Bosca Framework.

Bosca Server

The Bosca Server is the core component of the system (port 8080). It exposes GraphQL and REST APIs for client applications and orchestrates the majority of business logic.

Responsibilities

User Authentication & Authorization
Content Management (collections, metadata, documents, guides)
Workflow Management & Job Processing
AI agent orchestration and chat sessions
Search indexing and querying
Profile and organization management
MCP server for AI client integration
API Gateway for clients

The Analytics Collector is a high-throughput service designed to ingest telemetry data from clients. It processes events asynchronously and persists them using Apache Iceberg for long-term storage.

Responsibilities

Ingest client events (clicks, views, interactions, scrolls, form submissions)
Persist events to Iceberg tables backed by S3-compatible storage
Feed data pipelines for downstream analysis via Trino

Text Extractor

A dedicated utility service for extracting text content from binary files (PDFs, images, etc.), facilitating full-text search and AI processing.

Infrastructure

The Bosca Framework relies on a set of robust infrastructure services to ensure scalability, reliability, and performance.

Deployment

Bosca is designed to be cloud-native and deployable in various environments, from local development machines to large-scale Kubernetes clusters.