Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio 整合的上線檢查清單。

tons-of-skills-marketplace 是什麼?

此技能提供一份完整的生產環境就緒檢查清單,專為 AppFolio API 整合而設計。它能協助開發者與技術營運團隊確保整合具備韌性、合規性與可觀察性,涵蓋金鑰管理、API 端點驗證、錯誤處理、監控與警示等關鍵領域。該技能支援 TypeScript 驗證腳本,可自動執行各項檢查,並提供結構化的 No-Go/Go 決策流程,降低敏感客戶資料(PII)外洩、付款失敗或工單重複等風險。主要適用於 AppFolio 物業管理平台的技術整合與上線流程。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AppFolio 生產環境檢查清單

概述

AppFolio 為房地產營運管理房產、租戶、租約與工作訂單。生產環境整合會處理敏感的租戶個人識別資訊 (PII)、金融交易與維護工作流程。一旦出錯,可能導致租金無法收取、工單未處理,或在 CCPA 規範下發生租戶資料外洩。本檢查清單可確保您的 AppFolio API 整合具備韌性、合規性且可觀察。

先決條件

  • 一份經過驗證的生產合作夥伴合約,包含基礎 URL、驗證機制、允許的端點範圍,以及指定負責業務、安全性、營運和復原決策的負責人。
  • 已完成沙盒演練,使用合成資料、獨立管理的憑證、請求預算,並記錄復原/調節計畫。
  • 提供可觀察性、PII 最小化、冪等寫入及警示路由的證據——而非僅宣稱已實施這些控制項的檢查項目。

操作說明

  1. 透過密碼管理員驗證實際由提供者簽發的用戶端設定;不要在發行版程式碼中預設端點或驗證方案。
  2. 在先導環境中執行就緒檢查,然後進行受控的生產環境模擬演練,該演練僅執行授權的安全讀取。
  3. 將任何失敗、跳過或無法驗證的控制項視為不可行;保留經過編輯的憑證、端點、監控與復原收據。
  4. 僅在具備經過測試的復原與調節負責人時,才逐步進行發行;若付款、工單、租戶或租約狀態不明,則暫停寫入路徑。

驗證與機密資料

  • APPFOLIO_API_KEY 儲存在密碼管理員中(非環境檔案)
  • 用戶端 ID 與密鑰與應用程式程式碼分離
  • 記錄金鑰輪替排程(建議 90 天)
  • 分別準備開發/先導/生產環境的憑證
  • API 憑證範圍設定為所需的最小權限

API 整合

  • 根據目前的合作夥伴合約驗證生產基礎 URL 與驗證方法
  • 具備指數退避的速率限制處理
  • 為物業與租戶清單端點實作分頁
  • 使用所有必要欄位測試工單建立
  • 驗證租約文件上傳支援的格式
  • 為租戶與付款事件設定 Webhook 端點
  • 在付款與工單建立時使用冪等金鑰

錯誤處理與韌性

  • 為 AppFolio API 中斷設定斷路器 (Circuit Breaker)
  • 針對 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 ? '通過' : '失敗'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();

錯誤處理

檢查項目跳過風險優先級
API 金鑰輪替金鑰過期導致物業同步停擺P1
付款同步失敗錯過租金收取P1
租戶 PII 外洩CCPA 違規,法律責任P1
工單重複重複派遣維護P2
速率限制處理大量物業匯入時發生 429 錯誤P3

產出

  • 一份經過編輯的可行/不可行收據,綁定已驗證的用戶端、安全讀取檢查、監控狀態、負責人核准以及復原/調節計畫。
  • 一份失敗或未經證明的控制項清單,此清單將阻擋發行直至問題修正。
  • 一份有限的發行決策,在敏感或具寫入能力的路徑獲得生產環境模擬演練證據之前,使其維持關閉狀態。

範例

對於工單整合發行,首先針對合成先導環境測試資料執行此檢查清單,然後使用受管的生產環境模擬用戶端進行單一授權的安全讀取。在所有寫入操作仍處於停用狀態時,確認警示路由、PII 編輯以及冪等性/調節控制項。若無法驗證憑證、端點合約、就緒檢查或復原演練,則宣告不可行,保留先前的版本,並由指定的負責人在進行新的演練前修正問題。

資源

後續步驟

請參閱 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".

相關技能