Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio統合のためのプロダクション対応チェックリスト。

tons-of-skills-marketplace とは?

このスキルは、AppFolio APIとのプロダクション統合におけるレジリエンス、コンプライアンス、および監視可能性を確保するための包括的なチェックリストを提供します。主な機能として、認証情報管理(APIキーのローテーション、分離されたクレデンシャル)、API統合(レート制限処理、ページネーション、冪等性)、エラーハンドリング(サーキットブレーカー、リトライ戦略)、および監視(レイテンシ追跡、アラートしきい値)に関するチェック項目が含まれています。TypeScript検証スクリプトが用意されており、実際のAPI接続とクライアント構成をテストできます。CCPA/FCRAに準拠したテナントPIIの取り扱いや、支払い処理、作業指示書の重複防止など、リスク優先度に基づいた重要チェックが定義されています。また、段階的なリリース判断のためのGo/No-Goレシート出力と、リリースをブロックする未検証項目のリストを生成します。

対応✓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と認証方式が現在のパートナー契約と照合されている
  • 指数バックオフによるレート制限処理
  • 物件およびテナント一覧エンドポイントのページネーションが実装されている
  • 作業指示書作成が必要なすべてのフィールドでテストされている
  • リース文書アップロードがサポートされている形式で検証されている
  • Webhookエンドポイントがテナントおよび支払いイベント用に設定されている
  • 支払いおよび作業指示書作成に冪等性キーが使用されている

エラーハンドリングと耐障害性

  • 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(); // appfolio-security-basics からの契約準拠クライアント
  // API接続性
  try {
    const res = await client.get('/properties?limit=1');
    checks.push({ name: 'API接続性', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'API接続性', pass: false, detail: e.message }); }
  // クライアント構築により、管理されたクレデンシャルとプロバイダ契約が利用可能であることを証明
  checks.push({ name: '検証済みクライアント構成', pass: true, detail: '管理構成からロード' });
  // 作業指示書エンドポイント
  try {
    const res = await client.get('/work_orders?limit=1');
    checks.push({ name: '作業指示書', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: '作業指示書', 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

出力

  • 検証済みクライアント、安全な読み取りチェック、監視状態、承認者、およびロールバック/調整計画をまとめた編集済みのGo/No-Goレシート
  • リリースをブロックする失敗または未検証のコントロールのリスト
  • 機密または書き込み可能なパスを、プロダクションと同様のリハーサルで証拠が得られるまでオフにしておく、制限付きリリース判断

例

作業指示書統合リリースの場合、最初に合成ステージングフィクスチャに対してチェックリストを実行し、次に管理されたプロダクションと同様のクライアントを使用して単一の許可された安全な読み取りを実行します。すべての書き込みを無効にした状態で、アラートルート、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".

関連スキル