Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Lista de verificación de preparación para integraciones con AppFolio.

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

Esta skill proporciona una lista de verificación completa de preparación para la producción de integraciones con AppFolio. Es ideal para equipos que implementan sistemas de gestión de propiedades, manejan datos sensibles de inquilinos (PII), transacciones financieras y flujos de trabajo de mantenimiento. La skill cubre autenticación, integración de API, manejo de errores, monitoreo y un script de validación en TypeScript para verificar la conectividad y configuración del cliente. Admite plataformas como Claude Code, Cursor y Codex, y se activa con el comando "appfolio production checklist". El objetivo es garantizar que la integración sea resiliente, conforme a normativas como CCPA y observable, evitando fallos que resulten en cobros de alquiler perdidos, órdenes de trabajo no procesadas o exposición de datos.

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-prod-checklist

Preguntar en tu IA favorita

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

Documentación

Lista de Verificación de Producción para AppFolio

Resumen

AppFolio gestiona propiedades, inquilinos, contratos de arrendamiento y órdenes de trabajo para operaciones inmobiliarias. Una integración en producción maneja datos de identificación personal (PII) sensibles de inquilinos, transacciones financieras y flujos de trabajo de mantenimiento. Fallas aquí significan cobros de alquiler perdidos, órdenes de trabajo no procesadas o exposición de datos de inquilinos bajo CCPA. Esta lista de verificación garantiza que su integración con la API de AppFolio sea resiliente, conforme y observable.

Requisitos Previos

  • Un contrato de socio de producción verificado, URL base, mecanismo de autenticación, alcances de endpoint permitidos y propietarios designados para decisiones comerciales, de seguridad, operaciones y de reversión.
  • Un ensayo en entorno sandbox completado con datos sintéticos, credenciales administradas separadas, un presupuesto de solicitudes y un plan de reversión/reconciliación registrado.
  • Evidencia de observabilidad, minimización de PII, escrituras idempotentes y enrutamiento de alertas—no solo un elemento de la lista de verificación que afirme que esos controles existen.

Instrucciones

  1. Valide la configuración real del cliente emitida por el proveedor a través del administrador de secretos; no utilice un endpoint o esquema de autenticación por defecto en el código de lanzamiento.
  2. Ejecute las comprobaciones de preparación en staging, luego un ensayo controlado con forma de producción que realice solo lecturas seguras autorizadas.
  3. Revise cada control fallido, omitido o no verificable como un no-go; conserve recibos redactados de credenciales, endpoints, monitoreo y recuperación.
  4. Lance progresivamente solo con un propietario de reversión y reconciliación probado; pause las rutas de escritura si se desconoce el estado de pagos, órdenes de trabajo, inquilinos o contratos de arrendamiento.

Autenticación y Secretos

  • APPFOLIO_API_KEY almacenada en el administrador de secretos (no en archivos de entorno)
  • ID de cliente y secreto separados del código de la aplicación
  • Programa de rotación de claves documentado (recomendado cada 90 días)
  • Credenciales separadas para entornos dev/staging/prod
  • Credenciales de API con alcance limitado a los permisos mínimos requeridos

Integración de API

  • URL base de producción y método de autenticación verificados contra el contrato de socio actual
  • Manejo de límite de velocidad con retroceso exponencial
  • Paginación implementada para endpoints de listas de propiedades e inquilinos
  • Creación de órdenes de trabajo probada con todos los campos requeridos
  • Carga de documentos de arrendamiento validada para formatos compatibles
  • Webhooks configurados para eventos de inquilinos y pagos
  • Claves de idempotencia utilizadas para la creación de pagos y órdenes de trabajo

Manejo de Errores y Resiliencia

  • Interruptor de circuito configurado para cortes de API de AppFolio
  • Reintento con retroceso para respuestas 429/5xx
  • Manejo de PII de inquilinos verificado como compatible con CCPA/FCRA
  • Validación de datos en todas las respuestas de API antes del almacenamiento
  • Degradación gradual cuando la sincronización de propiedades no está disponible
  • Detección de órdenes de trabajo duplicadas para evitar la recreación en reintentos

Monitoreo y Alertas

  • Latencia de API rastreada por endpoint (propiedades, inquilinos, órdenes de trabajo)
  • Alertas de tasa de error configuradas (umbral: >3% en 5 minutos)
  • Sincronización de pagos fallida activa alerta P1 inmediata
  • Fallas de creación de órdenes de trabajo reportadas en 5 minutos
  • Conciliación diaria de conteos de propiedades sincronizadas vs origen

Script de Validación

async function checkAppFolioReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  const client = createVerifiedAppFolioClient(); // cliente vinculado al contrato desde appfolio-security-basics
  // Conectividad de API
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'Conectividad de API', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Conectividad de API', pass: false, detail: e.message }); }
  // La construcción del cliente demuestra que la credencial administrada y el contrato del proveedor están disponibles.
  checks.push({ name: 'Configuración de cliente verificada', pass: true, detail: 'Cargado desde configuración administrada' });
  // Endpoint de órdenes de trabajo
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: 'Órdenes de trabajo', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Órdenes de trabajo', pass: false, detail: e.message }); }
  for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

Manejo de Errores

VerificaciónRiesgo si se OmitePrioridad
Rotación de clave de APIClaves expiradas detienen la sincronización de propiedadesP1
Falla de sincronización de pagosCobros de alquiler perdidosP1
Exposición de PII de inquilinosViolación de CCPA, responsabilidad legalP1
Duplicación de órdenes de trabajoDespacho duplicado de mantenimientoP2
Manejo de límite de velocidadErrores 429 durante la importación masiva de propiedadesP3

Salida

  • Un recibo de aprobación/rechazo redactado que vincula el cliente verificado, comprobaciones de lectura segura, estado de monitoreo, aprobaciones de propietarios y el plan de reversión/reconciliación
  • Una lista de controles fallidos o no probados que bloquea el lanzamiento hasta que se remedien
  • Una decisión de lanzamiento acotada que mantiene las rutas sensibles o de escritura desactivadas hasta que su ensayo con forma de producción tenga evidencia

Ejemplos

Para un lanzamiento de integración de órdenes de trabajo, ejecute primero la lista de verificación contra un fixture de staging sintético, luego use el cliente administrado con forma de producción para una sola lectura segura autorizada. Confirme la ruta de alerta, la redacción de PII y los controles de idempotencia/reconciliación mientras todas las escrituras permanecen deshabilitadas. Si no se puede verificar una credencial, contrato de endpoint, comprobación de preparación o ejercicio de reversión, declare no-go, conserve la revisión anterior y haga que el propietario asignado remedie antes de un nuevo ensayo.

Recursos

Próximos Pasos

Consulte appfolio-security-basics para la protección de datos de inquilinos y control de acceso.

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 relacionados