用途:为 Documenso 集成提供文档数据流处理规范,覆盖文档生命周期、签名 PDF 下载、PII 保护、数据保留与 GDPR 合规。
主要能力:定义文档状态流转(DRAFT→PENDING→COMPLETED,以及 REJECTED/CANCELLED)及其数据处理含义;通过 SDK 校验文档为 COMPLETED 后,用 v1 REST API 下载已签名 PDF;对收件人邮箱、姓名等 PII 做日志脱敏;按保留策略删除废弃草稿、归档已完成文档;处理 GDPR 访问与删除请求;将 PDF 加密归档至 S3。
使用方式:需先完成 documenso-install-auth 设置,并具备安全存储(S3、GCS 或本地加密存储)。示例使用 @documenso/sdk-typescript 客户端,下载接口为 https://app.documenso.com/api/v1/documents/{id}/download,归档使用 AWS S3 服务端加密(aws:kms)。
适用场景:管理文档生命周期、处理已签名 PDF、实施数据保留、响应数据主体请求、构建合规审计流程。
限制:Documenso 云默认将文档存于 PostgreSQL,自托管可完全控制;已完成签名文档可能因法律合规需保留,删除请求需区分可删除与需保留项;分页需完整遍历,否则 GDPR 请求不完整;具体保留年限依法规而定。