Communitygithub.com

AppFolio-Produktionsbereitschafts-Checkliste

Produktionsbereitschafts-Checkliste für AppFolio-Integrationen.

Was ist AppFolio-Produktionsbereitschafts-Checkliste?

Diese Checkliste stellt sicher, dass Ihre AppFolio-API-Integration robust, konform und überwachbar ist, bevor sie in die Produktion geht. Sie deckt alle kritischen Aspekte ab: Authentifizierung und Secrets (z. B. rotierte API-Schlüssel im Secrets Manager), API-Integration (Rate-Limiting, Paginierung, Webhooks), Fehlerbehandlung (Circuit Breaker, Retry mit Backoff) sowie detaillierte Überwachung und Alarmierung. Ein validierendes TypeScript-Skript prüft die API-Konnektivität und die Funktionsfähigkeit der Work-Order-Endpunkte. Die Checkliste ist speziell für AppFolio-Integrationen konzipiert, die sensible Mieter-PII, Transaktionen und Wartungsworkflows verarbeiten – Fehler können zu verpassten Mieteinnahmen, doppelten Aufträgen oder CCPA-Verstößen führen. Sie unterstützt Entwicklerteams, indem sie eine schrittweise, dokumentierte Freigabe mit Rollback-Plan sicherstellt und als letzte Barriere vor der Produktionsfreigabe dient.

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-prod-checklist

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht AppFolio-Produktionsbereitschafts-Checkliste?

Übersicht

AppFolio verwaltet Immobilien, Mieter, Mietverträge und Arbeitsaufträge für Immobilienbetriebe. Eine Produktionsintegration verarbeitet sensible Mieter-PII (personenbezogene Daten), Finanztransaktionen und Wartungsworkflows. Fehler hier bedeuten verpasste Mieteinnahmen, nicht bearbeitete Arbeitsaufträge oder die Offenlegung von Mieterdaten gemäß CCPA. Diese Checkliste stellt sicher, dass Ihre AppFolio-API-Integration ausfallsicher, konform und beobachtbar ist.

Voraussetzungen

  • Ein verifizierter Produktionspartnervertrag, Basis-URL, Authentifizierungsmechanismus, zulässige Endpunkt-Bereiche und benannte Verantwortliche für Geschäft, Sicherheit, Betrieb und Rollback-Entscheidungen.
  • Eine abgeschlossene Sandbox-Probe mit synthetischen Daten, separaten verwalteten Anmeldeinformationen, einem Anfragebudget und einem aufgezeichneten Rollback-/Abgleichsplan.
  • Nachweise für Beobachtbarkeit, PII-Minimierung, idempotente Schreibvorgänge und Alarmweiterleitung – kein Checklistenpunkt, der lediglich behauptet, dass diese Kontrollen existieren.

Anleitung

  1. Validieren Sie die tatsächliche, vom Anbieter ausgestellte Client-Konfiguration über den Secrets Manager; verwenden Sie in Release-Code keinen Standard-Endpunkt oder Authentifizierungsschema.
  2. Führen Sie die Bereitschaftsprüfungen im Staging durch, dann eine kontrollierte, produktionsähnliche Probe, die nur autorisierte sichere Lesevorgänge durchführt.
  3. Bewerten Sie jeden fehlgeschlagenen, übersprungenen oder nicht verifizierbaren Kontrollpunkt als „No-Go“; bewahren Sie geschwärzte Belege für Anmeldeinformationen, Endpunkte, Überwachung und Wiederherstellung auf.
  4. Führen Sie die Freigabe nur schrittweise mit einem getesteten Rollback- und Abgleichsverantwortlichen durch; unterbrechen Sie Schreibpfade, wenn der Zahlungs-, Arbeitsauftrags-, Mieter- oder Mietvertragsstatus unbekannt ist.

Authentifizierung und Secrets

  • APPFOLIO_API_KEY im Secrets Manager gespeichert (nicht in Umgebungsdateien)
  • Client-ID und Secret vom Anwendungscode getrennt
  • Schlüsselrotationszeitplan dokumentiert (90 Tage empfohlen)
  • Separate Anmeldeinformationen für Dev/Staging/Prod-Umgebungen
  • API-Anmeldeinformationen auf die minimal erforderlichen Berechtigungen beschränkt

API-Integration

  • Produktions-Basis-URL und Authentifizierungsmethode gemäß aktuellem Partnervertrag verifiziert
  • Rate-Limit-Handling mit exponentiellem Backoff
  • Paginierung für Property- und Tenant-Listenendpunkte implementiert
  • Arbeitsauftragserstellung mit allen erforderlichen Feldern getestet
  • Mietdokumentenupload für unterstützte Formate validiert
  • Webhook-Endpunkte für Mieter- und Zahlungsereignisse konfiguriert
  • Idempotenzschlüssel für Zahlungs- und Arbeitsauftragserstellung verwendet

Fehlerbehandlung und Ausfallsicherheit

  • Circuit Breaker für AppFolio-API-Ausfälle konfiguriert
  • Wiederholung mit Backoff für 429/5xx-Antworten
  • Mieter-PII-Handlung gemäß CCPA/FCRA konform verifiziert
  • Datenvalidierung aller API-Antworten vor der Speicherung
  • Graceful Degradation, wenn die Property-Synchronisation nicht verfügbar ist
  • Erkennung doppelter Arbeitsaufträge verhindert Neuerstellung bei Wiederholung

Überwachung und Alarmierung

  • API-Latenz pro Endpunkt verfolgt (Properties, Tenants, Work Orders)
  • Fehlerraten-Alarme eingerichtet (Schwellenwert: >3 % über 5 Minuten)
  • Fehlgeschlagene Zahlungssynchronisation löst sofortigen P1-Alarm aus
  • Fehler bei der Arbeitsauftragserstellung innerhalb von 5 Minuten gemeldet
  • Täglicher Abgleich der synchronisierten Property-Anzahl mit der Quelle

Validierungsskript

async function checkAppFolioReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  const client = createVerifiedAppFolioClient(); // vertragsgebundener Client aus appfolio-security-basics
  // API-Konnektivität
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'API-Konnektivität', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'API-Konnektivität', pass: false, detail: e.message }); }
  // Client-Konstruktion beweist, dass die verwalteten Anmeldeinformationen und der Anbietervertrag verfügbar sind.
  checks.push({ name: 'Verifizierte Client-Konfiguration', pass: true, detail: 'Aus verwalteter Konfiguration geladen' });
  // Arbeitsauftrags-Endpunkt
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: 'Arbeitsaufträge', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Arbeitsaufträge', pass: false, detail: e.message }); }
  for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

Fehlerbehandlung

PrüfungRisiko bei ÜberspringenPriorität
API-SchlüsselrotationAbgelaufene Schlüssel unterbrechen Property-SynchronisationP1
ZahlungssynchronisationsfehlerVerpasste MieteinnahmenP1
Offenlegung von Mieter-PIICCPA-Verstoß, rechtliche HaftungP1
Doppelte ArbeitsaufträgeDoppelter WartungseinsatzP2
Rate-Limit-Handling429-Fehler bei Bulk-Property-ImportP3

Ausgabe

  • Ein geschwärzter Go/No-Go-Beleg, der den verifizierten Client, sichere Lesevorgänge, den Überwachungsstatus, Zustimmungen der Verantwortlichen und den Rollback-/Abgleichsplan bindet
  • Eine Liste fehlgeschlagener oder nicht nachgewiesener Kontrollpunkte, die die Freigabe blockieren, bis sie behoben sind
  • Eine begrenzte Freigabeentscheidung, die sensible oder schreibfähige Pfade abschaltet, bis deren produktionsähnliche Probe nachgewiesen ist

Beispiele

Führen Sie für eine Freigabe einer Arbeitsauftragsintegration die Checkliste zunächst gegen eine synthetische Staging-Umgebung durch, verwenden Sie dann den verwalteten produktionsähnlichen Client für einen einzelnen autorisierten sicheren Lesevorgang. Bestätigen Sie die Alarmweiterleitung, PII-Schwärzung und Idempotenz-/Abgleichskontrollen, während alle Schreibvorgänge deaktiviert bleiben. Wenn eine Anmeldeinformation, ein Endpunktvertrag, eine Bereitschaftsprüfung oder eine Rollback-Übung nicht verifiziert werden kann, erklären Sie „No-Go“, behalten Sie die vorherige Revision bei und lassen Sie den zugewiesenen Verantwortlichen die Behebung vor einer neuen Probe durchführen.

Ressourcen

Nächste Schritte

Siehe appfolio-security-basics für den Schutz von Mieterdaten und Zugriffskontrolle.

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

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

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

jeremylongshore/tons-of-skills-marketplace

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

Verwandte Skills