Skip to content

ThomasMoreAI/legal-skills-open / br/data-protection/skills/lgpd-compliance-falkzera

lgpd-compliance-falkzera

Unverified

Compliance jurídico-regulatório (LGPD, ANPD, CDC, Marco Civil) para qualquer app ou sistema construído para brasileiros. Ative SEMPRE que o projeto coletar qualquer dado pessoal (nome, e-mail, telefone, CPF, geolocalização, dado do dispositivo, cookie de tracking, foto, áudio, log que identifique pessoa), OU quando o pedido envolver "LGPD", "política de privacidade", "termos de uso", "compliance", "DPO", "encarregado", "ROPA", "consentimento de cookies", "banner de cookies", "vazamento de dados", "incidente de segurança", "direito do titular", "exportar dados do usuário", "excluir conta". Esta skill AUDITA o projeto, classifica os tratamentos, e GERA os artefatos: política de privacidade, política de cookies, banner de consentimento, ROPA preenchido, RIPD quando exigível, runbook de incidente, endpoints de exercício de direitos do titular, schema de consent_log, termos de uso e portal de transparência.

FileKindSize
LICENSEother1.0 KB
SKILL.mdskill md38.1 KB
checklists/auditoria-app.mdmarkdown7.3 KB
checklists/checklist-termos.mdmarkdown8.0 KB
checklists/checklist-transparencia.mdmarkdown7.9 KB
checklists/politica-14-itens.mdmarkdown4.4 KB
checklists/seguranca-minima.mdmarkdown7.8 KB
references/01-lei-fundamentos.mdmarkdown9.5 KB
references/02-bases-legais.mdmarkdown11.9 KB
references/03-direitos-titular.mdmarkdown10.2 KB
references/04-matriz-retencao.mdmarkdown8.4 KB
references/05-incidente-runbook.mdmarkdown9.7 KB
references/06-cookies-guia-anpd.mdmarkdown7.6 KB
references/07-pequeno-porte.mdmarkdown7.4 KB
references/08-termos-cdc.mdmarkdown14.2 KB
references/09-termos-mci-stf.mdmarkdown13.0 KB
references/10-clickwrap-aceite.mdmarkdown11.0 KB
references/11-taxonomia-dados.mdmarkdown19.0 KB
references/12-transparencia-radical.mdmarkdown15.8 KB
references/13-ia-ml-transparencia.mdmarkdown13.3 KB
references/14-analytics-tracking.mdmarkdown16.2 KB
templates/banner-cookies.tsxother10.9 KB
templates/dpa-clausulas-pt.mdmarkdown8.8 KB
templates/endpoints-direitos/consent-log-schema.sqlother15.6 KB
templates/endpoints-direitos/fastapi-direitos.pyscript10.8 KB
templates/endpoints-direitos/next-delete.tsscript6.3 KB
templates/endpoints-direitos/next-export.tsscript4.5 KB
templates/notice-takedown-form.mdmarkdown8.3 KB
templates/politica-cookies.mdmarkdown5.1 KB
templates/politica-privacidade.mdmarkdown12.6 KB
templates/ripd.mdmarkdown8.1 KB
templates/ropa.csvother3.0 KB
templates/termos-de-uso.mdmarkdown17.5 KB
templates/transparencia/ai-disclosure.tsxother5.7 KB
templates/transparencia/automation/ci-check.ymlconfig4.3 KB
templates/transparencia/automation/gerar-inventario.pyscript10.3 KB
templates/transparencia/automation/pii-convention.mdmarkdown6.4 KB
templates/transparencia/automation/pii-decorator.pyscript5.0 KB
templates/transparencia/data-card.yamlconfig3.3 KB
templates/transparencia/finalidades.yamlconfig3.3 KB
templates/transparencia/inventario.yamlconfig6.5 KB
templates/transparencia/model-card.mdmarkdown4.1 KB
templates/transparencia/nutrition-label.tsxother7.2 KB
templates/transparencia/portal-page.tsxother7.4 KB
templates/transparencia/terceiros.yamlconfig5.7 KB
templates/transparencia/transparency-report.mdmarkdown7.0 KB

templates/transparencia/automation/pii-decorator.py

View on GitHub
"""
lgpd_compliance/pii.py, decorator e helpers de anotação PII
==========================================================
Skill: lgpd-compliance (Parte 3)

Cole em: app/lgpd_compliance/pii.py (ou similar) e importe nos modelos.

Uso:
    from lgpd_compliance.pii import pii, contains_pii, PII

    @contains_pii
    class User(Base):
        @pii(finalidade=["autenticacao"], base_legal="art_7_V_contrato",
             retencao="conta+5y", sensibilidade="baixa")
        email: Mapped[str] = mapped_column(String(255))

    # Ou em Pydantic
    class UserSchema(BaseModel):
        email: Annotated[str, PII(finalidade=["autenticacao"], ...)]

O script gerar-inventario.py consome essas anotações via reflection.
"""

from __future__ import annotations

from dataclasses import dataclass, field
from typing import Any, Callable, Literal


# === Constantes ============================================================

BASES_LEGAIS_VALIDAS = {
    # Art. 7º, dados comuns
    "art_7_I_consentimento",
    "art_7_II_obrigacao_legal",
    "art_7_III_politicas_publicas",
    "art_7_IV_pesquisa",
    "art_7_V_contrato",
    "art_7_VI_processo",
    "art_7_VII_protecao_vida",
    "art_7_VIII_tutela_saude",
    "art_7_IX_legitimo_interesse",
    "art_7_X_credito",
    # Art. 11, dados sensíveis
    "art_11_I_consentimento_sensivel",
    "art_11_II_a_obrigacao_legal_sensivel",
    "art_11_II_b_politicas_publicas_sensivel",
    "art_11_II_c_pesquisa_sensivel",
    "art_11_II_d_processo_sensivel",
    "art_11_II_e_protecao_vida_sensivel",
    "art_11_II_f_tutela_saude_sensivel",
    "art_11_II_g_prevencao_fraude_sensivel",
}

SENSIBILIDADES_VALIDAS = {
    "baixa",
    "media",
    "alta",
    "critica",
    "variavel",
    "alta_inferencia",
}

Sensibilidade = Literal[
    "baixa", "media", "alta", "critica", "variavel", "alta_inferencia"
]


# === Estrutura canônica ====================================================

@dataclass
class PII:
    """Metadado LGPD anexado a um campo ou classe."""

    finalidade: list[str]
    base_legal: str
    retencao: str
    sensibilidade: Sensibilidade
    compartilha_com: list[str] = field(default_factory=list)
    visivel_para: list[str] = field(default_factory=list)
    criptografia_repouso: str | None = None
    obrigatorio: bool = True
    observacao: str | None = None

    def __post_init__(self) -> None:
        if self.base_legal not in BASES_LEGAIS_VALIDAS:
            raise ValueError(
                f"base_legal inválida: {self.base_legal!r}. "
                f"Válidas: {sorted(BASES_LEGAIS_VALIDAS)}"
            )
        if self.sensibilidade not in SENSIBILIDADES_VALIDAS:
            raise ValueError(
                f"sensibilidade inválida: {self.sensibilidade!r}. "
                f"Válidas: {sorted(SENSIBILIDADES_VALIDAS)}"
            )
        if not self.finalidade:
            raise ValueError("finalidade não pode ser lista vazia")


# === Decorators =============================================================

def pii(**kwargs: Any) -> Callable[[Any], Any]:
    """
    Decorator que anexa metadado PII a um campo (atributo de classe SQLAlchemy,
    coluna Drizzle/Prisma transpilada, etc.).

    O metadado vira atributo `_pii` no objeto decorado, consumido por
    gerar-inventario.py via reflection.

    Não tem efeito em runtime além de marcar, é puro metadado.
    """
    meta = PII(**kwargs)

    def _decorator(obj: Any) -> Any:
        setattr(obj, "_pii", meta)
        return obj

    return _decorator


def contains_pii(cls: type) -> type:
    """
    Marca uma classe/tabela como contendo PII. O CI verifica que todos os
    atributos públicos têm @pii ou @no_pii.
    """
    setattr(cls, "_contains_pii", True)
    return cls


def no_pii(obj: Any) -> Any:
    """Marca explicitamente um campo como NÃO sendo PII (FK opaca, timestamp etc.)."""
    setattr(obj, "_no_pii", True)
    return obj


# === Helpers pra extração (usados por gerar-inventario.py) ================

def extrair_pii_de_classe(cls: type) -> dict[str, PII]:
    """
    Inspeciona uma classe e retorna {nome_do_campo: PII} pra cada atributo
    anotado com @pii.
    """
    resultado: dict[str, PII] = {}
    for nome in dir(cls):
        if nome.startswith("_"):
            continue
        attr = getattr(cls, nome, None)
        meta = getattr(attr, "_pii", None)
        if isinstance(meta, PII):
            resultado[nome] = meta
    return resultado


def validar_classe_contains_pii(cls: type) -> list[str]:
    """
    Retorna lista de campos da classe que estão sem anotação @pii nem @no_pii.
    Falha do CI se a classe é @contains_pii e essa lista não está vazia.
    """
    if not getattr(cls, "_contains_pii", False):
        return []

    faltando: list[str] = []
    for nome in dir(cls):
        if nome.startswith("_"):
            continue
        attr = getattr(cls, nome, None)
        if attr is None or callable(attr):
            continue
        if getattr(attr, "_pii", None) is not None:
            continue
        if getattr(attr, "_no_pii", False):
            continue
        faltando.append(nome)
    return faltando
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall