Was macht AppFolio Referenzarchitektur?
Architektur
┌──────────────────────────────────────────────┐
│ Ihre Anwendung │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │Dashboard │ │ Sync │ │ Webhook │ │
│ │(React) │ │ Dienst │ │ Handler │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ AppFolio API Client │ │
│ │ (Basic Auth, Retry, Cache, Rate Limit) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
Projektstruktur
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # Typen-sicherer REST-Client mit Basic Auth
│ │ ├── cache.ts # Antwort-Cache mit TTL
│ │ └── types.ts # Typen für Immobilien, Mieter, Mietverträge, Einheiten
│ ├── dashboard/
│ │ ├── portfolio.ts # Portfolio-Übersicht
│ │ └── vacancy.ts # Leerstandsverfolgung
│ ├── sync/
│ │ └── incremental.ts # Inkrementelle Datensynchronisation
│ ├── webhooks/
│ │ └── handler.ts # Webhook-Endpunkt
│ └── server.ts
├── tests/
│ ├── mocks/ # Mock-API-Antworten
│ └── unit/
└── package.json
Ressourcen