Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

HH-Felidae Architecture

System Architecture Diagram

System Architecture Diagram

Data Flow Architecture

Data Flow Architecture

Component Architecture

Component Architecture

Technology Stack

Technology Stack

Deployment Architecture

Deployment Architecture

Key Data Pipelines

1. Restaurant Data Pipeline

Restaurant Data Pipeline

2. User Interaction Pipeline

User Interaction Pipeline

3. Search & Ranking Pipeline

Search & Ranking Pipeline

Architecture Principles

  1. Microservices Architecture: Separated concerns with Jaguar (frontend), Tiger (core backend), and Puma (search service)
  2. Event-Driven: Kafka-based event streaming for asynchronous data processing
  3. Multi-Database: Separate databases for different concerns (legacy, warehouse, application)
  4. GraphQL First: All client-server communication through GraphQL APIs
  5. Background Processing: BullMQ for async job processing and data pipelines
  6. ML Integration: AWS Personalize for recommendation engine
  7. Search Optimization: OpenSearch with Metarank for intelligent search and ranking
  8. Monorepo Structure: Turborepo for efficient build and development workflow
  9. Type Safety: End-to-end TypeScript with generated GraphQL types
  10. Observability: Rollbar for errors, Elastic APM for performance monitoring

Service Responsibilities

Jaguar (Admin Dashboard) : https://jaguar.hungryhub.com

  • Admin UI for content management
  • Banner and section management
  • Restaurant tag management
  • User and analytics dashboards
  • File upload management

Tiger (Core Backend) : https://tiger.hungryhub.com/

  • User authentication and authorization
  • CMS content management
  • Restaurant data processing
  • ML training data preparation
  • AWS Personalize integration
  • Multi-database orchestration
  • Background job coordination

Puma (Search Service) : https://puma-internal.hungryhub.com/bullmq

  • Restaurant search functionality
  • OpenSearch index management
  • Search result ranking (Metarank)
  • Search suggestions and autocomplete
  • Restaurant discovery and filtering

Infrastructure Services

GrowthBook

  • Feature flag management
  • A/B testing experiments
  • Progressive rollouts

Metarank

  • Learning-to-rank engine
  • Personalization signals
  • Ranking model training

Kafka Ecosystem

  • Event streaming platform
  • Data pipeline coordination
  • Change data capture (CDC)
  • S3 data archival

OpenSearch

  • Full-text search engine
  • Restaurant indexing
  • Faceted search
  • Geospatial queries