Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio 集成的生产就绪检查清单。

tons-of-skills-marketplace 是什么?

该技能提供了一个全面的生产就绪检查清单,用于 AppFolio API 集成,确保系统具有弹性、合规性和可观测性。它覆盖了认证与密钥管理、API 集成、错误处理与韧性、监控与告警等关键领域,并包含一个验证脚本,用于自动化检查。该清单特别关注处理敏感租户 PII、金融交易和维护工作流,以防止错过租金收取、未处理的工作订单或违反 CCPA 等风险。它支持逐步推进的发布策略,要求进行沙箱演练,并生成经过修订的 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 中提问

打开一个已预加载此 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 中断配置断路器
  • 对 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

输出

  • 一份经过修订的 go/no-go 报告,包含已验证的客户端、安全读取检查、监控状态、负责人批准以及回滚/对账计划
  • 一份失败或未经验证的控制项列表,用于阻止发布,直到问题修复
  • 一个有边界的发布决策,在安全读取路径的生产形态演练获得证据之前,保持敏感或写入能力路径的关闭状态

示例

对于工作订单集成发布,首先针对合成预发布测试夹具运行清单,然后使用受管的生产形态客户端执行一次授权的安全读取。在所有写入路径保持禁用状态的同时,确认告警路由、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".

相关技能