navan-reference-architecture

# Navan Reference Architecture ## Overview Production-grade architecture for Navan API integrations. Navan provides raw REST endpoints with OAuth 2.0 — no SDK, no webhooks, no sandbox. This architecture handles those constraints with five purpose-built layers. ## Prerequisites - Navan API credentials from Admin > Travel admin > Settings > Integrations - Cloud infrastructure (AWS, GCP, or Azure) for hosting integration services - Data warehouse for BOOKING and TRANSACTION tables - Understanding of OAuth 2.0 client credentials flow ## Instructions ### Architecture Overview ``` ┌──────────────────────────────────────────────────────────────────┐ │ CONSUMERS │ │ Travel Dashboard │ Expense Reports │ Finance System │ └────────┬────────────┴────────┬──────────┴────────┬───────────────┘ │ │ │ ┌────────▼─────────────────────▼────────────────────▼───────────────┐ │ LAYER 1: API GATEWAY │ │ ┌─────────────┐ ┌──────────────┐ ┌─────────────────────────┐ │ │ │ Rate Limiter │ │ Request Log │ │ Circuit Breaker (5xx) │ │ │ └─────────────┘ └──────────────┘ └─────────────────────────┘ │ └────────┬─────────────────────────────────────────────────────────┘ │ ┌────────▼─────────────────────────────────────────────────────────┐ │ LAYER 2: TOKEN MANAGEMENT SERVICE │ │ ┌──────────...