Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Migre entre versões da API do AppFolio e gerencie alterações de endpoints.

O que é tons-of-skills-marketplace?

Esta skill automatiza o processo de migração entre versões da API REST do AppFolio, um sistema de gerenciamento de propriedades. Ela detecta a versão atual da API que sua integração está utilizando, mapeia alterações significativas (como renomeação de campos em objetos de propriedade e inquilino, mudanças no modelo de paginação, descontinuação de endpoints e alterações no fluxo de autenticação básica) e aplica transformações de esquema automaticamente. A skill também implementa uma estratégia de rollback automático: se a nova versão falhar, ela reverte para a versão anterior, garantindo continuidade das operações. É útil para desenvolvedores que mantêm integrações com o AppFolio, suporta ambientes de staging e produção, e depende de variáveis de ambiente para credenciais de cliente. O fluxo inclui detecção de versão, revisão de changelog, migração de esquema, atualização de URLs, troca de paginação offset para cursor, execução de testes de fumaça e monitoramento de erros 410/401.

Funciona com✓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-upgrade-migration

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Atualização e Migração do AppFolio

Visão Geral

As integrações de gerenciamento de propriedades do AppFolio dependem de endpoints REST versionados que evoluem com a plataforma. As atualizações podem renomear campos em objetos de propriedade e inquilino, alterar modelos de paginação, descontinuar endpoints de ordens de serviço e modificar o fluxo de autenticação básica. Esta skill detecta sua versão atual da API, mapeia formas de resposta obsoletas para suas substituições e reverte automaticamente caso a nova versão falhe.

Pré-requisitos

  • Prefixo da versão atual da API documentado (ex.: /api/v1/)
  • Acesso ao changelog e notas de versão da API do AppFolio
  • Ambiente de staging com dados de teste de propriedade e inquilino
  • ID do cliente e segredo armazenados em variáveis de ambiente
  • Suite de testes de integração existente que cobre endpoints principais

Instruções

  1. Execute a detecção de versão para comparar sua versão ativa da API com a mais recente.
  2. Revise o changelog do AppFolio para alterações significativas entre as duas versões.
  3. Aplique as transformações de migração de esquema nos objetos de resposta de propriedade e inquilino.
  4. Atualize as URLs dos endpoints do prefixo de versão antigo para o novo.
  5. Altere a paginação de offset para cursor, se exigido pela nova versão.
  6. Execute a suite de testes de fumaça contra o staging para verificar se todos os endpoints respondem.
  7. Implante em produção com a estratégia de rollback habilitada.
  8. Monitore logs de erro para respostas 410/401 que indiquem etapas de migração perdidas.

Saída

Após uma migração bem-sucedida, a skill produz:

  • Um objeto VersionInfo confirmando as versões atual, mais recente e obsoletas
  • Objetos de propriedade e inquilino transformados de acordo com o novo esquema
  • Resultados dos testes de fumaça para endpoints de propriedades, inquilinos, ordens de serviço e contabilidade
  • Entradas de log de rollback se algum endpoint retrocedeu para a versão anterior

Detecção de Versão

interface VersionInfo { current: string; latest: string; deprecated: string[]; }

async function detectApiVersion(baseUrl: string, headers: Record<string, string>): Promise<VersionInfo> {
  const res = await fetch(`${baseUrl}/api/status`, { headers });
  const body = await res.json();
  const current = res.headers.get("X-AppFolio-Api-Version") ?? body.api_version;
  const deprecated: string[] = body.deprecated_versions ?? [];
  if (deprecated.includes(current)) {
    console.warn(`Version ${current} is deprecated. Migrate to ${body.latest_version}.`);
  }
  return { current, latest: body.latest_version, deprecated };
}

Migração de Esquema

interface LegacyProperty { address_line1: string; unit_count: number; mgr_id: string; }
interface CurrentProperty { street_address: string; total_units: number; manager_id: string; }

function migrateProperty(old: LegacyProperty): CurrentProperty {
  return { street_address: old.address_line1, total_units: old.unit_count, manager_id: old.mgr_id };
}

interface LegacyTenant { lease_end: string; balance_due: number; }
interface CurrentTenant { lease_expiry_date: string; outstanding_balance: number; }

function migrateTenant(old: LegacyTenant): CurrentTenant {
  return { lease_expiry_date: old.lease_end, outstanding_balance: old.balance_due };
}

Estratégia de Rollback

async function versionAwareRequest(
  baseUrl: string, path: string, headers: Record<string, string>,
  targetVersion: string, fallbackVersion: string
): Promise<any> {
  const res = await fetch(`${baseUrl}/api/${targetVersion}${path}`, { headers });
  if (res.status === 410 || res.status === 404) {
    console.warn(`${targetVersion} rejected; falling back to ${fallbackVersion}`);
    const fallback = await fetch(`${baseUrl}/api/${fallbackVersion}${path}`, { headers });
    if (!fallback.ok) throw new Error(`Fallback failed: ${fallback.status}`);
    return fallback.json();
  }
  if (!res.ok) throw new Error(`Request failed: ${res.status}`);
  return res.json();
}

Exemplos

// Detect version and migrate if needed
const info = await detectApiVersion("https://acme.appfolio.com", authHeaders);
if (info.deprecated.includes(info.current)) {
  const oldProps = await fetchLegacyProperties();
  const migrated = oldProps.map(migrateProperty);
  await smokeTestEndpoints("https://acme.appfolio.com", authHeaders);
}

Tratamento de Erros

Problema de MigraçãoSintomaCorreção
Prefixo de versão obsoleto410 Gone em toda requisiçãoAtualizar URL base para o prefixo da versão mais recente
Campos de propriedade renomeadosValores undefined na sincronização de propriedadesAplicar transformação migrateProperty
Offset de paginação removidoConjuntos de resultados vazios após a primeira páginaMudar para paginação baseada em cursor
Cabeçalho de autenticação rejeitado401 Unauthorized após atualizaçãoRegenerar segredo do cliente, atualizar variáveis de ambiente
Alteração no envelope do webhookErros de análise no manipulador de eventosAtualizar parser de payload para novo envelope

Recursos

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

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

Habilidades Relacionadas