V vitor.rocha
todos os projetos // projeto · go + química

Moltech

Tabela periódica interativa escrita em Go: a estrutura eletrônica dos 118 elementos não fica gravada em arquivo — é calculada a partir do número atômico e desenhada num modelo 3D do átomo que gira com o mouse.

Banner do projeto Moltech

Visão geral

O Moltech reúne numa só página a tabela periódica, um modelo 3D de cada átomo, a forma dos orbitais e os íons mais comuns. A tabela pode ser colorida por classificação ou por propriedade, o site inteiro alterna entre português e inglês, e tudo funciona tanto servido pelo Go quanto exportado como site estático no GitHub Pages.

O problema

Tabelas periódicas costumam guardar a configuração eletrônica de cada elemento como texto pronto, o que esconde justamente a regra que o estudante precisa entender. A proposta aqui foi o contrário: um programa que parte só do número atômico e chega sozinho a grupo, período, camadas, orbitais e íons — e que consegue provar que o resultado está certo.

A solução

Um pacote em Go distribui os elétrons pela regra de Madelung, aplica as 20 exceções conhecidas (como cromo e cobre), monta o diagrama de orbitais pela regra de Hund e calcula a configuração dos íons. Um teste automatizado compara o resultado dos 118 elementos com uma tabela de referência do PubChem. O mesmo programa serve as páginas, expõe uma API em JSON e exporta o site estático; no navegador, um motor 3D escrito à mão em canvas desenha o átomo sem nenhuma biblioteca.

Funcionalidades

  • Tabela com 118 elementos, colorida por categoria, bloco, estado físico ou por propriedade em escala de cor
  • Modelo 3D do átomo que gira ao arrastar, com seleção de camada e faixas de subcamadas s, p, d e f
  • Forma dos orbitais s, p, d e f em malha 3D, a partir dos harmônicos esféricos
  • 100 íons comuns, com o modelo mostrando o íon escolhido
  • Site inteiro em português e inglês, com configurações salvas no navegador
  • Layout responsivo: no celular a tabela inteira encolhe até caber, sem rolagem lateral

Arquitetura

O pacote chem concentra dados e cálculos e não conhece HTTP; o pacote site renderiza as três páginas com html/template uma única vez, na inicialização, e as serve de memória. HTML, CSS, JavaScript, fontes e dados vão embutidos no binário com embed, então o executável não depende de nenhuma pasta ao lado. Cada arquivo estático recebe uma impressão digital no endereço, o que resolve o cache do navegador sem configuração.

Screenshots

Desafios & aprendizados

O bug mais instrutivo não estava na química: depois de uma atualização, o navegador juntava a página nova com o CSS antigo guardado em cache, e o site aparecia quebrado só para quem já o tinha aberto. A correção — versionar o endereço dos arquivos pelo conteúdo — mostrou que servir bem faz parte do produto. Do lado dos cálculos, ficou a lição de desconfiar da fonte de dados: no laurêncio, a tabela de referência e o NIST discordam, e o teste registra essa escolha em vez de escondê-la.