goul4rt/lgpd-skills / skills/lgpd-consent-schema
lgpd-consent-schema
VerifiedDesign an event-sourced, database-enforced append-only consent ledger satisfying LGPD Art. 8 (free, informed, unambiguous consent, burden of proof, easy revocation, policy version supersession), Art. 14, and Art. 18, IX. Use when user asks for "consent schema", "consent ledger", "schema de consentimento", "Prisma consentimento", or integrates consent capture/revocation with Better Auth, NextAuth, or Clerk. Outputs Prisma schema, PostgreSQL append-only triggers, and TypeScript helpers.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| assets/consent-append-only.sql | other | 1.1 KB |
| assets/consent-ledger.ts | script | 9.7 KB |
| assets/consent-schema.prisma | other | 6.6 KB |
assets/consent-schema.prisma
View on GitHub// Consent Event Ledger — append-only orientado a eventos, versionado e auditável.
// LGPD Art. 7º, I; Art. 8º (§§ 2º, 4º, 5º e 6º); Art. 9º; Art. 14; Art. 18, IX.
// ECA Digital (Lei nº 15.211/2025, Arts. 13 e 24; Decreto nº 12.880/2026, Arts. 25–26) para
// aferição de idade e vinculação de responsável até 16 anos.
enum ConsentEventType {
GRANTED // Consentimento concedido para finalidade e versão específicas
REVOKED // Consentimento revogado pelo titular ou responsável (Art. 8º, § 5º)
SUPERSEDED // Substituído por mudança material de finalidade/política (Art. 8º, § 6º)
EXPIRED // Expirado automaticamente quando houver prazo de validade (TTL)
}
// Faixa etária do titular (LGPD Art. 14 + ECA Art. 2º). Campo nulo = idade não aferida.
enum SubjectAgeBand {
CHILD // < 12 anos — consentimento parental específico quando a base for consentimento (Art. 14, § 1º)
ADOLESCENT // 12 a < 18 anos — consente por si (Enunciado CD/ANPD nº 1/2023), melhor interesse prevalece
ADULT
}
enum AgeAssuranceSource {
OS_SIGNAL // sinal de idade do sistema operacional (Lei Art. 12, III; Dec. Art. 25)
APP_STORE_SIGNAL // sinal de idade da loja de aplicações
VERIFIABLE_CREDENTIAL // credencial verificável / provedor certificado (Lei Art. 11; Dec. Arts. 25, § 2º, II e 30)
OWN_MECHANISM // mecanismo próprio do fornecedor (Lei Art. 14, parágrafo único)
}
enum ConsentChannel {
WEB
MOBILE_RN
API
SIGNUP
SETTINGS_PAGE
EMAIL_OPTIN
COOKIE_BANNER
}
model PolicyVersion {
id String @id @default(cuid())
version String @unique // ex.: "v3.2"
effectiveAt DateTime
requiresReconsent Boolean @default(false) // Art. 8º, § 6º — mudança material exige nova coleta
text String @db.Text
textHash String // SHA-256 do texto canônico publicado
language String @default("pt-BR")
changelog String? @db.Text
events ConsentEvent[]
@@index([effectiveAt])
}
model ConsentEvent {
id String @id @default(cuid())
seq BigInt @unique @default(autoincrement()) // desempate monotônico determinístico
// Titular e finalidade específica (Art. 8º, § 4º)
subjectId String // FK lógica para User
purpose String // ex.: "marketing_email", "analytics_cookies", "biometric_optin"
// Semântica de evento imutável (nunca sobrescrever registro anterior)
eventType ConsentEventType
occurredAt DateTime @default(now())
expiresAt DateTime? // aplicável apenas em eventos GRANTED com TTL
// Linhagem: eventos REVOKED / SUPERSEDED / EXPIRED apontam para o GRANTED original
rootConsentId String?
rootConsent ConsentEvent? @relation("ConsentLineage", fields: [rootConsentId], references: [id], onDelete: Restrict, onUpdate: Restrict)
derivedEvents ConsentEvent[] @relation("ConsentLineage")
// Versão exata da política associada ao evento
policyVersionId String
policyVersion PolicyVersion @relation(fields: [policyVersionId], references: [id], onDelete: Restrict, onUpdate: Restrict)
// Evidência probatória (Art. 8º, § 2º — ônus da prova cabe ao controlador)
evidenceHash String // SHA-256 canônico da evidência do evento
ipAddress String? @db.Inet
userAgent String?
locale String @default("pt-BR")
channel ConsentChannel
uiSnapshot String? @db.Text // hash ou snapshot do componente/texto exibido
// Crianças e adolescentes (Art. 14 LGPD + Enunciado 1/2023 + ECA Digital)
subjectAgeBand SubjectAgeBand?
parentalConsent Boolean? // true quando consentimento parental específico foi colhido (Art. 14, § 1º — só crianças)
guardianId String?
guardian Guardian? @relation(fields: [guardianId], references: [id], onDelete: Restrict, onUpdate: Restrict)
// Rastreabilidade de propagação a operadores (Art. 18, § 6º)
propagatedTo Json? // ex.: ["mixpanel", "customer_io"]
@@index([subjectId, purpose, occurredAt(sort: Desc), seq(sort: Desc)])
@@index([rootConsentId])
@@index([policyVersionId])
}
// Vinculação a responsável legal (Art. 14, § 1º LGPD / Art. 24 Lei 15.211/2025 até 16 anos)
model Guardian {
id String @id @default(cuid())
fullName String
// CPF só se a verificação escolhida realmente exigir (Art. 6º, III LGPD — necessidade). O Art. 24
// do ECA Digital exige vincular à conta/usuário do responsável, não coletar CPF.
cpfCiphertext String? // cifrado em nível de aplicação (AES-256-GCM + KMS)
cpfBlindIndex String? // HMAC-SHA256 com chave segregada para busca exata
guardianUserId String? // conta do responsável na própria plataforma (Art. 24, caput)
email String
phone String?
relationship String // "mother", "father", "legal_guardian"
verifiedAt DateTime?
// Método que comprova a RELAÇÃO de responsabilidade (e a maioridade do responsável). Sinal de
// idade do SO/loja comprova só a idade — não a relação — e sozinho não basta aqui.
verificationMethod String? // ex.: "gov_br", "id_doc_liveness", "os_parental_link"
minors MinorLink[]
consentEvents ConsentEvent[]
createdAt DateTime @default(now())
@@index([cpfBlindIndex])
}
model MinorLink {
id String @id @default(cuid())
minorUserId String
guardianId String
guardian Guardian @relation(fields: [guardianId], references: [id], onDelete: Restrict, onUpdate: Restrict)
active Boolean @default(true)
createdAt DateTime @default(now())
endedAt DateTime?
@@unique([minorUserId, guardianId])
}
// Evidência de aferição de idade — guarda o RESULTADO, nunca o documento/biometria bruta.
// Lei 15.211/2025, Art. 13 (dados de aferição só para essa finalidade) e Art. 14, parágrafo único
// (mecanismo próprio, além dos sinais); Decreto 12.880/2026, Art. 25, § 1º (sinal sem data de
// nascimento exata) e § 4º (divergência entre sinal e aferição própria → alternativa mais protetiva).
model AgeAssurance {
id String @id @default(cuid())
userId String
ageBand SubjectAgeBand
source AgeAssuranceSource
method String? // ex.: "store_age_range_api", "facial_age_estimation", "gov_br"
assessedAt DateTime @default(now())
@@index([userId, assessedAt(sort: Desc)])
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |