Communitygithub.com

AppFolio Lokale Entwicklung

Richtet eine lokale Entwicklungsumgebung für die AppFolio Property Management API-Integration ein.

Was ist AppFolio Lokale Entwicklung?

Dieses Skill bietet einen vollständigen lokalen Entwicklungs-Workflow für die Integration der AppFolio Property Management API. Es stellt einen Mock-Server mit synthetischen Property-, Tenant- und Lease-Endpunkten bereit, sodass du ohne Verbrauch des Live-API-Kontingents entwickeln und testen kannst. Du kannst zwischen dem Mock-Modus für schnelle Iterationen und einem dedizierten Sandbox-Modus für die Vorab-Validierung gegen die echte AppFolio Stack API wechseln. Das Skill unterstützt Node.js/Express, bietet unit-getestete Endpunkte und stellt sicher, dass keine Produktionsdaten oder echten Anmeldeinformationen in der lokalen Umgebung verwendet werden – ein klarer Sicherheits- und Quoten-Trennungsansatz.

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-local-dev-loop

In Ihrer bevorzugten KI fragen

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

Dokumentation

AppFolio Lokale Entwicklungsschleife

Überblick

Lokaler Entwicklungsworkflow für die AppFolio Property Management API-Integration. Bietet eine schnelle Feedbackschleife mit Mock-Endpunkten für Property, Tenant und Lease, sodass du Integrationen erstellen und testen kannst, ohne das Live-API-Kontingent zu verbrauchen. Wechsel zwischen Mock-Modus für schnelle Iterationen und Sandbox-Modus für die Vorab-Validierung gegen die echte AppFolio Stack API.

Voraussetzungen

  • Eine reine Mock-Umgebung mit synthetischen Property-, Tenant-, Lease- und Work-Order-Fixtures, die keine Produktionsadressen, -namen oder -zahlungen enthalten.
  • Ein separat verwaltetes Sandbox-Zugangsdatenpaar und ein genehmigtes Safe-Read-Fixture für die dedizierte Integrationsspur; diese werden niemals vom lokalen Dev-Server geladen.
  • Eine Log-Richtlinie, die nur Anfrageform und -status aufzeichnet, sowie einen expliziten Eigentümer für Sandbox-Kontingent, Fixture-Reset und Zugangsdatenrotation.

Anleitung

  1. Starte den lokalen Server nur im Mock-Modus und führe Lese-/Schreiboperationen gegen synthetische Routen mit deterministischen Fixtures durch.
  2. Teste Anfragevalidierung, Idempotenz, Redaktion und Fehlerbehandlung in Unit-Tests, bevor irgendeine Sandbox-Konnektivitätsprüfung stattfindet.
  3. Führe die Sandbox-Spur separat mit dem vertraglich gebundenen verwalteten Client und einem autorisierten Safe-Read-Fixture aus; verwandle keinen lokalen Proxy in einen Live-API-Tunnel.
  4. Stoppe, wenn das Fixture, die Zugangsdaten, das Anfragebudget oder die Ausgaberedaktion nicht verifiziert sind, korrigiere dann die Umgebung, bevor du fortfährst.

Umgebungseinrichtung

cp .env.example .env
# Lass die Anbieter-Zugangsdaten lokal leer. Mock-Modus ist die Voreinstellung.
# MOCK_MODE=true
npm install express axios dotenv tsx typescript @types/node
npm install -D vitest supertest @types/express

Dev-Server

// src/dev/server.ts
import express from "express";
const app = express();
app.use(express.json());
const MOCK = process.env.MOCK_MODE === "true";
if (!MOCK) throw new Error("Lokaler Server ist nur für Mock; verwende die verwaltete Sandbox-Integrationsspur");
const { mountMockRoutes } = require("./mocks");
mountMockRoutes(app);
app.listen(3001, () => console.log(`AppFolio Dev-Server auf :3001 [mock=${MOCK}]`));

Mock-Modus

// src/dev/mocks.ts — realistische Immobilienverwaltungsantworten
export function mountMockRoutes(app: any) {
  app.get("/api/v1/properties", (_req: any, res: any) => res.json([
    { id: "prop_1", name: "Sunset Apartments", address: { street: "123 Sunset Blvd", city: "Los Angeles", state: "CA" }, property_type: "residential", unit_count: 24 },
    { id: "prop_2", name: "Downtown Office", address: { street: "456 Main St", city: "San Francisco", state: "CA" }, property_type: "commercial", unit_count: 8 },
  ]));
  app.get("/api/v1/tenants", (_req: any, res: any) => res.json([
    { id: "t1", first_name: "Jane", last_name: "Smith", email: "[email protected]", unit_id: "u1", lease_id: "l1" },
  ]));
  app.get("/api/v1/leases", (_req: any, res: any) => res.json([
    { id: "l1", unit_id: "u1", start_date: "2025-01-01", end_date: "2026-01-01", rent_amount: 2500, status: "active" },
  ]));
  app.post("/api/v1/work-orders", (req: any, res: any) => res.status(201).json({ id: "wo_1", ...req.body, status: "open" }));
}

Test-Workflow

npm run dev:mock &                    # Mock-Server im Hintergrund starten
npm run test                          # Unit-Tests mit vitest
npm run test -- --watch               # Watch-Modus für schnelle Iterationen
npm run test:sandbox                     # Verwaltete, schreibgeschützte Sandbox-Spur

Debug-Tipps

  • Setze DEBUG=express:*, um alle Routenabgleiche und Middleware-Ausführungen zu verfolgen
  • Verwende lokale Test-Assertions für Fixture-Anzahlen und Schema-Form, nicht rohe Tenant-Payload-Dumps
  • Überprüfe den Header X-RateLimit-Remaining beim Testen gegen die Live-API
  • Die AppFolio-Sandbox gibt 403 für Properties zurück, die du nicht besitzt – überprüfe deinen API-Key-Bereich
  • Verwende Interceptors nur für redigierte Endpunkt-/Status-/Zahl-Telemetrie während der Entwicklung

Ausgabe

  • Ein deterministischer, reiner Mock-Server mit synthetischen Immobilienverwaltungs-Fixtures und keiner Abhängigkeit von Anbieter-Zugangsdaten
  • Unit-Test-Nachweis für Validierung, Idempotenz und PII-sichere Beobachtbarkeit
  • Ein separates, verwaltetes Sandbox-Ergebnis, das nur redigierten Safe-Read-Status enthält

Beispiele

Für eine Work-Order-UI-Änderung füge ein synthetisches Mock-Fixture hinzu und teste das Anfrageschema sowie das Verhalten bei doppelten Einsendungen lokal. Bestätige die zurückgegebene ID und den Status, ohne den Anfragekörper oder den Tenant-Datensatz auszugeben. Nach Bestehen der Unit-Tests führe die dedizierte Sandbox-Spur gegen ein genehmigtes Safe-Read-Fixture aus. Wenn der Mock-Modus deaktiviert ist, eine Sandbox-Zugangsdaten lokal erscheinen oder eine Antwort unredigierte Tenant-Felder enthält, stoppe den Lauf und stelle die lokale Grenze wieder her.

Fehlerbehandlung

ProblemUrsacheLösung
401 UnauthorizedUngültiger oder abgelaufener API-KeyNeu im AppFolio Stack Portal generieren
403 ForbiddenKey hat keinen Bereich für den EndpunktZusätzliche Berechtigungen anfordern
404 Not FoundFalsche Property-ID oder PfadÜberprüfen, ob die Ressource in der Sandbox existiert
429 Too Many RequestsRate-Limit überschrittenExponentielles Backoff hinzufügen, Mock-Modus verwenden
ECONNREFUSED :3001Dev-Server läuft nichtnpm run dev:mock zuerst ausführen

Ressourcen

Nächste Schritte

Siehe appfolio-debug-bundle.

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

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

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