Markup
HTML puro
O app é um único documento HTML que define toda a interface, incluindo formulário, painéis de resultado, botão de ajuda e conteúdo modal. Não existe framework nem sistema de componentes.
Stack principal
O que sustenta esta calculadora e como a implementação se mantém extremamente leve.
Estilo
CSS customizado
O visual é controlado por uma única folha de estilo. O projeto usa uma aparência própria, regras responsivas e tipografia importada sem depender de Tailwind, Bootstrap ou pipeline de build.
Lógica
JavaScript vanilla
A lógica da calculadora roda diretamente no navegador com funções em JavaScript puro. Validação de inputs, cálculos, atualização do DOM e comportamento do modal são implementados sem bibliotecas externas.
Lógica de domínio
Cálculo fiscal e cambial
O foco do app é converter valores de compra e venda com cotações PTAX, estimando lucro bruto, imposto, IOF e valor líquido em operações com ações americanas sob a ótica fiscal brasileira.
Referência externa
Contexto PTAX do BCB
A calculadora leva o usuário à página histórica de PTAX do Banco Central e explica qual lado da PTAX é relevante na compra e na venda. Ela não automatiza essa consulta.
Modelo de runtime
Sem etapa de build
Este projeto é totalmente estático. Ele pode ser aberto diretamente no navegador ou servido por qualquer servidor estático simples, o que torna uso local e deploy muito fáceis.
Como roda
Toda a aplicação executa no navegador dentro de uma única página.
1
O navegador carrega uma única página HTML
A interface, os rótulos, os campos de entrada, as áreas de resultado e a marcação do modal ficam todos embutidos em index.html.
2
A folha de estilo define a interface
styles.css fornece toda a camada visual, incluindo layout, tipografia, botões, modal e ajustes mobile.
3
A entrada do usuário dirige o cálculo
Quando o usuário informa PTAX e valores da operação e clica em calcular, o JavaScript inline valida os campos e executa as contas de conversão.
4
A página atualiza os campos de resultado
O app escreve os valores calculados diretamente em nós do DOM para custo de aquisição, valor de venda, lucro bruto, imposto, IOF, lucro líquido e análises percentuais.
5
O modal explicativo vive na própria página
O conteúdo de ajuda é implementado no mesmo documento e alternado com mudanças simples de classe e display no DOM, sem um sistema de componentes.
Mapa da arquitetura
A estrutura é simples: uma página, uma folha de estilo e uma camada de lógica inline.
Arquivos principais
index.htmlMarkup da interface principal, modal de ajuda e lógica de cálculo inline.
styles.cssDesign visual completo, regras de layout, tipografia e responsividade.
tax.icoAsset de favicon do projeto.
Análise da Arquitetura
index.html styles.css tax.ico
O projeto é essencialmente uma aplicação autocontida de navegador. Isso reduz manutenção, mas também limita estrutura e escalabilidade em comparação com apps baseados em componentes.
Dados e lógica
A calculadora é guiada por input do usuário e não depende de armazenamento persistente nem serviços de backend.
Cálculo
Todos os resultados são derivados no navegador
O usuário informa manualmente cotações e valores da operação.
A lógica em JavaScript valida os campos antes de mostrar qualquer resultado.
Lucro, IOF e imposto são calculados imediatamente na página.
Nenhum dado é enviado a backend nem salvo em banco.
Modelo de referência
Ferramenta educativa e de simulação
A interface aponta para o histórico de PTAX do BCB.
O modal explica por que lados diferentes da PTAX importam em compra e venda.
A calculadora se apresenta como apoio à simulação, não como motor fiscal definitivo.
A própria página recomenda consultar um contador especializado.
Comandos para rodar
Nenhum dev server de framework é necessário, a menos que você queira um.
Uso local
open index.html # ou python -m http.server
Você pode abrir o arquivo diretamente no navegador ou servir a pasta com qualquer servidor estático pequeno, se preferir um fluxo baseado em URL local.
Ambiente esperado
O que o app precisa
Nenhuma instalação de dependência.
Nenhuma variável de ambiente.
Nenhuma API key.
Nenhum runtime de backend.
Resumo final
Capital Gains Calculator é um app web estático em HTML, CSS e JavaScript vanilla. Sua força está na simplicidade: tudo roda no navegador, não há etapa de build e a lógica de domínio é focada em um fluxo financeiro/fiscal bem específico.