appfolio-reference-architecture

# AppFolio Reference Architecture ## Overview Production architecture for property management integrations with the AppFolio Stack API. Designed for multi-property portfolios requiring real-time vacancy tracking, tenant lifecycle management, work order routing, and accounting reconciliation. Key design drivers: data freshness for leasing decisions, idempotent sync for financial accuracy, and tenant-facing portal responsiveness. ## Architecture Diagram ``` Dashboard (React) ──→ Property Service ──→ Redis Cache ──→ AppFolio Stack API ↓ /properties Queue (Bull) ──→ Sync Worker /tenants ↓ /leases Webhook Handler ←── AppFolio Events /work-orders ↓ /bills Accounting Sync ──→ QuickBooks/Xero ``` ## Service Layer ```typescript class PropertyService { constructor(private client: AppFolioClient, private cache: CacheLayer) {} async getPortfolioSummary(propertyIds: string[]): Promise<PortfolioSummary> { const properties = await Promise.all( propertyIds.map(id => this.cache.getOrFetch(`prop:${id}`, () => this.client.get(`/properties/${id}`))) ); return { totalUnits: properties.reduce((sum, p) => sum + p.units.length, 0), vacancyRate: this.calcVacancy(properties), pendingWorkOrders: await this.getPe...