Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Implante o serviço de integração AppFolio na infraestrutura em nuvem.

O que é tons-of-skills-marketplace?

Este skill permite implantar um serviço de integração containerizado com o AppFolio Stack API para gerenciar propriedades, inquilinos e ordens de serviço. Ele cobre desde a construção de uma imagem Docker segura (não-root) com dependências fixas, configuração de runtime via gerenciador de segredos, e health checks que diferenciam liveness (processo ativo) de readiness (conectividade com o provedor). Suporta estratégias de rolling update com zero-downtime, rollback controlado e validação de contrato em staging antes de promover tráfego para produção. Ideal para portfólios multi-propriedade, o skill enfatiza segurança de credenciais e auditoria de reconciliação, sendo compatível com qualquer plataforma de deployment que suporte canary releases e readiness probes.

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

Perguntar na sua IA favorita

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

Documentação

AppFolio Deploy Integration

Visão Geral

Implante um serviço de integração containerizado de gerenciamento de propriedades AppFolio com Docker. Este skill cobre a construção de uma imagem pronta para produção que se conecta à AppFolio Stack API para gerenciar propriedades, inquilinos e ordens de serviço. Inclui configuração de ambiente para setups multi-propriedade, verificações de integridade que confirmam a conectividade da API e estratégias de atualização contínua para implantações com zero downtime em todo o seu portfólio de propriedades.

Pré-requisitos

  • Um contrato de provedor verificado e um cliente AppFolio vinculado ao contrato e apoiado por um gerenciador de segredos; não coloque valores de credenciais em camadas de imagem, arquivos compose, histórico de shell ou logs de implantação.
  • Uma plataforma de implantação que possa realizar uma atualização contínua/canary real com verificações de prontidão, controle de tráfego, rollback e um proprietário de release nomeado.
  • Identidades separadas de staging e produção, um fixture sintético de smoke test para staging e um plano de incidente para estado de gravação ou reconciliação desconhecido.

Instruções

  1. Construa uma imagem não-root com dependências travadas e exponha apenas um endpoint de liveness local; a disponibilidade do provedor pertence à prontidão, não à sobrevivência do processo.
  2. Injete a configuração verificada do cliente em runtime a partir do gerenciador de segredos e valide seu contrato em staging por meio de uma leitura segura autorizada.
  3. Lance uma nova revisão gradualmente, monitore sinais de prontidão/erro (com dados sensíveis omitidos) e retenha a revisão anterior até que a janela de tráfego seja bem-sucedida.
  4. Em qualquer falha de prontidão, contrato, segredo ou verificação de reconciliação, interrompa a promoção de tráfego e reverta por meio da plataforma de implantação.

Configuração 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"]

Configuração em Tempo de Execução

# Os valores são injetados pelo gerenciador de segredos da plataforma de implantação;
# não cole credenciais ativas em um comando de terminal ou em configuração versionada.
APPFOLIO_BASE_URL="URL base fornecida pelo provedor"
APPFOLIO_COMPANY_ID="identificador de portfólio aprovado"
export LOG_LEVEL="info"
export PORT="3000"
export NODE_ENV="production"

Endpoint de Verificação de Integridade

import express from 'express';

const app = express();

// Liveness prova que este processo pode atender; não deve reiniciar um worker
// saudável apenas porque o provedor 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 retornou ${response.status}`);
    res.json({ status: 'ready', service: 'appfolio-integration', timestamp: new Date().toISOString() });
  } catch (error) {
    res.status(503).json({ status: 'not-ready', error: 'verificação de prontidão do provedor falhou' });
  }
});

Etapas de Implantação

Etapa 1: Construir

docker build -t appfolio-integration:latest .

Etapa 2: Executar

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

Etapa 3: Verificar

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

Etapa 4: Atualização Contínua

# Submeta o digest da imagem imutável ao controlador de implantação da plataforma.
# Configure /health como liveness e /ready como readiness, desloque o tráfego em
# estágios e retenha a revisão anterior até que a janela de release seja concluída.

Tratamento de Erros

ProblemaCausaCorreção
401 UnauthorizedChave de API inválida ou expiradaRegere a chave no portal AppFolio Stack Partner
403 ForbiddenEscopo de acesso a propriedade ausenteSolicite escopos adicionais ao administrador AppFolio
404 Not FoundURL base ou ID da empresa incorretosVerifique se APPFOLIO_BASE_URL corresponde ao seu subdomínio
429 Rate LimitedMuitas requisições por minutoImplemente backoff exponencial com janela de 60s
Container sai imediatamenteVariáveis de ambiente obrigatórias ausentesCertifique-se de que todas as variáveis de ambiente estão definidas antes de iniciar

Saída

  • Um contêiner não-root com um endpoint de liveness local e um resultado de prontidão do provedor separado e com dados sensíveis omitidos
  • Um limite de configuração entre gerenciador de segredos/runtime em vez de valores de credenciais em imagens ou comandos
  • Um recibo de implantação em estágios com evidência de prontidão, estado do tráfego, proprietário, alvo de rollback e status de reconciliação

Exemplos

Para um release de sincronização de propriedades, implante a nova imagem no staging com um fixture sintético de leitura segura e confirme que /health permanece ativo enquanto /ready reflete o resultado do cliente do provedor. Promova uma pequena fatia de tráfego de produção apenas após a identidade gerenciada, prontidão (com dados omitidos), alertas e alvo de rollback serem verificados. Se a prontidão falhar, um segredo estiver ausente ou uma gravação anterior tiver um resultado desconhecido, congele a promoção, retorne o tráfego para a revisão anterior e atribua reconciliação antes de tentar outro rollout.

Recursos

Próximos Passos

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

Habilidades Relacionadas