Avançado

10.1 Tratamento e padronização dos dados

Conversões de dados

Tipo	Entrada	Saída	Função
Data	13/03/2026	Date	parseEkyteDate
Data-hora	08/05/2026 08:52	Date	parseEkyteDateTime
Monetário	R$ 11,73 ou R$ 0.00	number	parseEkyteMoney
Número	1.234,56	number (1234.56)	parseEkyteNumber
Percentual	3%, +1.05%, -1.59%	number com sinal	parseEkytePercent
Duração	05:00	number em minutos	parseEkyteDuration
Zero-width	​ invisível	string limpa	cleanZeroWidth

Tratamento de campos vazios

Tipo de campo	Comportamento
Texto	"" (string vazia, não null)
Numérico	0
Data	null

Estratégia resiliente de parsing

1. Coleta — erros acumulados em parseErrors (sem lançar exceção).
2. Exibição — modal ParseErrorBadge no cabeçalho, listando as linhas problemáticas.
3. Processamento — linhas inválidas são ignoradas nos cálculos, mas o dashboard continua funcionando.

---

10.2 Padrões de qualidade

Todos os dashboards seguem estes padrões:

Item	Padrão
Stack técnico	React + TypeScript + Tailwind + Recharts + lucide-react
Parser de CSV	Papaparse
Parser de XLSX	SheetJS (xlsx)
Componentes UI	shadcn/ui (cards, badges, tabelas, dropdowns)
Cores semânticas	Verde = positivo / Vermelho = negativo / Amarelo = atenção / Azul = informativo / Cinza = neutro
Idioma	Português do Brasil
Formato de moeda	R$ 1.234,56
Formato de data	DD/MM/AAAA na exibição
Formato de duração	HH:MM na exibição (internamente em minutos)
Estado vazio	Mensagem clara + botão "Limpar filtros"
Estado de loading	Skeleton (não spinner)
Erros de parsing	Coletados, não bloqueiam; badge de qualidade
Badge de freshness	"Dados atualizados em DD/MM/AAAA HH:MM" no cabeçalho

Convenções globais

• Visual: identidade consistente entre páginas (cards, tipografia, bordas, sombras, espaçamentos).
• Filtros sticky com botão "Limpar filtros" à direita.
• Drawer lateral com largura e grupos visuais padronizados.
• Estados vazios com mensagem + ação.
• Loading skeletons (sem spinners).
• Tooltips em todos os KPIs explicando o cálculo.
• Atalhos: / foca search · Esc limpa/fecha · números alternam visualizações.
• Exportação: CSV ; UTF-8 com BOM, nome {página}-export-AAAA-MM-DD.csv.

Responsividade

Faixa	Largura	Comportamento
Mobile	< 768px	Sidebar vira menu hambúrguer; KPIs empilham em 1 coluna; gráficos com scroll horizontal; tabelas viram cards
Tablet	768px – 1280px	Sidebar colapsável (ícones-only); KPIs em 2 colunas; grade 2 colunas; drawers 80% da largura
Desktop	≥ 1280px	Sidebar fixa 240px; KPIs em 4+ colunas; grade 2×2; drawers 450–500px

Padrões adicionais:

• Touch-friendly: áreas clicáveis com mínimo 44×44px em mobile/tablet.
• Gráficos: usar ResponsiveContainer do Recharts em todos os casos.
• Tabelas com muitas colunas: em mobile, mostrar apenas 3–4 colunas-chave e expor o restante no drawer.
• Testar em três larguras antes de marcar um dashboard como pronto: 375px, 1024px e 1440px.

---

10.3 Dicionário de dados — Projetos e Tarefas

Projetos — Projeto_-_*.csv (29 colunas)

Coluna	Tipo	Descrição
Id	Inteiro	Identificador único do projeto
Identificação	Texto	Slug ou código curto
Projeto	Texto	Nome de exibição
Tags	Texto	Tags atribuídas (separadas por vírgula)
Cronograma compartilhado	Texto	Indicador de cronograma compartilhado
Workspace	Texto	Workspace do projeto
Evolução tarefas	Percentual	% de tarefas concluídas
Tarefas realizadas	Inteiro	Tarefas concluídas
Tarefas previstas	Inteiro	Tarefas planejadas
Evolução horas	Percentual	% de horas executadas vs. previstas
Horas realizadas	Decimal	Total de horas trabalhadas
Horas previstas	Decimal	Total de horas planejadas
Tendência esforço	Decimal	Projeção de horas até a conclusão
Tarefas	Inteiro	Total de tarefas
Tarefas atrasadas	Inteiro	Tarefas com prazo vencido
Tickets	Inteiro	Tickets vinculados
Tickets atrasados	Inteiro	Tickets vencidos
Início	Data	Data de início
Término	Data	Data de término (pode ser vazio)
Responsável	Texto	Nome do responsável
Orçamento	Monetário	Orçamento total
Valor previsto	Monetário	Receita/honorário previsto
Valor realizado	Monetário	Receita/honorário realizado
Despesas previstas	Monetário	Despesas planejadas
Despesas realizadas	Monetário	Despesas incorridas
PI previsto	Monetário	Projeto Interno previsto
PI realizado	Monetário	Projeto Interno realizado
Planejado	Texto	Planejado ou Não planejado
Situação	Texto	Ativo, Pausado, Concluído, etc.

Tarefas — Controle_de_tarefas_-_*.csv (25 colunas)

Coluna	Tipo	Descrição
Id	Inteiro	Identificador único
Situação	Texto	Ativa, Concluída, Cancelada, etc.
Tarefa	Texto	Nome da tarefa
Tags	Texto	Tags atribuídas
Workspace	Texto	Workspace
Criada por	Texto	Usuário criador
Criada em	Data	Data de criação
Canal	Texto	Canal de origem
Fluxo de trabalho	Texto	Workflow associado
Etapa	Texto	Etapa atual
Responsável	Texto	Pode listar múltiplos, separados por vírgula
Executor	Texto	Executor
Quantidade de peças	Inteiro	Peças criativas vinculadas
Quantidade de formulários	Inteiro	Formulários preenchidos
Iniciar etapa em	Data	Início planejado da etapa
Executar etapa até	Data	Prazo da etapa
Concluir tarefa até	Data	Prazo final da tarefa
Restam	Duração	Tempo restante (HH:MM)
Última resposta	Data-hora	Timestamp da última interação
Prioridade	Texto	Urgente (100), Alta, etc., ou vazio
Esforço Realizado	Duração	Horas trabalhadas (HH:MM)
Origem	Texto	Projeto: <nome> ou Ticket (atendimento): <nome>
Orçamento	Monetário	Orçamento da tarefa
Valor previsto	Monetário	Valor previsto
Valor realizado	Monetário	Valor realizado

---

10.4 Dicionário de dados — demais fontes

Funil Multicanal 360 — formato pivotado

Coluna	Tipo	Descrição
Workspace	Texto	Workspace
Métrica	Texto	Nome da métrica (Impressões, Cliques, Visitas, Leads, Valor gasto)
<data 1>, <data 2>, ...	Numérico	Uma coluna por data — valor da métrica naquela data

Atividades por Executor

Coluna	Tipo	Descrição
Executor	Texto	Nome do executor
Email	Texto	E-mail do executor
Workspace	Texto	Workspace
Executadas (Tarefas)	Inteiro	Tarefas executadas no período
Atrasaram	Inteiro	Quantas das executadas atrasaram
Esforço (Tarefas)	Duração	Esforço total em tarefas (HH:MM)
Qtd. Peças	Inteiro	Peças produzidas
Esforço (Etapas)	Duração	Esforço em etapas
Executados (Tickets)	Inteiro	Tickets executados
Esforço (Tickets)	Duração	Esforço em tickets
Esforço (Outros)	Duração	Outros esforços
Esforço (Total)	Duração	Soma de todos os esforços
Valor Realizado	Monetário	Valor financeiro realizado pelo executor

Despesas de Projetos

Coluna	Tipo	Descrição
Workspace	Texto	Workspace
Despesa	Texto	Nome da despesa (pode conter zero-width char)
Projeto	Texto	Projeto vinculado
Canal	Texto	Canal (pode vir vazio → tratar como (Sem canal))
Tags	Texto	Tags separadas por |
Valor previsto	Monetário	Valor planejado
Data prevista	Data	Data planejada de pagamento
Valor realizado	Monetário	Valor efetivamente pago
Data realizada	Data	Data efetiva de pagamento (vazia se não pago)

Monitoramento de Campanhas — 35 colunas com multilinha

Coluna	Tipo	Descrição
Workspace	Texto	Workspace
Nome	Texto	Nome da campanha
Status	Texto	Status da campanha
Período	Texto	Período de veiculação
Valor gasto	Monetário	Total investido
Impressões	Inteiro	Total de impressões
Cliques	Inteiro	Total de cliques
Visitas	Inteiro	Total de visitas
Vendas	Inteiro	Total de vendas
Receita	Monetário	Receita gerada
CTR	Percentual	Taxa de clique sobre impressões
CPM	Monetário	Custo por mil impressões
CPC	Monetário	Custo por clique
CPV	Monetário	Custo por visualização
CPA	Monetário	Custo por aquisição
ROAS	Decimal	Retorno sobre o investimento em anúncios
Leads (MQL+SQL)	Multilinha	Uma linha por fonte: <fonte> | <valor>
Leads (MQL+SQL) var%	Multilinha	Variação % por fonte (preserva sinal)
CPL	Multilinha	Custo por lead por fonte
CPL var%	Multilinha	Variação % do CPL por fonte
Leads SQL	Multilinha	Leads SQL por fonte
Leads SQL var%	Multilinha	Variação % dos leads SQL por fonte

Monitoramento de Redes Sociais — XLSX com cabeçalho de 2 linhas

Linha do cabeçalho	Colunas
Linha 1	Workspace (1 coluna) | Instagram (7 colunas mescladas) | Facebook (7) | LinkedIn (7) | TikTok (7)
Linha 2	(vazio) | Seguidores | Novos seguidores | Alcance | Engajamento | Reações | Comentários | Compartilhamentos | (repete para cada rede)

Campos resultantes após merge:

Campo	Rede	Métrica
workspace	—	Identificador do workspace
instagram_seguidores	Instagram	Total de seguidores
instagram_novos_seguidores	Instagram	Novos seguidores no período
instagram_alcance	Instagram	Alcance total
instagram_engajamento	Instagram	Engajamento total
instagram_reacoes	Instagram	Reações
instagram_comentarios	Instagram	Comentários
instagram_compartilhamentos	Instagram	Compartilhamentos
facebook_seguidores	Facebook	Total de seguidores
facebook_novos_seguidores	Facebook	Novos seguidores no período
facebook_alcance	Facebook	Alcance total
facebook_engajamento	Facebook	Engajamento total
facebook_reacoes	Facebook	Reações
facebook_comentarios	Facebook	Comentários
facebook_compartilhamentos	Facebook	Compartilhamentos
linkedin_seguidores	LinkedIn	Total de seguidores
linkedin_novos_seguidores	LinkedIn	Novos seguidores no período
linkedin_alcance	LinkedIn	Alcance total
linkedin_engajamento	LinkedIn	Engajamento total
linkedin_reacoes	LinkedIn	Reações
linkedin_comentarios	LinkedIn	Comentários
linkedin_compartilhamentos	LinkedIn	Compartilhamentos
tiktok_seguidores	TikTok	Total de seguidores
tiktok_novos_seguidores	TikTok	Novos seguidores no período
tiktok_alcance	TikTok	Alcance total
tiktok_engajamento	TikTok	Engajamento total
tiktok_reacoes	TikTok	Reações
tiktok_comentarios	TikTok	Comentários
tiktok_compartilhamentos	TikTok	Compartilhamentos

Publicações

Coluna	Tipo	Descrição
Id	Inteiro	Identificador único da publicação
Canal	Texto	Perfil/conta de publicação (ex.: Nome (@handle))
Publicação	Texto	Nome/título da publicação
Tipo	Texto	Formato do post (ex.: Post Único: Feed, Post Carrossel: Feed)
Workspace	Texto	Workspace associado
Tarefa	Inteiro	ID da tarefa vinculada
Etapa	Texto	Etapa atual da publicação no fluxo
Projeto	Texto	Projeto relacionado
Veiculação	Texto	Plataforma de publicação (Instagram, TikTok, LinkedIn etc.)
Agendado	Data-hora	Data e hora agendados (DD/MM/AAAA HH:MM)
Aprovação	Texto	Aprovado, Em análise, Em revisão, Pendente
Situação	Texto	Agendado, Publicado parcialmente, Não publicado