Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Liste de contrôle de mise en production pour les intégrations AppFolio.

Qu'est-ce que tons-of-skills-marketplace ?

Cette compétence fournit une liste de contrôle complète pour garantir que votre intégration API AppFolio est résiliente, conforme et observable avant la mise en production. Elle couvre les prérequis essentiels comme un contrat partenaire vérifié et une répétition en environnement sandbox, ainsi que des vérifications détaillées sur l'authentification, les secrets, l'intégration API, la gestion des erreurs, la résilience, la surveillance et les alertes. La compétence inclut un script de validation TypeScript exécutable et un tableau des risques classés par priorité. Elle est conçue pour les développeurs et les équipes DevOps qui intègrent AppFolio pour la gestion immobilière et doivent manipuler des données PII sensibles des locataires, des transactions financières et des flux de maintenance.

Compatible avec✓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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Liste de contrôle de mise en production AppFolio

Présentation

AppFolio gère les propriétés, locataires, baux et ordres de travail pour les opérations immobilières. Une intégration de production traite des données PII sensibles des locataires, des transactions financières et des flux de maintenance. Les défaillances signifient des collectes de loyer manquées, des ordres de travail non traités ou une exposition des données des locataires en vertu du CCPA. Cette liste de contrôle garantit que votre intégration API AppFolio est résiliente, conforme et observable.

Prérequis

  • Un contrat partenaire de production vérifié, une URL de base, un mécanisme d'authentification, des périmètres de points de terminaison autorisés, et des responsables nommés pour les décisions commerciales, de sécurité, d'exploitation et de restauration.
  • Une répétition en environnement sandbox réalisée avec des données synthétiques, des identifiants gérés séparés, un budget de requêtes et un plan de restauration/réconciliation enregistré.
  • Des preuves pour l'observabilité, la minimisation des PII, les écritures idempotentes et le routage des alertes—et non un élément de liste de contrôle qui affirme simplement l'existence de ces contrôles.

Instructions

  1. Validez la configuration client réelle fournie par l'éditeur via le gestionnaire de secrets ; ne définissez pas de point de terminaison ou de schéma d'authentification par défaut dans le code de version.
  2. Exécutez les vérifications de préparation en staging, puis une répétition contrôlée en environnement de production qui n'effectue que des lectures sécurisées autorisées.
  3. Considérez comme non valide tout contrôle échoué, ignoré ou invérifiable ; conservez des reçus expurgés pour les identifiants, points de terminaison, surveillance et reprise.
  4. Déployez progressivement uniquement avec un responsable de restauration et de réconciliation testé ; mettez en pause les chemins d'écriture si l'état des paiements, des ordres de travail, des locataires ou des baux est inconnu.

Authentification et secrets

  • APPFOLIO_API_KEY stocké dans un gestionnaire de secrets (pas dans les fichiers d'environnement)
  • ID client et secret séparés du code applicatif
  • Calendrier de rotation des clés documenté (recommandé : 90 jours)
  • Identifiants distincts pour les environnements dev/staging/prod
  • Identifiants API limités aux autorisations minimales requises

Intégration API

  • URL de base de production et méthode d'authentification vérifiées par rapport au contrat partenaire actuel
  • Gestion des limites de débit avec backoff exponentiel
  • Pagination implémentée pour les points de terminaison de listes de propriétés et de locataires
  • Création d'ordres de travail testée avec tous les champs obligatoires
  • Téléchargement de documents de bail validé pour les formats pris en charge
  • Points de terminaison Webhook configurés pour les événements de locataires et de paiements
  • Clés d'idempotence utilisées pour la création de paiements et d'ordres de travail

Gestion des erreurs et résilience

  • Coupe-circuit configuré pour les pannes API AppFolio
  • Nouvelle tentative avec backoff pour les réponses 429/5xx
  • Gestion des PII des locataires vérifiée conforme CCPA/FCRA
  • Validation des données sur toutes les réponses API avant stockage
  • Dégradation progressive lorsque la synchronisation des propriétés est indisponible
  • Détection des ordres de travail en double empêchant la re-création lors d'une nouvelle tentative

Surveillance et alertes

  • Latence API suivie par point de terminaison (propriétés, locataires, ordres de travail)
  • Alertes de taux d'erreur configurées (seuil : >3 % sur 5 minutes)
  • Échec de synchronisation des paiements déclenche une alerte P1 immédiate
  • Échecs de création d'ordres de travail signalés dans les 5 minutes
  • Réconciliation quotidienne du nombre de propriétés synchronisées par rapport à la source

Script de validation

async function checkAppFolioReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  const client = createVerifiedAppFolioClient(); // client lié au contrat de appfolio-security-basics
  // Connectivité API
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'Connectivité API', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Connectivité API', pass: false, detail: e.message }); }
  // La construction du client prouve que l'identifiant géré et le contrat fournisseur sont disponibles.
  checks.push({ name: 'Configuration client vérifiée', pass: true, detail: 'Chargée depuis la configuration gérée' });
  // Point de terminaison des ordres de travail
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: 'Ordres de travail', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Ordres de travail', pass: false, detail: e.message }); }
  for (const c of checks) console.log(`[${c.pass ? 'RÉUSSI' : 'ÉCHEC'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

Gestion des erreurs

VérificationRisque en cas de sautPriorité
Rotation de la clé APILes clés expirées bloquent la synchronisation des propriétésP1
Échec de synchronisation des paiementsCollectes de loyer manquéesP1
Exposition des PII des locatairesViolation CCPA, responsabilité légaleP1
Duplication des ordres de travailEnvoi de maintenance en doubleP2
Gestion des limites de débitErreurs 429 lors de l'import en masse de propriétésP3

Résultat

  • Un reçu de validation/invalidation expurgé liant le client vérifié, les vérifications de lecture sécurisée, l'état de la surveillance, les approbations des responsables, et le plan de restauration/réconciliation.
  • Une liste des contrôles échoués ou non prouvés qui bloque la version jusqu'à correction.
  • Une décision de déploiement limitée qui maintient les chemins sensibles ou avec capacité d'écriture désactivés jusqu'à ce que leur répétition en environnement de production ait des preuves.

Exemples

Pour une version d'intégration d'ordre de travail, exécutez d'abord la liste de contrôle sur un fixture de staging synthétique, puis utilisez le client géré en environnement de production pour une seule lecture sécurisée autorisée. Confirmez la route d'alerte, la rédaction des PII et les contrôles d'idempotence/réconciliation tandis que toutes les écritures restent désactivées. Si un identifiant, un contrat de point de terminaison, une vérification de préparation ou un exercice de restauration ne peut pas être vérifié, déclarez non valide, conservez la révision précédente et demandez au responsable désigné de corriger avant une nouvelle répétition.

Ressources

Prochaines étapes

Consultez appfolio-security-basics pour la protection des données des locataires et le contrôle d'accès.

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".

Skills associés