Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configure o ambiente de desenvolvimento local para integração com a API de gerenciamento de propriedades AppFolio.

O que é tons-of-skills-marketplace?

Esta skill configura um ambiente de desenvolvimento local completo para integrações com a API de gerenciamento de propriedades AppFolio, fornecendo um loop de feedback rápido com endpoints mockados de propriedades, inquilinos e contratos de aluguel. O principal benefício é permitir a construção e teste de integrações sem consumir cota da API real, alternando entre o modo mock para iteração rápida e o modo sandbox para validação pré-implantação contra a API AppFolio Stack real. A skill suporta plataformas como Claude Code e Cursor, e inclui instruções claras sobre como configurar o servidor local, usar mocks determinísticos, executar testes unitários e validar a conformidade com políticas de segurança de dados. O fluxo de trabalho enfatiza a separação estrita entre o ambiente local (mock-only) e o ambiente sandbox gerenciado, garantindo que nenhum dado de produção ou credenciais reais sejam expostos durante o desenvolvimento.

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-local-dev-loop

Perguntar na sua IA favorita

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

Documentação

Loop de Desenvolvimento Local AppFolio

Visão Geral

Fluxo de trabalho de desenvolvimento local para integração com a API de gerenciamento de propriedades AppFolio. Fornece um loop de feedback rápido com endpoints mockados de propriedades, inquilinos e contratos, permitindo construir e testar integrações sem consumir cota da API real. Alterne entre o modo mock para iteração rápida e o modo sandbox para validação pré-implantação contra a API AppFolio Stack real.

Pré-requisitos

  • Um ambiente local apenas com mocks contendo dados sintéticos de propriedades, inquilinos, contratos e ordens de serviço, sem endereços, nomes ou pagamentos reais.
  • Uma credencial sandbox gerenciada separadamente e um fixture de leitura segura aprovado para a faixa de integração dedicada; ela nunca é carregada pelo servidor de desenvolvimento local.
  • Uma política de logs que registra apenas a forma e o status da requisição, além de um proprietário explícito para a cota sandbox, reset de fixtures e rotação de credenciais.

Instruções

  1. Execute o servidor local apenas no modo mock e faça leituras/gravações nas rotas sintéticas com fixtures determinísticas.
  2. Teste a validação de requisição, idempotência, redação e tratamento de erros em testes unitários antes de qualquer verificação de conectividade com o sandbox.
  3. Execute a faixa sandbox separadamente com o cliente gerenciado vinculado a um contrato e um fixture de leitura segura autorizado; não transforme um proxy local em um túnel para a API real.
  4. Pare quando o fixture, as credenciais, o orçamento de requisições ou a redação de saída não estiverem verificados e corrija o ambiente antes de continuar.

Configuração do Ambiente

cp .env.example .env
# Deixe as credenciais do provedor em branco localmente. O modo mock é o padrão.
# MOCK_MODE=true
npm install express axios dotenv tsx typescript @types/node
npm install -D vitest supertest @types/express

Servidor de Desenvolvimento

// src/dev/server.ts
import express from "express";
const app = express();
app.use(express.json());
const MOCK = process.env.MOCK_MODE === "true";
if (!MOCK) throw new Error("O servidor local é apenas mock; use a faixa de integração sandbox gerenciada");
const { mountMockRoutes } = require("./mocks");
mountMockRoutes(app);
app.listen(3001, () => console.log(`Servidor de desenvolvimento AppFolio em :3001 [mock=${MOCK}]`));

Modo Mock

// src/dev/mocks.ts — respostas realistas de gerenciamento de propriedades
export function mountMockRoutes(app: any) {
  app.get("/api/v1/properties", (_req: any, res: any) => res.json([
    { id: "prop_1", name: "Sunset Apartments", address: { street: "123 Sunset Blvd", city: "Los Angeles", state: "CA" }, property_type: "residential", unit_count: 24 },
    { id: "prop_2", name: "Downtown Office", address: { street: "456 Main St", city: "San Francisco", state: "CA" }, property_type: "commercial", unit_count: 8 },
  ]));
  app.get("/api/v1/tenants", (_req: any, res: any) => res.json([
    { id: "t1", first_name: "Jane", last_name: "Smith", email: "[email protected]", unit_id: "u1", lease_id: "l1" },
  ]));
  app.get("/api/v1/leases", (_req: any, res: any) => res.json([
    { id: "l1", unit_id: "u1", start_date: "2025-01-01", end_date: "2026-01-01", rent_amount: 2500, status: "active" },
  ]));
  app.post("/api/v1/work-orders", (req: any, res: any) => res.status(201).json({ id: "wo_1", ...req.body, status: "open" }));
}

Fluxo de Trabalho de Testes

npm run dev:mock &                    # Inicia o servidor mock em segundo plano
npm run test                          # Testes unitários com vitest
npm run test -- --watch               # Modo de observação para iteração rápida
npm run test:sandbox                     # Faixa sandbox gerenciada e somente leitura

Dicas de Depuração

  • Defina DEBUG=express:* para rastrear a correspondência de rotas e execução de middlewares
  • Use asserções de teste locais para contagens de fixtures e formato de esquema, não para despejos brutos de payload de inquilinos
  • Verifique o cabeçalho X-RateLimit-Remaining ao testar contra a API real
  • O sandbox AppFolio retorna 403 para propriedades que você não possui — verifique o escopo da sua chave de API
  • Use interceptores apenas para telemetria redigida de endpoint/status/contagem durante o desenvolvimento

Saída

  • Um servidor local determinístico apenas mock com fixtures sintéticos de gerenciamento de propriedades e sem dependência de credenciais do provedor
  • Evidências de testes unitários para validação, idempotência e observabilidade segura para PII
  • Um resultado separado do sandbox gerenciado contendo apenas o status de leitura segura redigido

Exemplos

Para uma alteração na interface de ordens de serviço, adicione um fixture mock sintético e teste o esquema da requisição e o comportamento de submissão duplicada localmente. Afirme o ID e o status retornados sem emitir o corpo da requisição ou o registro do inquilino. Após os testes unitários passarem, execute a faixa sandbox dedicada contra um fixture de leitura segura aprovado. Se o modo mock estiver desabilitado, uma credencial sandbox aparecer localmente ou uma resposta contiver campos de inquilinos não redigidos, pare a execução e restaure os limites locais.

Tratamento de Erros

ProblemaCausaCorreção
401 UnauthorizedChave de API inválida ou expiradaRegenerar no portal AppFolio Stack
403 ForbiddenChave sem escopo para o endpointSolicitar permissões adicionais
404 Not FoundID de propriedade ou caminho erradoVerificar se o recurso existe no sandbox
429 Too Many RequestsLimite de taxa excedidoAdicionar backoff exponencial, usar modo mock
ECONNREFUSED :3001Servidor de desenvolvimento não está em execuçãoExecutar npm run dev:mock primeiro

Recursos

Próximos Passos

Consulte appfolio-debug-bundle.

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

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