Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Stellt den AppFolio-Integrationsdienst in der Cloud-Infrastruktur bereit.

Was ist tons-of-skills-marketplace?

Diese Skill-Anleitung beschreibt, wie ein containerisierter AppFolio-Immobilienverwaltungs-Integrationsdienst mit Docker bereitgestellt wird. Sie deckt den Bau eines produktionsreifen Images ab, das eine Verbindung zur AppFolio Stack API herstellt und die Verwaltung von Immobilien, Mietern und Arbeitsaufträgen ermöglicht. Die Anleitung umfasst die Umgebungskonfiguration für mehrere Immobilien, Health-Checks zur Überprüfung der API-Konnektivität sowie Strategien für rollierende Updates mit null Ausfallzeiten im gesamten Immobilienportfolio. Sie wird durch Trigger wie „deploy appfolio“ aktiviert und unterstützt Entwickler dabei, eine robuste und zuverlässige Integration mit etablierten Deployment-Plattformen zu gewährleisten.

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-deploy-integration

In Ihrer bevorzugten KI fragen

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

Dokumentation

AppFolio Deploy Integration

Übersicht

Stelle einen containerisierten AppFolio-Immobilienverwaltungs-Integrationsdienst mit Docker bereit. Diese Skill-Anleitung behandelt das Erstellen eines produktionsreifen Images, das eine Verbindung zur AppFolio Stack API für die Verwaltung von Immobilien, Mietern und Arbeitsaufträgen herstellt. Enthalten sind die Umgebungskonfiguration für mehrere Immobilien, Health-Checks, die die API-Konnektivität überprüfen, sowie Strategien für rollierende Updates mit null Ausfallzeiten im gesamten Immobilienportfolio.

Voraussetzungen

  • Ein verifizierter Providervertrag und ein geheimer, vertragsgebundener AppFolio-Client, der über einen Secret-Manager gesichert ist. Geben Sie keine Anmeldeinformationen in Image-Ebenen, Compose-Dateien, Shell-Verlauf oder Bereitstellungsprotokolle ein.
  • Eine Bereitstellungsplattform, die echte rollierende/Canary-Updates mit Readiness-Checks, Traffic-Steuerung, Rollback und einem benannten Freigabe-Inhaber durchführen kann.
  • Getrennte Staging- und Produktionsidentitäten, ein synthetisches Staging-Smoke-Test-Fixture und ein Incident-Plan für unbekannte Schreib- oder Abgleichszustände.

Anleitung

  1. Erstellen Sie ein Non-Root-Image mit gesperrten Abhängigkeiten und legen Sie nur einen lokalen Liveness-Endpunkt frei. Die Provider-Verfügbarkeit gehört zur Readiness, nicht zum Prozess-Überleben.
  2. Injizieren Sie die verifizierte Client-Konfiguration zur Laufzeit aus dem Secret-Manager und validieren Sie deren Vertrag im Staging durch einen autorisierten sicheren Lesevorgang.
  3. Führen Sie eine neue Revision schrittweise aus, überwachen Sie geschwärzte Readiness-/Fehlersignale und behalten Sie die vorherige Revision bei, bis das Traffic-Fenster erfolgreich ist.
  4. Stoppen Sie bei fehlgeschlagenen Readiness-, Vertrags-, Secret- oder Abgleichsprüfungen die Traffic-Förderung und führen Sie ein Rollback über die Bereitstellungsplattform durch.

Docker-Konfiguration

FROM node:20-slim AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY tsconfig.json ./
COPY src/ ./src/
RUN npm run build

FROM node:20-slim
RUN addgroup --system app && adduser --system --ingroup app app
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY package*.json ./
USER app
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
  CMD node -e "fetch('http://127.0.0.1:3000/health').then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"
CMD ["node", "dist/index.js"]

Laufzeitkonfiguration

# Werte werden vom Secret-Manager der Bereitstellungsplattform injiziert; geben Sie keine
# Live-Anmeldeinformationen in ein Terminalkommando oder eine eingecheckte Konfiguration ein.
APPFOLIO_BASE_URL="Provider-ausgestellte Basis-URL"
APPFOLIO_COMPANY_ID="genehmigte Portfolio-Kennung"
export LOG_LEVEL="info"
export PORT="3000"
export NODE_ENV="production"

Health-Check-Endpunkt

import express from 'express';

const app = express();

// Liveness beweist, dass dieser Prozess bedienen kann; er darf einen gesunden Worker nicht neu starten,
// nur weil der externe Provider beeinträchtigt ist.
app.get('/health', (_req, res) => {
  res.json({ status: 'healthy', service: 'appfolio-integration' });
});

app.get('/ready', async (_req, res) => {
  try {
    const response = await createVerifiedAppFolioClient().get('/properties?limit=1');
    if (response.status < 200 || response.status >= 300) throw new Error(`AppFolio API returned ${response.status}`);
    res.json({ status: 'ready', service: 'appfolio-integration', timestamp: new Date().toISOString() });
  } catch (error) {
    res.status(503).json({ status: 'not-ready', error: 'provider readiness check failed' });
  }
});

Bereitstellungsschritte

Schritt 1: Bauen

docker build -t appfolio-integration:latest .

Schritt 2: Ausführen

docker run -d --name appfolio-integration \
  -p 3000:3000 \
  -e APPFOLIO_API_KEY -e APPFOLIO_BASE_URL -e APPFOLIO_COMPANY_ID \
  appfolio-integration:latest

Schritt 3: Überprüfen

curl -s http://localhost:3000/health | jq .

Schritt 4: Rollierendes Update

# Übermitteln Sie den unveränderlichen Image-Digest an den Bereitstellungscontroller der Plattform.
# Konfigurieren Sie /health als Liveness und /ready als Readiness, verschieben Sie den Traffic
# in Stufen und behalten Sie die vorherige Revision bei, bis das Release-Fenster abgeschlossen ist.

Fehlerbehandlung

ProblemUrsacheBehebung
401 UnauthorizedUngültiger oder abgelaufener API-SchlüsselSchlüssel im AppFolio Stack Partner-Portal neu generieren
403 ForbiddenFehlender Zugriffsbereich für ImmobilienZusätzliche Bereiche vom AppFolio-Administrator anfordern
404 Not FoundFalsche Basis-URL oder Unternehmens-IDÜberprüfen, ob APPFOLIO_BASE_URL mit Ihrer Subdomain übereinstimmt
429 Rate LimitedZu viele Anfragen pro MinuteExponentielles Backoff mit 60-Sekunden-Fenster implementieren
Container wird sofort beendetFehlende erforderliche UmgebungsvariablenStellen Sie sicher, dass alle Umgebungsvariablen vor dem Start gesetzt sind

Ausgabe

  • Ein Non-Root-Container mit einem lokalen Liveness-Endpunkt und einem separaten, geschwärzten Provider-Readiness-Ergebnis
  • Eine Secret-Manager/Laufzeitkonfigurationsgrenze anstelle von Anmeldeinformationen in Images oder Befehlen
  • Ein gestaffelter Bereitstellungsbeleg mit Readiness-Nachweis, Traffic-Status, Inhaber, Rollback-Ziel und Abgleichszustand

Beispiele

Für ein Property-Sync-Release stellen Sie das neue Image im Staging mit einem synthetischen Safe-Read-Fixture bereit und bestätigen, dass /health live bleibt, während /ready das Provider-Client-Ergebnis widerspiegelt. Fördern Sie einen kleinen Produktions-Traffic-Slice erst, nachdem die verwaltete Identität, geschwärzte Readiness, Alarme und das Rollback-Ziel überprüft wurden. Wenn die Readiness fehlschlägt, ein Secret fehlt oder ein vorheriger Schreibvorgang ein unbekanntes Ergebnis hat, stoppen Sie die Förderung, leiten Sie den Traffic zur vorherigen Revision zurück und weisen Sie den Abgleich zu, bevor Sie einen weiteren Rollout versuchen.

Ressourcen

Nächste Schritte

Siehe appfolio-webhooks-events.

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

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

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