Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Referenzarchitektur für die Integration von Immobilienverwaltung mit AppFolio.

Was ist tons-of-skills-marketplace?

Diese Skill bietet eine Referenzarchitektur für die Integration von Immobilienverwaltungssystemen über die AppFolio Stack API. Sie richtet sich an Multi-Property-Portfolios und behandelt zentrale Anwendungsfälle wie Echtzeit-Verfolgung von Leerständen, Verwaltung des Mieterlebenszyklus, Weiterleitung von Arbeitsaufträgen und buchhalterische Abstimmung. Die Architektur legt besonderen Wert auf Datenaktualität für Leasingentscheidungen, idempotente Synchronisation für finanzielle Genauigkeit und Reaktionsfähigkeit des Mieterportals. Sie unterstützt die AppFolio-Plattform und bietet konkrete Implementierungsrichtlinien, Architekturdiagramme, Service Layer in TypeScript, eine Caching-Strategie, Event-Pipelines und ein Datenmodell. Die Nutzung dieses Skills hilft Entwicklern und Architekten, eine robuste, skalierbare und fehlertolerante Integration zu entwerfen, die sowohl operative Anforderungen als auch Compliance-Vorgaben erfüllt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-reference-architecture

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AppFolio Referenzarchitektur

Überblick

Produktionsarchitektur für Immobilienverwaltungsintegrationen mit der AppFolio Stack API. Konzipiert für Multi-Property-Portfolios, die eine Echtzeit-Verfolgung von Leerständen, Verwaltung des Mieterlebenszyklus, Weiterleitung von Arbeitsaufträgen und buchhalterische Abstimmung erfordern. Wichtigste Entwurfstreiber: Datenaktualität für Leasingentscheidungen, idempotente Synchronisation für finanzielle Genauigkeit und Reaktionsfähigkeit des Mieterportals.

Voraussetzungen

  • Ein vom Anbieter bestätigter Vertrag über Endpunkte, Authentifizierung, Ereignisse (falls vorhanden), Ratennutzungsgrenzen, Datenresidenz und zulässige nachgelagerte Auswirkungen auf Buchhaltung/CRM.
  • Separate Staging- und Produktionsumgebungen mit verwalteten Geheimnissen, synthetischen Testdaten, langlebigen Warteschlangen/Idempotenzspeichern und benannten Abstimmungsverantwortlichen.
  • Datenklassifizierung, die Dashboard- und Cache-Modelle auf die kleinstmöglichen zulässigen Felder beschränkt; Mieterkontakt-, Zahlungs- und Saldodaten erfordern separate verschlüsselte Speicher und Zugriffskontrollen.

Anleitung

  1. Bauen Sie zuerst die vertragsgebundene Client- und schreibgeschützte Dienstebene auf, mit Endpunktbudgets, minimierten Cache-Einträgen und Beobachtbarkeit, bevor Sie Schreib- oder Ereignisverarbeitung hinzufügen.
  2. Aktivieren Sie Anbieterereignisse erst, wenn der Vertrag und die dauerhaften Rohdaten-, Signatur-, Persistenz- und Wiederholungsgrenzen nachgewiesen wurden; verwenden Sie andernfalls eine begrenzte inkrementelle Abstimmung.
  3. Persistieren Sie einen Idempotenz-/Abstimmungsdatensatz, bevor Sie eine Mutation von Arbeitsaufträgen, Buchhaltungs-, Mieter- oder Leasingdaten durchführen, und fordern Sie eine explizite Autorisierung.
  4. Validieren Sie die Architektur im Staging mit synthetischen Daten, einem erzwungenen Anbieterfehler, einem doppelten Ereignis/Wiederholungsversuch und einer Rollback-Übung vor der Übernahme.

Architekturdiagramm

Dashboard (React) ──→ Property Service ──→ Redis Cache ──→ AppFolio Stack API
                           ↓                                 /properties
                      Queue (Bull) ──→ Sync Worker           /tenants
                           ↓                                 /leases
                      Event Handler ←── Provider events*      /work-orders
                           ↓                                 /bills
                      Accounting Sync ──→ QuickBooks/Xero

* Verwenden Sie Anbieterereignisse nur, wenn der aktive Vertrag deren Zustellung und Sicherheitssemantik bestätigt; andernfalls speisen Sie die Warteschlange aus der begrenzten Abstimmung.

Dienstebene

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.getPendingOrders(propertyIds) };
  }

  async routeWorkOrder(order: WorkOrderRequest): Promise<string> {
    const property = await this.client.get(`/properties/${order.propertyId}`);
    const vendor = this.selectVendor(property.region, order.category);
    return this.client.post('/work-orders', { ...order, assigned_vendor: vendor });
  }
}

Caching-Strategie

const CACHE_CONFIG = {
  properties: { ttl: 300, prefix: 'prop' },     // 5 min — seltene Änderungen
  tenants:    { ttl: 120, prefix: 'tenant' },    // 2 min — moderate Änderungen
  leases:     { ttl: 60,  prefix: 'lease' },     // 1 min — finanzielle Genauigkeit
  workOrders: { ttl: 30,  prefix: 'wo' },        // 30s — Echtzeitverfolgung
  vacancies:  { ttl: 15,  prefix: 'vacancy' },   // 15s — Leerstandsgeschwindigkeit ist wichtig
};
// Webhook-basierte Invalidierung: AppFolio-Ereignisse leeren sofort entsprechende Cache-Schlüssel

Ereignispipeline

class PropertyEventPipeline {
  private queue = new Bull('appfolio-events', { redis: process.env.REDIS_URL });

  async onWebhook(event: AppFolioEvent): Promise<void> {
    await this.queue.add(event.type, event, { attempts: 3, backoff: { type: 'exponential', delay: 2000 } });
  }

  async processLeaseEvent(event: LeaseEvent): Promise<void> {
    if (event.type === 'lease.signed') await this.updateVacancy(event.propertyId);
    if (event.type === 'lease.terminated') await this.triggerMoveOutWorkflow(event);
  }

  async processWorkOrderEvent(event: WorkOrderEvent): Promise<void> {
    if (event.status === 'completed') await this.reconcileVendorInvoice(event);
  }
}

Datenmodell

interface Property { id: string; name: string; address: Address; units: Unit[]; region: string; }
interface TenantRef { id: string; leaseId: string; contactCiphertextRef: string; }
interface Lease    { id: string; propertyId: string; unitId: string; tenantId: string; startDate: string; endDate: string; monthlyRent: number; status: 'active' | 'pending' | 'terminated'; }
interface WorkOrder { id: string; propertyId: string; unitId: string; category: 'plumbing' | 'electrical' | 'hvac' | 'general'; status: string; assignedVendor: string; }

Skalierungsüberlegungen

  • Partitionieren Sie Sync-Worker nach Immobilienregion, um regionsübergreifende API-Ratenbegrenzungen zu vermeiden.
  • Verwenden Sie Lesereplikate für Dashboard-Abfragen; der Schreibpfad verläuft über die Ereignispipeline.
  • Bündeln Sie Mieterbenachrichtigungen (Mietzahlungserinnerungen, Wartungsupdates) über die Warteschlange, um E-Mail-Ratenbegrenzungen zu vermeiden.
  • Cachen Sie Leerstandsdaten aggressiv – Leasing-Agenten greifen auf diesen Endpunkt 10x häufiger zu als auf andere.
  • Sharding der Arbeitsauftragsrouting nach Immobilienportfolio, um unabhängige Skalierung pro Verwaltungsgruppe zu ermöglichen.

Fehlerbehandlung

KomponenteFehlermodusWiederherstellung
ImmobiliensynchronisationAppFolio 429 RatenbegrenzungExponentielles Backoff mit Jitter, leerstandsabhängiger Schutzschalter
Leasing-WebhookDoppelte EreigniszustellungIdempotenzschlüssel auf Leasing-ID + Ereigniszeitstempel
ArbeitsauftragsroutingZeitüberschreitung der Anbieter-APIWarteschlangenwiederholung mit Rückfall auf manuelle Zuordnung
BuchhaltungssynchronisationSaldenabweichungAbstimmungswarteschlange mit manuellem Prüfungsflag
MieterportalCache-FehlerschwallStale-while-revalidate-Muster, Schutzschalter auf API-Ebene

Ausgabe

  • Eine vertragsgebundene, gestufte Architektur mit Service, Cache, Warteschlange, Daten und klar getrennter Abstimmungsverantwortung.
  • Minimierte Dashboard-Referenzen und verschlüsselte/kontrollierte Grenzen für Mieterkontakt-, Zahlungs- und Saldodaten.
  • Eine durch Staging-Fehler, Duplikate/Wiederholungen, Raten, Rollback und Abstimmungsnachweise gestützte Bereitstellungsentscheidung.

Beispiele

Für einen Leerstands-Dashboard-Rollout beginnen Sie mit synthetischen Immobilien- und Einheiten-IDs, einem begrenzten schreibgeschützten Zugriff und einem Cache, der das Datenalter anzeigt. Injizieren Sie ein doppeltes Ereignis oder einen Abstimmungsdatensatz, einen 429-Fehler und eine nachgelagerte Buchhaltungs-Zeitüberschreitung, um zu beweisen, dass die Warteschlange und der Idempotenzspeicher doppelte Effekte verhindern. Übernehmen Sie die Änderungen erst, wenn die Ergebnisse vollständig und autorisiert bleiben und die Rollback-/Abstimmungsverantwortlichen ihre Pfade nachweisen können. Wenn Ereignisunterstützung, Datenklassifizierung, dauerhafter Zustand oder ein Schreibergebnis nicht verifiziert sind, halten Sie den entsprechenden Pfad deaktiviert und verwenden Sie eine betreibergeführte Abstimmung.

Ressourcen

Nächste Schritte

Siehe appfolio-deploy-integration.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Automate tenant management and lease operations with AppFolio. Trigger: "appfolio tenant management".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

Verwandte Skills