Complete End-to-End Architecture
See how data flows from sources through our unified data layer, AI-powered agent builder, deployment layer, and finally to end users.
Complete E2E Architecture Flow
Loading diagram...
Step-by-Step Breakdown
Connect Data Sources
Connect databases, APIs, Google Drive, webhooks, or upload files. No complex setup required.
- POS systems (Qashier, Eats365, Raptor, Micros, Toast, Lightspeed, StoreHub, Square)
- Databases (PostgreSQL, MySQL, MongoDB, SQL Server, Oracle, DuckDB)
- Cloud warehouses (BigQuery, Snowflake, Redshift, Athena, ClickHouse, Trino)
- File uploads (CSV, Excel, JSON, PDF, Word, PowerPoint, Markdown, HTML, TXT)
- Google Drive files (Docs, Sheets, Slides, PDFs)
- REST APIs (Bearer, API key, OAuth2)
- GraphQL APIs (schema introspection)
- Webhooks for event-driven data
AI Auto-Discovery
Our AI automatically discovers schema, detects relationships, and builds a semantic model. No manual configuration needed.
- Automatic schema discovery (tables, fields, types)
- Relationship detection and MDL generation
- CRAVEVA AI Semantic Layer (natural language to SQL/NoSQL)
- File RAG pipeline (parse → chunk → embed)
- Vector storage (PostgreSQL pgvector migration in Beta V2.0, MongoDB Atlas Vector Search currently)
- Hybrid mode (online sources + offline files)
Build Agents
Build agents with schema-aware configuration, prompt templates, and output settings.
- Prompt Engineering templates + output settings
- Craveva LLM Router (multi-provider models)
- Semantic models (MDL) for SQL/NoSQL generation
- 17 output formats (Text, Chart, Infographic, PDF, PowerPoint, Word, Markdown, CSV, Excel, JSON, HTML, YAML, RTF, XML, SQL, ZIP, Diagram, Flowchart, Org Chart, Process)
- 12 specialized agent types (Sales, Customer Service, Data Analysis, SEO, Design & Social, Internal Coach, Procurement, Search Platform, Search Brand, Auto Acquisition, Delivery Platform, Content Generation)
- Context-aware prompt assembly from data layer
Deploy Anywhere
Deploy agents to messaging, e-commerce, or custom systems with multiple integration options.
- Messaging webhooks (WhatsApp connector)
- E-commerce widgets (Shopify, WordPress, WooCommerce, Magento, BigCommerce)
- Custom systems (Widget embed, REST API, Webhook)
- 6 code formats (JavaScript, TypeScript, React, Vue, Svelte, Angular)
- Deployment packages with ZIP + test HTML
- Multi-outlet deployment support
Users Chat & Get Answers
End users interact with agents using natural language and receive answers backed by live or document data.
- Natural language interface
- Live answers from databases and APIs
- RAG answers from documents
- Role-based access and tenant isolation
- Optional widget authentication for online sources
Data Flow Sequence
Loading diagram...
This sequence diagram shows how data flows through the system from initial connection through agent execution and user interaction.
Architecture Components
Data Layer
Unified access for databases, APIs, files, and Google Drive
- Connectors for databases, REST/GraphQL, webhooks, Google Drive, and files
- Auto schema discovery + relationship detection
- File RAG pipeline with worker-thread parsing + chunking
- Vector store routing (PostgreSQL pgvector migration in Beta V2.0, MongoDB Atlas Vector Search currently)
- CRAVEVA AI Semantic Layer (NL → SQL/NoSQL)
- Hybrid query engine (online + offline sources)
AI Layer
AI-assisted agent builder
- Prompt Engineering templates + output settings
- Craveva LLM Router
- Semantic model (MDL) creation and management
- Output format handling (tables, markdown, JSON)
- 12 agent types (sales, support, data, SEO, procurement, etc.)
- Context-aware prompt assembly from data layer
Deployment Layer
Universal deployment to any platform
- Messaging webhooks (WhatsApp connector)
- E-commerce widgets (Shopify, WordPress, WooCommerce, Magento, BigCommerce)
- Custom systems (Widget embed, REST API, Webhook)
- 6 code formats (JS, TS, React, Vue, Svelte, Angular)
- Deployment packages with ZIP + test HTML
- Multi-outlet deployment (company-wide or outlet-specific)
Infrastructure & Security
Enterprise-grade platform
- Multi-tenant isolation (company + outlet filters)
- AES-256-GCM encryption for sensitive data
- Role-based access control (admin, super admin, master admin)
- JWT authentication (access + refresh tokens)
- Audit logging (ActivityLog tracking)
- HTTPS/TLS in transit
Upcoming Architecture Enhancements
Beta 1.0: Charts & Tools
Beta V1.0 (Jan 14, 2026)Jan 14 - Feb 13, 2026
- 30+ enterprise chart types for data visualization
- Support ticket chat functionality
- Enhanced output format generation
Beta 2.0: Performance & Builder
Beta V2.0 (Feb 14, 2026)Feb 14 - Mar 13, 2026
- 10-100x RAG performance with multi-layer caching
- PostgreSQL pgvector migration (70-80% faster queries)
- Google Drive file selection in agent builder
- REST/GraphQL/Webhook data previews
- BullMQ queue system for horizontal scaling