Architecture de référence AppFolio | sed 's/\b(.)/\u\1/g'
Architecture
┌──────────────────────────────────────────────┐
│ Votre application │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │Tableau │ │ Service │ │ Gestionnaire│ │
│ │de bord │ │ de sync │ │ de webhooks │ │
│ │(React) │ │ │ │ │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ Client API AppFolio │ │
│ │ (Auth basique, Retry, Cache, Limitation) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ API Stack AppFolio │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
Structure du projet
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # Client REST typé avec auth basique
│ │ ├── cache.ts # Cache des réponses avec TTL
│ │ └── types.ts # Types Property, Tenant, Lease, Unit
│ ├── dashboard/
│ │ ├── portfolio.ts # Résumé du portfolio
│ │ └── vacancy.ts # Suivi des vacances
│ ├── sync/
│ │ └── incremental.ts # Synchronisation incrémentielle
│ ├── webhooks/
│ │ └── handler.ts # Point de terminaison webhook
│ └── server.ts
├── tests/
│ ├── mocks/ # Réponses API simulées
│ └── unit/
└── package.json
Ressources