Changelog¶

Mudanças de produto e de documentação, mais recente primeiro. Uma entrada por mudança de regra, não por commit.

2026-09-14¶

Nova página Configuração pelo cliente: a sequência do que precisa estar configurado para o rastreamento medir, e o que o cliente precisa providenciar para o Instagram entrar na fila.
A taxonomia de tracking ganhou tela. Canal, campanha, peça, tipo de evento e origem do lead passaram a ser cadastro em Tracking › Taxonomia. Antes existiam só por seeder ou INSERT, o que prendia o módulo a quem tem acesso ao servidor. Nome duplicado dentro do mesmo pai é recusado, não sufixado: duas linhas com o mesmo nome visível seriam indistinguíveis na tela.
A auditoria voltou a ter uma tela só, em Configurações › Auditoria — a pendência registrada em 13/09 está fechada.
A tela de IA passou a pedir o provedor, não o dialeto. Anthropic, OpenAI, Gemini e Grok numa combo; escolher um carrega os modelos daquele provedor, perguntados a ele. Sem chave salva — ou com o provedor fora do ar — aparece a lista de reserva com o motivo, porque travar a tela de configuração travaria quem está tentando consertá-la.
Registrado que o Instagram exige app na Meta e o WhatsApp não — o WhatsApp daqui é Evolution API, sem relação com a Meta. A revisão de app da Meta provavelmente é dispensável se o app nascer no portfólio do próprio cliente.

Tracking entrou em produção. O módulo que esta documentação registrava como "desenhado e não construído" passou a existir: taxonomia de três níveis, link curto /l/CODIGO, Central de Atendimento, jornada do lead, dashboard com visão geral, funil e origem em árvore, e auditoria com autor pessoa, sistema ou IA.
O modelo de atribuição deixou de ser questão em aberto: primeiro toque ou último toque é configuração, alterável em tela e valendo na requisição seguinte, sem deploy e sem reprocessar dado.
A lacuna de rastreamento virou informação de primeira classe: lead sem origem tem fatia na receita, linha na cobertura e nó próprio na árvore, em cada nível.
Indicador que não pode ser calculado passa a mostrar — e a dizer por quê, nunca zero. Custo por lead é o caso: exige credencial do gerenciador de anúncios, que não está integrado.
Retenção de 13 meses no clique cru, por comando mensal. O clique que virou origem de um lead não sai.
Duas pendências registradas: quando reconstruir o agregado diário, e se a antiga /configuracoes/auditoria será aposentada — hoje o menu tem dois itens chamados "Auditoria".

Criado este site, em documentacao/, a partir do handoff de MkDocs.
Registrada a causa do anexo que não abria em produção: o worker da fila gravava como root e o PHP-FPM não lia. Correção versionada no PR 214, com o disco privado declarando permissions.
WA-32 concluída: nota de voz gravada e anexada, visualizador de PDF, imagem e vídeo, e as seis bolhas que chegavam em branco.
Corrigidos dois testes de agenda que falhavam só nos sábados, por causa da semana que começa no domingo em pt_BR.

AD-020: autorização para agir sobre um registro vem do vínculo, não de permissão de tela. Promovida a regra depois de dois defeitos em produção numa semana.
Tela inicial por perfil: cada perfil declara onde começa depois do login.
WA-31: fila de atendimento como consulta, captura por corrida no banco e devolução configurável.

WA-30: natureza do número, empresarial ou pessoal. Supervisão deixa de alcançar número pessoal.

AD-019: importação que traz tutor, hora e duração vira compromisso na agenda.
Importadas 134 linhas de vendas já datadas, pelo mesmo serviço de fechamento da venda digitada.

AD-017: o que foi vendido é dado da venda. O pacote é congelado em contract_items.
AD-018: prazo de contrato tem duas datas, referência e real, e não bloqueia agendamento.
A venda passou a ter uma tela só.

AD-016: autorização sobre um registro usa tabela de vínculo, nunca a tabela de permissões.

AD-014: entrega importada sem tutor, hora e duração não vira compromisso. 1243 entregas importadas sem tocar na agenda.

AD-012 e AD-013: servidor Evolution próprio e dedicado, com a chave global restrita ao .env e ao ciclo de vida de instância.

AD-011: arquivo com dado pessoal vive em disco privado, servido por rota que verifica permissão.

AD-009: cadastro e edição passam a usar cortina lateral, substituindo o modal centralizado de AD-005.
AD-010: permissão entra por migration, porque o deploy não roda seed.

AD-007: importação e sincronização do ClickUp são motores isolados.
AD-008: a semântica de uma etapa vem do papel, nunca do slug nem da posição.

Primeiras decisões registradas: motor único de sincronização, campo sincronizado como string, taxonomia em tabela seedada e o KP Notify System como único caminho de feedback visual.