Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Implementa el servicio de integración con AppFolio en una infraestructura en la nube.

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

Esta skill automatiza el despliegue de un servicio de integración de gestión inmobiliaria con AppFolio, empaquetado en un contenedor Docker listo para producción. Está diseñado para desarrolladores que necesitan conectar aplicaciones con la API Stack de AppFolio y gestionar propiedades, inquilinos y órdenes de trabajo. Es compatible con plataformas de despliegue que soportan actualizaciones rolling o canary, health checks y gestión de secretos. El flujo de trabajo incluye la construcción de una imagen no-root, la inyección de credenciales desde un gestor de secretos en tiempo de ejecución, y una estrategia de despliegue gradual con verificación de readiness y liveness. Incluye configuraciones para entornos multi-propiedad, manejo de errores para códigos de respuesta comunes de la API, y un plan de incidencias para estados de reconciliación desconocidos. El resultado es un despliegue seguro y auditable que mantiene la disponibilidad del servicio durante las actualizaciones.

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

Preguntar en tu IA favorita

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

Documentación

Integración de Despliegue AppFolio

Resumen

Despliega un servicio de integración de gestión inmobiliaria AppFolio contenerizado con Docker. Esta skill cubre la construcción de una imagen lista para producción que se conecta a la API Stack de AppFolio para gestionar propiedades, inquilinos y órdenes de trabajo. Incluye configuración de entorno para configuraciones multi-propiedad, health checks que verifican la conectividad de la API y estrategias de actualización rolling para despliegues sin tiempo de inactividad en tu cartera de propiedades.

Requisitos Previos

  • Un contrato de proveedor verificado y un cliente AppFolio respaldado por un gestor de secretos y vinculado al contrato; no coloques valores de credenciales en capas de imagen, archivos compose, historial del shell o registros de despliegue.
  • Una plataforma de despliegue que pueda realizar una actualización rolling/canary real con comprobaciones de readiness, control de tráfico, rollback y un propietario de versión nombrado.
  • Identidades separadas de staging y producción, un fixture sintético de staging para pruebas de humo y un plan de incidencias para estados de escritura o reconciliación desconocidos.

Instrucciones

  1. Construye una imagen no-root con dependencias fijadas y expón solo un endpoint local de liveness; la disponibilidad del proveedor pertenece al readiness, no a la supervivencia del proceso.
  2. Inyecta la configuración del cliente verificado en tiempo de ejecución desde el gestor de secretos y valida su contrato en staging mediante una lectura segura autorizada.
  3. Despliega una nueva revisión gradualmente, monitorea señales de readiness/error redactadas y retén la revisión anterior hasta que la ventana de tráfico se complete con éxito.
  4. Ante cualquier fallo de readiness, contrato, secreto o verificación de reconciliación, detén la promoción de tráfico y revierte el cambio a través de la plataforma de despliegue.

Configuración de Docker

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

Configuración de Ejecución

# Los valores son inyectados por el gestor de secretos de la plataforma de despliegue; no
# pegues credenciales en vivo en un comando de terminal o en una configuración versionada.
APPFOLIO_BASE_URL="URL base proporcionada por el proveedor"
APPFOLIO_COMPANY_ID="identificador de cartera aprobado"
export LOG_LEVEL="info"
export PORT="3000"
export NODE_ENV="production"

Endpoint de Health Check

import express from 'express';

const app = express();

// Liveness demuestra que este proceso puede servir; no debe reiniciar un worker sano
// únicamente porque el proveedor externo esté degradado.
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 devolvió ${response.status}`);
    res.json({ status: 'ready', service: 'appfolio-integration', timestamp: new Date().toISOString() });
  } catch (error) {
    res.status(503).json({ status: 'not-ready', error: 'la comprobación de readiness del proveedor falló' });
  }
});

Pasos de Despliegue

Paso 1: Construir

docker build -t appfolio-integration:latest .

Paso 2: Ejecutar

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

Paso 3: Verificar

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

Paso 4: Actualización Rolling

# Envía el digest de la imagen inmutable al controlador de despliegue de la plataforma.
# Configura /health como liveness y /ready como readiness, cambia el tráfico en
# etapas y retén la revisión anterior hasta que la ventana de versión se complete.

Manejo de Errores

ProblemaCausaSolución
401 No AutorizadoClave API inválida o expiradaRegenerar clave en el portal de socios de AppFolio Stack
403 ProhibidoFalta ámbito de acceso a propiedadesSolicitar ámbitos adicionales al administrador de AppFolio
404 No EncontradoURL base o ID de empresa incorrectosVerificar que APPFOLIO_BASE_URL coincida con tu subdominio
429 Límite de VelocidadDemasiadas solicitudes por minutoImplementar backoff exponencial con ventana de 60s
El contenedor sale inmediatamenteFaltan variables de entorno requeridasAsegurar que todas las variables de entorno estén configuradas antes de iniciar

Salida

  • Un contenedor no-root con un endpoint local de liveness y un resultado de readiness del proveedor separado y redactado
  • Un límite de configuración entre el gestor de secretos y el entorno de ejecución, en lugar de valores de credenciales en imágenes o comandos
  • Un recibo de despliegue por etapas con evidencia de readiness, estado del tráfico, propietario, objetivo de rollback y estado de reconciliación

Ejemplos

Para una versión de sincronización de propiedades, despliega la nueva imagen en staging con un fixture sintético de lectura segura y confirma que /health permanezca vivo mientras que /ready refleje el resultado del cliente del proveedor. Promociona una pequeña porción de tráfico de producción solo después de que la identidad gestionada, el readiness redactado, las alertas y el objetivo de rollback estén verificados. Si el readiness falla, falta un secreto o una escritura previa tiene un resultado desconocido, congela la promoción, devuelve el tráfico a la revisión anterior y asigna reconciliación antes de intentar otro despliegue.

Recursos

Próximos Pasos

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

Skills relacionados