用途
该技能面向使用 Prisma 与 Better Auth 的巴西业务应用,帮助开发者把用户同意作为数据处理合法依据(Art. 7º, I 与 Art. 11, I)进行技术落地:同意需可版本化、可审计、可撤销。
主要能力
- 设计追加式同意台账:不做破坏性更新,撤销即插入一条 status=REVOKED 的新记录。
- 按政策版本记录同意:每条同意指向具体被同意的政策文本版本。
- 按目的细分:每个(数据主体、目的、政策版本)组合一条记录。
- 保留强证据:记录 payload 哈希(时间戳、IP、user-agent、UI 快照等)。
- 提供撤销流程:对应 Art. 8º §5º 要求同意可随时通过免费、便捷的明示程序撤销。
- 提供校验 helper:在基于同意处理数据前调用 hasActiveConsent 判断某目的是否仍被同意。
- 政策版本管理:隐私政策文本发生实质变更时生成新的 PolicyVersion;旧同意不自动迁移,若变更影响既有目的需重新收集(Art. 8º §6º)。
- 审计日志:grant、revoke、propagate 每项操作都应写入 AuditLogEntry(相关技能 lgpd-audit-logging)。
使用方式
- 参考 assets/consent-schema.prisma 中的 Prisma 参考结构,在 prisma/schema.prisma 中实现模型。
- 在 Better Auth 中通过 additionalFields 添加自定义字段(如 dateOfBirth、parentalConsentRef),并用 hooks.user.create.before 做年龄校验;资料明确建议不要在注册流程中创建同意记录,而应通过专门的 /api/consent/grant 完成。
- 在前端收集同意时:不要预勾选复选框(Art. 8º §4º);按目的粒度分别提供复选框,而非“全部同意”;使用清晰通俗的语言;链接到被同意政策的确切版本;未满 18 岁走 ECA Digital 流程(参见 lgpd-eca-digital-minors)。
- 通过 POST /api/consent/grant 提交 userId、policyVersionId、按目的给出的 granted 布尔值以及 evidence(IP、userAgent、locale、channel、uiSnapshotHash)。
- 通过 POST /api/consent/revoke 撤销:创建 status=REVOKED 记录并写入 revokedAt(沿用同一 policyVersionId),向运营方(如 Datadog、Mixpanel 等)传播撤销,并阻止该目的后续处理。
- 提供 GET /api/consent 查询接口。
适用场景
- 需要以用户同意作为合法性基础的巴西市场 Web 应用。
- 涉及营销邮件、个性化、分析等可分目的授权的能力。
- 需要完整留存同意证据与撤销记录以应对审计的场景。
限制与暂未提供
资料未说明该技能的安装命令、许可证、运行环境要求、性能指标,也未给出具体收费或价格信息。示例中的运营方列表、端点实现与 Better Auth 配置仅为参考代码,字段和流程需按实际项目调整。