← story.propek
STORY 5.2
LGPD + Coleta de Dados Sequencial
Epic: Bot WhatsApp Propek — Melhorias Fase 1
PENDING
2026-03-17
Implementar coleta de dados sequencial no fluxo de conversa e conformidade LGPD. Atualmente o bot nao coleta dados de forma organizada — o `LeadCaptureService` ja suporta tags `[DATA:campo=valor]` com normalizacao, mas o system prompt nao instrui a IA a coletar dados sequencialmente. Alem disso, CPF e parseado pela normalizacao mas NUNCA e salvo no banco de dados. Zero mencao a LGPD em todo o projeto. O fluxo aprovado pelo Vinicius: (1) cliente monta pedido, (2) bot confirma, (3) bot coleta dados cadastrais sequencialmente, (4) APOS receber TODOS os dados, envia mensagem LGPD.
ACCEPTANCE CRITERIA (12/12)
System prompt inclui instrucao explicita para coletar dados sequencialmente APOS confirmacao do pedido
Sequencia de coleta: nome completo -> email -> telefone de contato (se diferente do WhatsApp) -> CPF ou CNPJ -> endereco completo (rua, numero, CEP)
IA usa tags `[DATA:campo=valor]` para cada dado coletado (mecanismo ja existe)
CPF e salvo no banco: `saveLeadData()` inclui bloco para campo `cpf` (atualmente ausente — apenas cnpj tem bloco na linha 141-144)
Coleta e condicional: so pede dados se for primeira compra (cliente `novo`). Cliente retornante ja tem dados no banco
Telefone de contato: bot pergunta "o telefone de contato e o mesmo deste WhatsApp?" — se sim, nao precisa responder
Cada dado e pedido em mensagem separada, um por vez (nao despeja formulario inteiro)
Mensagem LGPD enviada APOS receber TODOS os dados, nao antes
Mensagem fixa (nao gerada pela IA): "Seus dados estao protegidos de acordo com a Lei Geral de Protecao de Dados (LGPD). Utilizamos suas informacoes apenas para processar seu pedido e melhorar nosso atendimento."
Tag `[LGPD_SENT]` inserida pela IA apos enviar mensagem LGPD (para rastreamento)
Campo `lgpd_informed_at` com timestamp na tabela customers (opcional mas recomendado)
Bot NAO pede consentimento antes da coleta (a coleta e necessaria para processar o pedido — base legal: execucao de contrato)
ARQUIVOS (6)
propek-whatsapp-bot/src/prompts/system-prompt.ts Modified
propek-whatsapp-bot/src/services/lead-capture.service.ts Modified
propek-whatsapp-bot/src/handlers/whatsapp.handler.ts Modified
propek-whatsapp-bot/src/migrations/018_add_cpf_lgpd_columns.sql Created
propek-whatsapp-bot/tests/lgpd-data-collection.test.ts Created
propek-whatsapp-bot/tests/handler-lgpd.test.ts Created