salesforce-reference-architecture

# Salesforce Reference Architecture ## Overview Production-ready architecture patterns for Salesforce integrations, covering Node.js integration apps, SFDX metadata projects, and event-driven sync architectures. ## Prerequisites - Understanding of layered architecture - jsforce and Salesforce CLI experience - TypeScript project setup - Decision on sync model (polling vs event-driven) ## Project Structure ### Node.js Integration App ``` my-sf-integration/ ├── src/ │ ├── salesforce/ │ │ ├── connection.ts # Singleton jsforce connection with auto-refresh │ │ ├── types.ts # Typed sObject interfaces (Account, Contact, etc.) │ │ ├── queries.ts # SOQL query builders │ │ ├── mutations.ts # Create/update/delete operations │ │ └── events.ts # CDC and Platform Event subscribers │ ├── services/ │ │ ├── account-sync.ts # Business logic for Account sync │ │ ├── contact-sync.ts # Business logic for Contact sync │ │ └── opportunity-sync.ts # Pipeline/forecast sync │ ├── api/ │ │ ├── routes.ts # Express/Fastify routes │ │ └── health.ts # Health check with SF connectivity │ ├── jobs/ │ │ ├── full-sync.ts # Scheduled full data sync │ │ └── incremental-sync.ts # CDC-based incremental sync │ └── index.ts ├── tests/ │ ├── unit/ # Mocked jsforce tests │ └── integration/ # Live sandbox tests ├── config/ │ ├── default.json ...