bamboohr-reference-architecture

# BambooHR Reference Architecture ## Overview Production-ready architecture for BambooHR integrations covering the three most common patterns: real-time employee sync, HR data pipeline, and employee lifecycle automation. ## Prerequisites - Understanding of layered architecture and event-driven design - BambooHR API knowledge from earlier skills in this pack - TypeScript project setup with Node.js 18+ ## Instructions ### Architecture Overview ``` ┌──────────────────────────────────────────────────────────┐ │ Your Application │ ├──────────────┬───────────────┬────────────────────────────┤ │ API Layer │ Sync Engine │ Webhook Handler │ │ /api/* │ (Cron/Queue) │ /webhooks/bamboohr │ ├──────────────┴───────────────┴────────────────────────────┤ │ Service Layer │ │ EmployeeService │ TimeOffService │ ReportService │ ├───────────────────┴──────────────────┴────────────────────┤ │ BambooHR Client Layer │ │ BambooHRClient │ Cache │ RetryHandler │ Metrics │ ├───────────────────┴─────────┴────────────────┴────────────┤ │ Data Layer │ │ PostgreSQL (employees) │ Redis (cache) │ S3 (files) │ └───────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────┐ ...