Architecture — Overview

Welcome to the Marchay Platform architecture documentation. This wiki covers the four core architecture domains of the platform.

System Architecture

Architecture Domains

Agent Architecture

The hierarchical agent system — an Orchestrator ("super agent") that decomposes requests and dispatches work to specialized Research Agents. Covers the orchestrator, job queue, research agents, scaling, failure modes, deployment, and observability.

Integration Architecture

The API Gateway that protects and aggregates resources (Salesforce, databases, partner accounts, payment providers) behind a single, versioned contract. Consumers talk only to the gateway; resources live behind it.

Intelligence Architecture

The data layer for luxury travel knowledge. A reusable crawler framework that indexes public and partner sources across multiple verticals (DMCs, dining, hotels, experiences), structures the data, and exposes it to AI agents through a standardized MCP interface.

Application Architecture

The Advisor Console — a React 19 single-page application that unifies AI-powered research, omnichannel inbox, CRM data access, and booking hand-off into a single interface for Marchay travel advisors.

Getting Started

• Start with the Overview page in each section for a high-level architecture diagram
• Refer to Design Principles for the non-negotiable rules governing each domain
• Check the Deployment pages for container layout and operational details