Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configura el entorno de desarrollo local para la integración con la API de administración de propiedades de AppFolio.

¿Qué es tons-of-skills-marketplace?

Este skill proporciona un flujo de trabajo completo para el desarrollo local de integraciones con la API de AppFolio Stack. Ofrece un modo mock con fixtures sintéticos de propiedades, inquilinos y contratos de arrendamiento, permitiendo iteraciones rápidas sin consumir cuota de API real. Además, soporta un modo sandbox separado para validaciones previas al despliegue con credenciales gestionadas y un fixture de solo lectura autorizado. Es útil para desarrolladores que necesitan probar validación de solicitudes, idempotencia, enmascaramiento de datos y manejo de errores antes de interactuar con la API en vivo. El skill incluye un servidor Express configurado, rutas mock, un flujo de pruebas con Vitest y pautas claras de seguridad y telemetría.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Bucle de Desarrollo Local AppFolio

Resumen

Flujo de trabajo de desarrollo local para la integración con la API de administración de propiedades de AppFolio. Proporciona un ciclo de retroalimentación rápida con endpoints mock de propiedades, inquilinos y arrendamientos, para que puedas construir y probar integraciones sin consumir cuota de API en vivo. Alterna entre modo mock para iteración rápida y modo sandbox para validación previa al despliegue contra la API real de AppFolio Stack.

Requisitos previos

  • Un entorno local exclusivamente mock con fixtures sintéticos de propiedades, inquilinos, arrendamientos y órdenes de trabajo que no contengan direcciones, nombres o pagos reales.
  • Una credencial sandbox gestionada por separado y un fixture de solo lectura aprobado para el carril de integración dedicado; nunca es cargado por el servidor de desarrollo local.
  • Una política de registro que solo registre la forma y el estado de la solicitud, más un propietario explícito para la cuota sandbox, el restablecimiento de fixtures y la rotación de credenciales.

Instrucciones

  1. Ejecuta el servidor local solo en modo mock y realiza lecturas/escrituras contra rutas sintéticas con fixtures deterministas.
  2. Prueba la validación de solicitudes, idempotencia, enmascaramiento y manejo de errores en pruebas unitarias antes de cualquier verificación de conectividad sandbox.
  3. Ejecuta el carril sandbox por separado con el cliente gestionado vinculado al contrato y un fixture de solo lectura autorizado; no conviertas un proxy local en un túnel de API en vivo.
  4. Detente cuando el fixture, las credenciales, el presupuesto de solicitudes o el enmascaramiento de salida no estén verificados, luego corrige el entorno antes de continuar.

Configuración del Entorno

cp .env.example .env
# Deja las credenciales del proveedor en blanco localmente. El modo mock es el predeterminado.
# MOCK_MODE=true
npm install express axios dotenv tsx typescript @types/node
npm install -D vitest supertest @types/express

Servidor de Desarrollo

// 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("El servidor local es solo mock; usa el carril de integración sandbox gestionado");
const { mountMockRoutes } = require("./mocks");
mountMockRoutes(app);
app.listen(3001, () => console.log(`Servidor de desarrollo AppFolio en :3001 [mock=${MOCK}]`));

Modo Mock

// src/dev/mocks.ts — respuestas realistas de gestión de propiedades
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" }));
}

Flujo de Trabajo de Pruebas

npm run dev:mock &                    # Inicia el servidor mock en segundo plano
npm run test                          # Pruebas unitarias con vitest
npm run test -- --watch               # Modo vigilancia para iteración rápida
npm run test:sandbox                     # Carril sandbox gestionado y de solo lectura

Consejos de Depuración

  • Configura DEBUG=express:* para rastrear todas las coincidencias de rutas y la ejecución de middleware
  • Usa aserciones locales de prueba para conteos de fixtures y forma del esquema, no volcados de payload de inquilinos en bruto
  • Revisa el encabezado X-RateLimit-Remaining al probar contra la API en vivo
  • El sandbox de AppFolio devuelve 403 para propiedades que no posees: verifica el alcance de tu clave API
  • Usa interceptores solo para telemetría de endpoint/estado/recuento enmascarada durante el desarrollo

Salida

  • Un servidor local determinista solo mock con fixtures sintéticos de gestión de propiedades y sin dependencia de credenciales del proveedor
  • Evidencia de pruebas unitarias para validación, idempotencia y observabilidad segura de PII
  • Un resultado sandbox gestionado separado que contiene solo estado de lectura segura enmascarado

Ejemplos

Para un cambio de UI de órdenes de trabajo, agrega un fixture mock sintético y prueba el esquema de solicitud más el comportamiento de envío duplicado localmente. Verifica el ID y estado devueltos sin emitir el cuerpo de la solicitud ni el registro del inquilino. Después de que pasen las pruebas unitarias, ejecuta el carril sandbox dedicado contra un fixture de solo lectura aprobado. Si el modo mock está deshabilitado, aparece una credencial sandbox localmente, o una respuesta contiene campos de inquilino sin enmascarar, detén la ejecución y restablece el límite local.

Manejo de Errores

ProblemaCausaSolución
401 UnauthorizedClave API inválida o expiradaRegenerar en el portal de AppFolio Stack
403 ForbiddenLa clave no tiene alcance para el endpointSolicitar permisos adicionales
404 Not FoundID de propiedad o ruta incorrectosVerificar que el recurso exista en el sandbox
429 Too Many RequestsLímite de tasa excedidoAgregar retroceso exponencial, usar modo mock
ECONNREFUSED :3001El servidor de desarrollo no está en ejecuciónEjecuta npm run dev:mock primero

Recursos

Próximos Pasos

Consulta 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 relacionados