arquitetura de referência appfolio | sed 's/\b(.)/\u\1/g'
Arquitetura
┌──────────────────────────────────────────────┐
│ Sua Aplicação │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │Dashboard │ │ Sincronia│ │ Handler │ │
│ │(React) │ │ Serviço │ │ Webhook │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ Cliente API AppFolio │ │
│ │ (Autenticação Básica, Retry, Cache, │ │
│ │ Limite de Taxa) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
Estrutura do Projeto
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # Cliente REST tipado com Autenticação Básica
│ │ ├── cache.ts # Cache de resposta com TTL
│ │ └── types.ts # Tipos de Propriedade, Inquilino, Contrato, Unidade
│ ├── dashboard/
│ │ ├── portfolio.ts # Resumo do portfólio
│ │ └── vacancy.ts # Acompanhamento de vagas
│ ├── sync/
│ │ └── incremental.ts # Sincronização incremental de dados
│ ├── webhooks/
│ │ └── handler.ts # Endpoint de webhook
│ └── server.ts
├── tests/
│ ├── mocks/ # Respostas mockadas da API
│ └── unit/
└── package.json
Recursos