AppFolio 참조 아키텍처
아키텍처
┌──────────────────────────────────────────────┐
│ 귀하의 애플리케이션 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │대시보드 │ │ 동기화 │ │ 웹훅 │ │
│ │(React) │ │ 서비스 │ │ 핸들러 │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ AppFolio API 클라이언트 │ │
│ │ (기본 인증, 재시도, 캐시, 속도 제한) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
프로젝트 구조
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # 기본 인증이 있는 타입드 REST 클라이언트
│ │ ├── cache.ts # TTL이 있는 응답 캐시
│ │ └── types.ts # Property, Tenant, Lease, Unit 타입
│ ├── dashboard/
│ │ ├── portfolio.ts # 포트폴리오 요약
│ │ └── vacancy.ts # 공실 추적
│ ├── sync/
│ │ └── incremental.ts # 증분 데이터 동기화
│ ├── webhooks/
│ │ └── handler.ts # 웹훅 엔드포인트
│ └── server.ts
├── tests/
│ ├── mocks/ # 모의 API 응답
│ └── unit/
└── package.json
리소스