Calc Ads

01 · leitura rápida

Resumo para decidir se vale aprofundar.

Simulador de planejamento de mídia com modelo auditado e premissas declaradas, para exploração de cenários de investimento em canais. Projeto aplicado secundário no portfólio.

02 · narrativa do percurso

O campo, a rota e o que foi aprendido.

Planejamento de mídia também pode ser transformado em sistema.

Boa parte do trabalho de planejamento não consiste apenas em encontrar números.

Consiste em relacionar premissas, fazer escolhas, comparar cenários e entender o que muda quando uma variável muda.

O Calc Ads nasceu de uma pergunta que atravessa minha trajetória entre comunicação e tecnologia:

o que acontece quando conhecimento de planejamento de campanhas deixa de existir apenas como raciocínio e passa a ser estruturado como um sistema interativo?

O resultado é um simulador exploratório para planejamento de campanhas digitais.

Tipo: aplicação web
Área: planejamento de mídia, simulação, software
Estado: projeto público e funcional
Papel no portfólio: projeto aplicado
Licença: MIT

O problema

Planejar uma campanha envolve decisões interdependentes.

Orçamento, escolhas de planejamento, expectativas de desempenho e premissas de cálculo precisam ser relacionadas para que um cenário faça sentido.

O desafio que me interessava não era simplesmente criar uma calculadora.

Era transformar uma lógica profissional em algo que pudesse ser:

• explicitado;
• parametrizado;
• calculado;
• comparado;
• questionado;
• e apresentado de maneira compreensível.

Isso muda a natureza da ferramenta.

Em vez de entregar um número isolado, o sistema ajuda a observar como determinadas escolhas alteram o cenário.

A hipótese

A hipótese do Calc Ads é simples:

uma parte do raciocínio usado no planejamento de campanhas pode ser formalizada em regras e premissas, desde que seus limites permaneçam visíveis.

A palavra importante é “premissas”.

O simulador não conhece o futuro de uma campanha.

Ele trabalha com entradas, relações e regras definidas no modelo para produzir cenários exploratórios.

Por isso, o projeto não tenta esconder as hipóteses atrás de uma interface bonita. Uma parte importante do desenvolvimento foi justamente documentar de onde elas vieram, como entram no cálculo e quais ainda precisam de validação adicional.

Meu papel

O projeto conecta duas áreas da minha experiência profissional.

De um lado, planejamento de comunicação e mídia.

De outro, desenvolvimento de software, modelagem de regras e construção de interfaces.

Concebi o produto, estruturei a lógica do simulador, desenvolvi a aplicação e conduzi posteriormente uma revisão específica do modelo para separar melhor:

• o que é regra do sistema;
• o que é premissa;
• o que pode ser calculado;
• e o que não deve ser apresentado como previsão.

Essa auditoria tornou-se parte do próprio projeto.

Como funciona

O Calc Ads recebe parâmetros de planejamento e os transforma em um cenário calculado.

O fluxo básico é:

1. Definir o cenário

A pessoa ajusta os dados e escolhas disponíveis no simulador.

2. Aplicar as regras do modelo

O núcleo utiliza as relações e premissas documentadas para calcular os indicadores previstos no escopo.

3. Apresentar os efeitos

A interface transforma esses cálculos em uma leitura mais útil para planejamento, permitindo observar como diferentes configurações produzem cenários distintos.

4. Revisar as premissas

Como o objetivo é apoiar exploração, e não esconder a lógica em uma caixa-preta, a documentação do projeto registra as premissas utilizadas e o escopo em que os resultados devem ser interpretados.

A pergunta deixa de ser apenas “qual é o número?” e passa a incluir:

“quais decisões e hipóteses fizeram esse número aparecer?”

De calculadora para modelo explícito

Durante a evolução do projeto, percebi que o principal desafio não estava apenas na interface ou no código.

Estava na confiabilidade do modelo.

Uma aplicação pode funcionar perfeitamente do ponto de vista técnico e ainda comunicar uma certeza que sua lógica não sustenta.

Por isso, o Calc Ads passou por uma revisão específica das regras e premissas.

O repositório público inclui hoje três documentos centrais:

MODEL_SCOPE.md
Delimita o que o simulador pretende fazer.

MODEL_PREMISES.md
Registra as premissas usadas pelo modelo.

MODEL_AUDIT.md
Documenta a revisão das regras e problemas identificados durante a auditoria.

Essa documentação transforma as limitações do modelo em parte observável do sistema.

Uma ferramenta de exploração, não de previsão

Esta distinção é fundamental.

O Calc Ads simula cenários.

Ele não prevê o resultado real de uma campanha.

Os valores calculados dependem das entradas e premissas utilizadas, e algumas dessas premissas permanecem heurísticas, ainda pendentes de validação com dados próprios ou fontes documentadas.

Por isso, o uso adequado do sistema é:

• comparar cenários;
• tornar hipóteses explícitas;
• apoiar discussões de planejamento;
• observar relações entre variáveis;
• explorar possíveis consequências das escolhas.

Não é:

• prometer performance;
• prever receita futura com certeza;
• substituir dados reais da campanha;
• transformar uma hipótese em benchmark universal.

Essa fronteira é parte do desenho do produto.

Tecnologias

O Calc Ads foi desenvolvido no ecossistema React e TypeScript, com Vite como infraestrutura de build.

O projeto foi estruturado como aplicação independente, o que permite integrá-lo ao site pessoal sem acoplar seu código ao código do portfólio.

Na arquitetura planejada para mateusfardin.com.br, o estudo de caso e a ferramenta ocupam papéis diferentes:

o estudo de caso explica o problema, o modelo e seus limites;

o simulador permite experimentar o sistema.

Essa separação também mantém os dois repositórios independentes.

Evidências e validação

Antes de entrar no conjunto principal do portfólio, o Calc Ads passou por uma auditoria de prontidão pública.

No estado verificado em setembro de 2026:

• o repositório está público;
• possui README em português e inglês;
• está sob licença MIT;
• possui documentação específica do modelo;
• o manifesto de publicação foi conferido contra os arquivos rastreados;
• dependências e artefatos de build não foram incluídos indevidamente;
• o teste do núcleo do modelo foi aprovado;
• o lint foi executado sem erros;
• o build foi concluído com sucesso.

Um asset cuja proveniência não estava confirmada foi deliberadamente mantido fora do recorte público.

A validação do projeto, portanto, considera não apenas se a interface abre, mas também o que está sendo publicado e como o modelo é explicado.

O que ainda permanece em aberto

O Calc Ads é funcional, mas não considero a documentação das premissas um assunto encerrado.

Algumas continuam identificadas como heurísticas e devem ser fortalecidas no futuro por:

• dados observados;
• referências externas adequadas;
• ou revisão metodológica adicional.

A ampliação da suíte de testes além do núcleo também está registrada como desenvolvimento posterior.

Essa condição não impede o uso do projeto como estudo de caso.

Na verdade, ela ajuda a mostrar uma parte importante do trabalho: transformar uma ideia funcional em um sistema cuja lógica também possa ser inspecionada.

O que este projeto demonstra

Entre os três projetos deste portfólio, o Calc Ads talvez seja o que mostra de forma mais direta a conexão entre duas etapas da minha trajetória profissional.

O conhecimento de planejamento não aparece apenas como conteúdo do sistema.

Ele é transformado em:

• estrutura de informação;
• regras;
• variáveis;
• cálculos;
• estados de interface;
• documentação;
• testes.

É justamente essa passagem que me interessa.

Nem todo problema de estratégia precisa virar software. Mas alguns ficam mais claros quando conseguimos tornar suas premissas manipuláveis e observar como as decisões se relacionam.

Estado atual

O projeto está público e apto a ser apresentado como estudo de caso.

A aplicação também foi concebida para permanecer experimentável como ferramenta própria.

Sua integração ao site pessoal prevê, portanto, duas entradas:

Estudo de caso
Para entender o problema, as escolhas de modelagem, a arquitetura e os limites.

Simulador
Para experimentar a ferramenta diretamente.

A rota definitiva da aplicação no site ainda pode ser ajustada sem alterar o projeto ou seu significado.

Aprofundar

Abrir o simulador

Ver código e documentação no GitHub

Entender o modelo: consultar MODEL_SCOPE.md, MODEL_PREMISES.md e MODEL_AUDIT.md.

O simulador está publicado separadamente do estudo de caso e pode ser usado diretamente.