About This Architecture
Hypequery Semantic Layer in TypeScript provides a unified abstraction over ClickHouse analytics stores, enabling consistent metric and dimension definitions across all consumer applications. Data flows from ClickHouse through the semantic layer to multiple entry points: Inline SDK for embedded analytics, HTTP API for backend services, React Hooks for frontend dashboards, and MCP Server for AI agent integration. This architecture decouples business logic from query implementation, reducing duplication and ensuring metric consistency across teams. Fork this diagram on Diagrams.so to customize entry points, add authentication layers, or extend with additional data stores. The multi-consumer design supports both traditional BI tools and modern AI-driven analytics workflows.