Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configure un environnement de développement local pour l'intégration de l'API de gestion immobilière AppFolio.

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

Cette compétence met en place un environnement de développement local rapide et itératif pour l'intégration de l'API AppFolio Stack. Elle fournit un serveur mock avec des données synthétiques de propriétés, locataires et baux, permettant de développer et tester sans consommer de quota API réel. Elle prend en charge un mode mock pour les itérations rapides et une voie sandbox séparée, gérée et en lecture seule, pour la validation avant déploiement. L'utilisateur peut basculer entre ces modes, mais le serveur local est strictement mock-only. Des instructions claires sont données pour les tests unitaires, la gestion des erreurs et la journalisation, garantissant que les données de production ne sont jamais exposées et que les credentials sandbox ne sont jamais chargés localement. La compétence inclut du code TypeScript prêt à l'emploi, des scripts npm et une stratégie de test avec Vitest et Supertest.

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

Demander à votre IA préférée

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

Documentation

Boucle de développement local AppFolio

Aperçu

Workflow de développement local pour l'intégration de l'API de gestion immobilière AppFolio. Offre une boucle de rétroaction rapide avec des points de terminaison simulés (propriétés, locataires, baux) afin de construire et tester des intégrations sans consommer de quota API réel. Basculez entre le mode mock pour des itérations rapides et le mode sandbox pour une validation pré-déploiement contre l'API AppFolio Stack réelle.

Prérequis

  • Un environnement local mock-only avec des jeux de données synthétiques de propriétés, locataires, baux et ordres de travaux ne contenant aucune adresse, nom ou paiement de production.
  • Un identifiant sandbox géré séparément et un jeu de données sécurisé en lecture seule approuvé pour la voie d'intégration dédiée ; il n'est jamais chargé par le serveur de développement local.
  • Une politique de journalisation qui enregistre uniquement la forme et le statut de la requête, ainsi qu'un propriétaire explicite pour le quota sandbox, la réinitialisation des jeux de données et la rotation des identifiants.

Instructions

  1. Lancez le serveur local uniquement en mode mock et effectuez des lectures/écritures sur des routes synthétiques avec des jeux de données déterministes.
  2. Testez la validation des requêtes, l'idempotence, la rédaction et la gestion des erreurs dans les tests unitaires avant toute vérification de connectivité sandbox.
  3. Exécutez la voie sandbox séparément avec le client géré lié par contrat et un seul jeu de données sécurisé en lecture seule autorisé ; ne transformez pas un proxy local en tunnel API live.
  4. Arrêtez-vous lorsque le jeu de données, les identifiants, le budget de requêtes ou la rédaction des sorties ne sont pas vérifiés, puis corrigez l'environnement avant de continuer.

Configuration de l'environnement

cp .env.example .env
# Laissez les identifiants du fournisseur vides en local. Le mode mock est le mode par défaut.
# MOCK_MODE=true
npm install express axios dotenv tsx typescript @types/node
npm install -D vitest supertest @types/express

Serveur de développement

// 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("Le serveur local est mock-only ; utilisez la voie d'intégration sandbox gérée");
const { mountMockRoutes } = require("./mocks");
mountMockRoutes(app);
app.listen(3001, () => console.log(`Serveur de développement AppFolio sur :3001 [mock=${MOCK}]`));

Mode Mock

// src/dev/mocks.ts — réponses réalistes de gestion immobilière
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" }));
}

Workflow de test

npm run dev:mock &                    # Lance le serveur mock en arrière-plan
npm run test                          # Tests unitaires avec vitest
npm run test -- --watch               # Mode surveillance pour itérations rapides
npm run test:sandbox                     # Voie sandbox gérée en lecture seule

Conseils de débogage

  • Définissez DEBUG=express:* pour tracer tout le routage et l'exécution des middlewares
  • Utilisez des assertions de test locales pour les comptes de jeux de données et la forme du schéma, pas les vidages bruts de données de locataires
  • Vérifiez l'en-tête X-RateLimit-Remaining lors des tests contre l'API live
  • Le sandbox AppFolio renvoie 403 pour les propriétés que vous ne possédez pas — vérifiez la portée de votre clé API
  • Utilisez des intercepteurs uniquement pour la télémétrie de point de terminaison/statut/comptage lors du développement

Résultat

  • Un serveur local mock-only déterministe avec des jeux de données synthétiques de gestion immobilière et aucune dépendance aux identifiants du fournisseur
  • Preuve de test unitaire pour la validation, l'idempotence et l'observabilité sans PII
  • Un résultat sandbox géré séparé contenant uniquement un statut de lecture sécurisée rédigé

Exemples

Pour un changement d'interface utilisateur d'ordre de travail, ajoutez un jeu de données synthétique mock et testez le schéma de la requête ainsi que le comportement de soumission en double localement. Affirmez l'ID et le statut renvoyés sans émettre le corps de la requête ni l'enregistrement du locataire. Une fois les tests unitaires réussis, exécutez la voie sandbox dédiée sur un seul jeu de données sécurisé en lecture seule approuvé. Si le mode mock est désactivé, qu'un identifiant sandbox apparaît localement, ou qu'une réponse contient des champs de locataires non rédigés, arrêtez l'exécution et restaurez la frontière locale.

Gestion des erreurs

ProblèmeCauseSolution
401 UnauthorizedClé API invalide ou expiréeRégénérez-la sur le portail AppFolio Stack
403 ForbiddenLa clé manque de portée pour le point de terminaisonDemandez des autorisations supplémentaires
404 Not FoundMauvais ID de propriété ou cheminVérifiez que la ressource existe dans le sandbox
429 Too Many RequestsLimite de débit dépasséeAjoutez un backoff exponentiel, utilisez le mode mock
ECONNREFUSED :3001Le serveur de développement ne tourne pasExécutez npm run dev:mock d'abord

Ressources

Prochaines étapes

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

Skills associés