apollo-reference-architecture

# Apollo Reference Architecture ## Overview Production-ready reference architecture for Apollo.io integrations. Layered design with API client, service layer, background jobs, database models, CRM sync, and deals pipeline — all built around Apollo's REST API with correct endpoints and `x-api-key` authentication. ## Prerequisites - Apollo master API key - Node.js 18+ with TypeScript - PostgreSQL for data layer - Redis for job queues ## Instructions ### Step 1: Architecture Diagram ``` ┌───────────────────────────────────────────────┐ │ API Layer │ Express routes │ POST /api/leads/search GET /api/org/:d │ POST /api/deals ├───────────────────────────────────────────────┤ │ Service Layer │ Business logic │ LeadService EnrichService DealService │ SequenceService ├───────────────────────────────────────────────┤ │ Client Layer │ Apollo API wrapper │ ApolloClient RateLimiter Cache │ CreditTracker ├───────────────────────────────────────────────┤ │ Background Jobs │ BullMQ queues │ EnrichJob SyncJob StageChangeJob │ TaskCreatorJob ├───────────────────────────────────────────────┤ │ Data Layer │ Prisma/TypeORM │ Contact Organization Deal AuditLog │ └───────────────────────────────────────────────┘ ``` ### Step 2: Service Layer ```typescript // s...