Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio 통합을 위한 프로덕션 준비 상태 체크리스트입니다.

tons-of-skills-marketplace란 무엇인가요?

이 스킬은 AppFolio API 통합이 프로덕션 환경에서 안정적이고 규정을 준수하며 관찰 가능하도록 보장하는 포괄적인 체크리스트를 제공합니다. AppFolio는 부동산 운영을 위한 자산, 세입자, 임대 계약 및 작업 지시를 관리하므로, 통합 실패는 임대료 미수금, 미처리 작업 지시 또는 CCPA 위반으로 인한 세입자 데이터 노출로 이어질 수 있습니다. 이 체크리스트는 인증 및 비밀 관리, API 통합 모범 사례, 오류 처리 및 복원력, 모니터링 및 알림 설정에 대한 검증 항목을 다룹니다. 또한 검증 스크립트와 위험 기반 우선순위 테이블을 포함하여 개발자와 AI 에이전트가 프로덕션 출시 전에 필요한 제어를 체계적으로 검증하고, 자격 증명 누락이나 장애 조치 계획 부재와 같은 주요 위험을 식별할 수 있도록 합니다.

지원 대상✓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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

AppFolio 프로덕션 체크리스트

개요

AppFolio는 부동산 운영을 위해 자산, 세입자, 임대 계약 및 작업 지시를 관리합니다. 프로덕션 통합은 민감한 세입자 개인 식별 정보(PII), 금융 거래 및 유지보수 워크플로우를 처리합니다. 실패 시 임대료 미수금, 미처리 작업 지시 또는 CCPA 위반에 따른 세입자 데이터 노출이 발생할 수 있습니다. 이 체크리스트는 AppFolio API 통합이 복원력 있고 규정을 준수하며 관찰 가능하도록 보장합니다.

전제 조건

  • 확인된 프로덕션 파트너 계약, 기본 URL, 인증 메커니즘, 허용된 엔드포인트 범위, 그리고 비즈니스, 보안, 운영 및 롤백 결정에 대한 명명된 소유자.
  • 합성 데이터, 별도 관리 자격 증명, 요청 예산 및 기록된 롤백/조정 계획을 사용한 샌드박스 리허설 완료.
  • 관찰 가능성, PII 최소화, 멱등성 쓰기 및 알림 라우팅에 대한 증거—단순히 해당 제어가 존재한다고 단언하는 체크리스트 항목이 아닙니다.

지침

  1. 비밀 관리자를 통해 실제 공급자 발급 클라이언트 구성을 검증합니다. 릴리스 코드에서 엔드포인트나 인증 체계를 기본값으로 설정하지 마십시오.
  2. 스테이징에서 준비 상태 점검을 실행한 다음, 승인된 안전 읽기만 수행하는 제어된 프로덕션 형태의 리허설을 실행합니다.
  3. 실패, 건너뛰기 또는 확인할 수 없는 모든 제어 검토를 no-go로 간주합니다. 자격 증명, 엔드포인트, 모니터링 및 복구에 대한 수정된 영수증을 보존합니다.
  4. 테스트된 롤백 및 조정 책임자와 함께 점진적으로 릴리스합니다. 결제, 작업 지시, 임대 또는 자산 상태가 알 수 없는 경우 쓰기 경로를 일시 중단합니다.

인증 및 비밀

  • APPFOLIO_API_KEY가 환경 파일이 아닌 비밀 관리자에 저장됨
  • 클라이언트 ID와 시크릿이 애플리케이션 코드와 분리됨
  • 키 교체 일정이 문서화됨(90일 권장)
  • 개발/스테이징/프로덕션 환경에 대해 별도의 자격 증명 사용
  • API 자격 증명이 최소 필요 권한으로 범위 지정됨

API 통합

  • 프로덕션 기본 URL과 인증 방법이 현재 파트너 계약과 일치하는지 확인됨
  • 지수 백오프를 사용한 속도 제한 처리
  • 자산 및 세입자 목록 엔드포인트에 대한 페이지네이션 구현
  • 모든 필수 필드를 포함한 작업 지시 생성 테스트 완료
  • 지원되는 형식의 임대 문서 업로드 검증 완료
  • 세입자 및 결제 이벤트에 대한 웹훅 엔드포인트 구성
  • 결제 및 작업 지시 생성을 위한 멱등성 키 사용

오류 처리 및 복원력

  • AppFolio API 중단에 대한 회로 차단기 구성
  • 429/5xx 응답에 대한 재시도 및 백오프
  • 세입자 PII 처리가 CCPA/FCRA를 준수하는지 확인됨
  • 저장 전 모든 API 응답에 대한 데이터 검증
  • 자산 동기화 불가 시 정상적인 성능 저하
  • 재시도 시 재생성을 방지하는 중복 작업 지시 감지

모니터링 및 알림

  • 엔드포인트별 API 지연 시간 추적(자산, 세입자, 작업 지시)
  • 오류율 알림 설정(임계값: 5분 동안 3% 초과)
  • 실패한 결제 동기화가 즉시 P1 알림 트리거
  • 작업 지시 생성 실패가 5분 이내에 보고됨
  • 동기화된 자산 수와 소스 간 일일 조정

검증 스크립트

async function checkAppFolioReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  const client = createVerifiedAppFolioClient(); // contract-bound client from appfolio-security-basics
  // API connectivity
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'API Connectivity', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'API Connectivity', pass: false, detail: e.message }); }
  // Client construction proves the managed credential and provider contract are available.
  checks.push({ name: 'Verified client configuration', pass: true, detail: 'Loaded from managed configuration' });
  // Work order endpoint
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: 'Work Orders', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Work Orders', pass: false, detail: e.message }); }
  for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

오류 처리

점검 항목건너뛸 경우 위험우선순위
API 키 교체만료된 키로 자산 동기화 중단P1
결제 동기화 실패임대료 미수금P1
세입자 PII 노출CCPA 위반, 법적 책임P1
작업 지시 중복중복 유지보수 파견P2
속도 제한 처리대량 자산 가져오기 중 429 오류P3

출력

  • 확인된 클라이언트, 안전 읽기 점검, 모니터링 상태, 소유자 승인 및 롤백/조정 계획을 바인딩하는 수정된 진행/중단 영수증
  • 릴리스를 차단하는 실패하거나 입증되지 않은 제어 목록
  • 민감하거나 쓰기 가능한 경로가 프로덕션 형태의 리허설에 대한 증거를 확보할 때까지 해당 경로를 차단하는 제한된 릴리스 결정

예시

작업 지시 통합 릴리스의 경우, 먼저 합성 스테이징 픽스처에 대해 체크리스트를 실행한 다음, 관리되는 프로덕션 형태의 클라이언트를 사용하여 단일 승인된 안전 읽기를 수행합니다. 모든 쓰기가 비활성화된 상태에서 알림 경로, PII 편집 및 멱등성/조정 제어를 확인합니다. 자격 증명, 엔드포인트 계약, 준비 상태 점검 또는 롤백 실행을 확인할 수 없는 경우 no-go를 선언하고, 이전 개정을 유지하며, 할당된 소유자가 새로운 리허설 전에 문제를 해결하도록 합니다.

리소스

다음 단계

세입자 데이터 보호 및 액세스 제어에 대한 내용은 appfolio-security-basics를 참조하십시오.

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

관련 스킬