Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Lista de verificação de prontidão para integrações com AppFolio.

O que é tons-of-skills-marketplace?

Esta skill fornece uma lista de verificação estruturada e detalhada para garantir que integrações com a API da AppFolio estejam prontas para produção. Ela abrange autenticação, integração de API, tratamento de erros, monitoramento e conformidade com regulamentações como CCPA. A habilidade é útil para equipes de engenharia que precisam validar a resiliência, segurança e observabilidade de suas integrações antes de liberar para produção, evitando problemas como coleta de aluguel perdida, exposição de dados de inquilinos ou duplicação de ordens de serviço. Ela inclui um script de validação em TypeScript que testa a conectividade da API e a configuração do cliente, além de uma tabela de tratamento de erros que prioriza os riscos. Baseada no SKILL.md, a skill suporta plataformas como Claude Code, Cursor ou Codex, e orienta o usuário através de pré-requisitos, instruções passo a passo e verificações específicas, culminando em uma decisão de liberação segura e documentada.

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

Perguntar na sua IA favorita

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

Documentação

Lista de Verificação de Prontidão para AppFolio

Visão Geral

A AppFolio gerencia propriedades, inquilinos, contratos de locação e ordens de serviço para operações imobiliárias. Uma integração de produção lida com PII sensível de inquilinos, transações financeiras e fluxos de trabalho de manutenção. Falhas aqui significam perda de coleta de aluguel, ordens de serviço não processadas ou exposição de dados de inquilinos sob a CCPA. Esta lista de verificação garante que sua integração com a API da AppFolio seja resiliente, compatível e observável.

Pré-requisitos

  • Um contrato de parceiro de produção verificado, URL base, mecanismo de autenticação, escopos de endpoint permitidos e proprietários nomeados para decisões de negócios, segurança, operações e rollback.
  • Um ensaio em sandbox concluído usando dados sintéticos, credenciais gerenciadas separadas, um orçamento de requisição e um plano registrado de rollback/reconciliação.
  • Evidências para observabilidade, minimização de PII, writes idempotentes e roteamento de alertas—não um item de lista de verificação que meramente afirma que esses controles existem.

Instruções

  1. Valide a configuração real do cliente emitida pelo provedor através do gerenciador de segredos; não use um endpoint ou esquema de autenticação padrão no código de release.
  2. Execute as verificações de prontidão em staging e, em seguida, um ensaio controlado com características de produção que realize apenas leituras seguras autorizadas.
  3. Revise cada controle falho, ignorado ou não verificável como um impedimento; preserve recibos editados para credenciais, endpoints, monitoramento e recuperação.
  4. Libere progressivamente apenas com um proprietário testado de rollback e reconciliação; pause os caminhos de escrita se o estado de pagamento, ordem de serviço, inquilino ou locação for desconhecido.

Autenticação e Segredos

  • APPFOLIO_API_KEY armazenada no gerenciador de segredos (não em arquivos de ambiente)
  • ID do cliente e segredo separados do código da aplicação
  • Cronograma de rotação de chaves documentado (recomendado a cada 90 dias)
  • Credenciais separadas para ambientes dev/staging/prod
  • Credenciais da API com escopo limitado às permissões mínimas necessárias

Integração da API

  • URL base de produção e método de autenticação verificados contra o contrato de parceiro atual
  • Tratamento de limite de taxa com backoff exponencial
  • Paginação implementada para endpoints de lista de propriedades e inquilinos
  • Criação de ordem de serviço testada com todos os campos obrigatórios
  • Upload de documento de locação validado para formatos suportados
  • Endpoints de webhook configurados para eventos de inquilino e pagamento
  • Chaves de idempotência usadas para criação de pagamento e ordem de serviço

Tratamento de Erros e Resiliência

  • Disjuntor configurado para interrupções da API AppFolio
  • Repetição com backoff para respostas 429/5xx
  • Tratamento de PII de inquilino verificado conforme CCPA/FCRA
  • Validação de dados em todas as respostas da API antes do armazenamento
  • Degradação graciosa quando a sincronização de propriedades não está disponível
  • Detecção de ordem de serviço duplicada evita recriação em retentativa

Monitoramento e Alertas

  • Latência da API rastreada por endpoint (propriedades, inquilinos, ordens de serviço)
  • Alertas de taxa de erro definidos (limite: >3% em 5 minutos)
  • Falha na sincronização de pagamento aciona alerta P1 imediato
  • Falhas na criação de ordem de serviço relatadas dentro de 5 minutos
  • Reconciliação diária das contagens de propriedades sincronizadas vs. origem

Script de Validação

async function checkAppFolioReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  const client = createVerifiedAppFolioClient(); // client vinculado ao contrato de appfolio-security-basics
  // Conectividade da API
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'Conectividade da API', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Conectividade da API', pass: false, detail: e.message }); }
  // A construção do cliente prova que a credencial gerenciada e o contrato do provedor estão disponíveis.
  checks.push({ name: 'Configuração verificada do cliente', pass: true, detail: 'Carregada da configuração gerenciada' });
  // Endpoint de ordens de serviço
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: 'Ordens de Serviço', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Ordens de Serviço', pass: false, detail: e.message }); }
  for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

Tratamento de Erros

VerificaçãoRisco se IgnoradoPrioridade
Rotação de chave da APIChaves expiradas interrompem a sincronização de propriedadesP1
Falha na sincronização de pagamentoColeta de aluguel perdidaP1
Exposição de PII de inquilinoViolação da CCPA, responsabilidade legalP1
Duplicação de ordem de serviçoDespacho de manutenção duplicadoP2
Tratamento de limite de taxaErros 429 durante importação em massa de propriedadesP3

Saída

  • Um recibo editado de vai/não vai vinculando o cliente verificado, verificações de leitura segura, estado de monitoramento, aprovações dos proprietários e plano de rollback/reconciliação
  • Uma lista de controles falhos ou não comprovados que bloqueia o lançamento até serem corrigidos
  • Uma decisão de lançamento limitada que mantém caminhos sensíveis ou com capacidade de escrita desativados até que seu ensaio com características de produção tenha evidências

Exemplos

Para um lançamento de integração de ordem de serviço, execute a lista de verificação primeiro contra uma fixture de staging sintética e, em seguida, use o cliente gerenciado com características de produção para uma única leitura segura autorizada. Confirme a rota de alerta, a edição de PII e os controles de idempotência/reconciliação enquanto todos os writes permanecem desabilitados. Se uma credencial, contrato de endpoint, verificação de prontidão ou exercício de rollback não puder ser verificado, declare não vai, mantenha a revisão anterior e tenha o proprietário designado para corrigir antes de um novo ensaio.

Recursos

Próximos Passos

Consulte appfolio-security-basics para proteção de dados de inquilinos e controle de acesso.

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

Habilidades Relacionadas