SuperAPI AI 工具集

documenso-prod-checklist

部署与运维

查看项目

更新于 10-15 23:25

技能介绍

用途:在将 Documenso 集成部署到生产前,按清单逐项验证安全、可靠性、监控与合规准备情况;任一文档、身份、安全或责任人门禁未验证时,应停止生产启用。

主要能力:覆盖七类检查项。认证与密钥(生产 API key、密钥管理、webhook secret、轮换与吊销、自托管密钥与签名证书);错误处理(try/catch、429/5xx 指数退避、熔断、用户友好错误、错误追踪);性能(单例客户端、模板复用、并发控制、后台处理、元数据缓存);监控告警(健康检查端点 GET /health/documenso、错误率与延迟告警、webhook 成功率、脱敏日志);Webhooks(仅 HTTPS、常量时间比较验签、幂等、异步处理、死信队列);数据与合规(PII 脱敏、留存策略、GDPR 请求流程、签名 PDF 归档、自托管存储策略);自托管生产(PostgreSQL 备份、反向代理 HTTPS、可信 CA 证书、SMTP、非 root 运行、资源限制、自动重启)。

使用方式:前置条件为已测试的 staging 环境、生产 API key、部署流水线、监控就绪。提供部署前验证脚本,检查 DOCUMENSO_API_KEY、调用 $BASE/documents?page=1&perPage=1 验证连接、测试 webhook 端点、读取健康检查状态。回滚时先执行 kubectl rollout undo deployment/signing-service 或 vercel rollback,再以 curl 验证 /health/documenso,随后排查差异、日志并在 staging 复现,修复后重新部署。上线日需完成 staging 冒烟测试、通知窗口、打开监控面板、准备回滚、联系支持(Discord 或邮件),并端到端创建首个生产文档。异常按表格响应:部署失败查日志重试、健康检查失败核对 API key 与状态页、错误激增执行回滚、webhook 中断检查 HTTPS URL 与 secret。

限制:官方 URL、价格与平台支持情况暂未提供;版本升级参见 documenso-upgrade-migration。