Perfis de poços, em arquivo aberto.
Editor livre para todo o registro de um poço: perfis construtivos e geológicos, testes de bombeamento, operação, outorgas e qualidade da água, exportados em PDF. Um JSON simples, versionado, legível por qualquer linguagem.
Um JSON.
Todo o poço.
Hoje, dados de poços vivem em PDFs que não se conversam entre si. O arquivo .well é um formato simples e versionado para mudar isso — um único JSON que descreve o poço por inteiro, da construção e geologia aos testes de bombeamento, às bombas instaladas, hidrômetros e produção, outorgas, qualidade da água e histórico de manutenção, pensado como padrão internacional.
Desenho
Construção e geologia em escala real, desenhadas do mesmo jeito por qualquer ferramenta que leia o arquivo.
Registro
Estrutura previsível para arquivar e versionar dados de poços, prontos para submissão e auditoria.
Pesquisa
Campos métricos e organizados permitem cruzar e comparar poços entre aquíferos, regiões e épocas.
Aberto
JSON legível por humanos, especificação pública e licença permissiva — livre para usar, estender e contribuir.
Testes de bombeamento
Leituras brutas dos testes e interpretações versionadas — transmissividade, armazenamento, capacidade específica — cada uma ligada aos testes de origem. Veja § III.
Operação e histórico
Bombas instaladas, hidrômetros, volumes produzidos e regime de operação, outorgas com suas condicionantes, amostras de qualidade da água e um log de manutenções e incidentes ao longo da vida útil do poço.
Hoje, o dado de um poço d'água existe em muitos lugares: no caderno do perfurador, na planilha do consultor, no PDF do relatório entregue ao órgão licenciador. Cada um em seu formato, cada um ilegível para o outro. O welldot e o formato .well foram criados para resolver isso.
Este projeto começou como o Well Profiler, uma ferramenta para desenhar perfis de poços. Está se tornando algo mais amplo: uma plataforma aberta para todo o ciclo de vida do dado do poço — não só o desenho.
Editor ao vivo
Tabelas ligadas ao desenho. Edite uma camada, veja o perfil redesenhado em escala real.
Formato aberto
JSON legível, especificação pública e licença Apache 2.0. Implemente em qualquer linguagem.
Submissão pronta
Relatórios PDF com a sua marca, as seções que você escolher e o perfil em escala real em várias páginas, em português ou inglês.
Da leitura de campo aos parâmetros do aquífero.
Cada medição de nível e cada teste de bombeamento é uma entrada de um registro de acréscimo: medições pontuais, testes de vazão constante e escalonada, air-lift, recuperação etc. As leituras ficam como foram feitas, e rebaixamento, s/Q, Q/s e outros parâmetros são calculados automaticamente.
O teste como foi feito
Etapas com vazão e duração, leituras de nível no tempo e recuperação após a parada da bomba.
Interpretação versionada
Cada análise registra método, analista, testes de origem e resultados — T, S, K, capacidade específica, vazão máxima recomendada. Várias podem coexistir.
Editor de análises
O editor já lê as análises e mostra o estado atual do aquífero. Criar e editar análises no app está a caminho.
Teste escalonado de exemplo, desenhado pelos gráficos do editor.
Padrão por dentro,
flexível por fora.
Um único arquivo em texto legível: arquivável em pastas, versionável em git, indexável em bancos de dados, analisável por IA. O núcleo é rígido onde importa — métricas em SI, WGS84, chaves em inglês — e flexível no resto.
O repositório inclui uma welldot.skill pronta: aponte qualquer agente para github.com/rafaeelneto/welldot e ele opera o formato nativamente.
Comece com o que você tem.
Dado de poço quase nunca está completo. Um relatório de 1987 só com a profundidade e a vazão do air-lift, um cadastro sem coordenadas, um perfil sem litologia, uma outorga ainda sem número: cada um já é um arquivo .well válido. Quase todo campo é opcional, campos abertos aceitam qualquer texto e um campo ausente significa desconhecido — nunca zero. No campo e em arquivos antigos, saber o que falta também é informação.
Quase tudo é opcional
Nome, coordenadas, data de construção, perfurador, litologia, testes, outorgas: cada bloco e cada campo entra quando existir. Blocos construtivos podem ser listas vazias. Um evento precisa só de id, tipo e data; uma outorga, de tipo e órgão.
Valores sugeridos, texto livre
Material do revestimento, método de perfuração, tipo de outorga, tipo de manutenção, uso do poço: o formato recomenda um vocabulário para interoperar, mas campos abertos aceitam qualquer valor. Valores fora dele levam o prefixo x- e são preservados e exibidos como foram escritos.
Ausente é desconhecido
Sem regime, a vazão é desconhecida, não zero. Sem mudança de status, o status é desconhecido, não ativo. A produção antes da primeira leitura do hidrômetro é desconhecida.
A falta também é dado
Dados faltantes e inconsistências viram avisos para revisão, nunca rejeição. O registro fica no arquivo com seu histórico, e o que não se sabe continua visível em vez de ser preenchido com valores inventados.
{
"version": 2,
"name": "Poço 03",
"well_type": "tubular",
"well_depth": 84,
"obs": "Relatório de 1987. Sem perfil litológico.",
"bore_hole": [
{
"from": 0,
"to": 84,
"diameter": 250
}
],
"well_case": [
{
"from": 0,
"to": 84,
"diameter": 152,
"type": "x-galvanized_iron"
}
],
"reduction": [],
"well_screen": [],
"surface_case": [],
"hole_fill": [],
"lithology": [],
"fractures": [],
"caves": [],
"hydrodynamic_events": [
{
"id": "evt-01",
"type": "airlift",
"datetime": "1987-03-10T00:00:00-03:00",
"steps": [
{
"rate": 6
}
]
}
]
}Qualquer um pode estender.
Um perfurador, uma consultoria, uma companhia de saneamento, uma universidade ou um órgão gestor: qualquer um pode acrescentar o que o seu trabalho precisa, sem pedir licença e sem quebrar os arquivos dos outros. A spec obriga todo leitor a manter essas extensões ao abrir e ao salvar. E o que se mostra útil para muitos pode entrar no próprio formato.
Campos e blocos próprios
Qualquer objeto aceita campos com prefixo x-, e o arquivo aceita blocos inteiros novos: o número do cadastro estadual, o código interno da empresa, o monitoramento de gases de uma mina.
Profiles de instituições
Um órgão, uma empresa ou uma rede de pesquisa publica um JSON Schema que exige campos extras, restringe vocabulários ou define suas extensões x-. O arquivo declara o perfil em profiles. Falhas viram avisos, e um profile fora do ar nunca bloqueia o arquivo.
Do x- ao padrão
Um valor x- que se mostra útil em várias fontes pode ser promovido a canônico: x-slug_test vira slug_test, e as duas formas seguem válidas até a próxima versão maior. Mudanças no núcleo começam com uma issue aberta: o dado, a fonte real dele e por que nenhum campo o comporta.
{
"version": 2,
"name": "Poço 03",
"well_type": "tubular",
"well_depth": 84,
"bore_hole": [],
"well_case": [],
"reduction": [],
"well_screen": [],
"surface_case": [],
"hole_fill": [],
"lithology": [],
"fractures": [],
"caves": [],
"x-siagas": {
"registro": "1500012345"
}
}O futuro.
A v2.3 cobre perfis geológicos, construtivos e hidrodinâmicos — testes de bombeamento, análise de aquífero, instalações de bomba, hidrômetros, produção e regime de operação, outorgas e suas condicionantes, qualidade da água, anexos gerais e histórico operacional. A especificação evolui de forma aberta, e estas são as lacunas já mapeadas para as próximas versões.
.las nativo
Importação e armazenamento de perfis geofísicos LAS (resistividade, raios gama, cáliper), lado a lado com o perfil litológico.
Poços vinculados
Referências entre arquivos: poços de observação para o coeficiente de armazenamento e uma outorga compartilhada por vários poços, em vez de repetida em cada um.
Texto multilíngue
Descrições e observações marcadas com o idioma, para que o mesmo arquivo traga texto em português, inglês ou espanhol — strings simples continuam válidas.
Avaliação da qualidade da água
Julgamentos interpretados como classe da água, fácies hidroquímica e aptidão de uso, guardados junto às amostras de onde vêm.
Ferramentas livres e abertas, não só um app.
O welldot é um conjunto de pacotes pequenos e independentes. Use o editor, ou aproveite só a peça que você precisa na sua própria stack.
@welldot/core
Tipos, validadores Zod, JSON Schema e serialização do formato .well, mais seus vocabulários — materiais, tipos de outorga, parâmetros e limites de qualidade da água. A base sobre a qual tudo o mais é construído.
Ver código-fonte →@welldot/utils
Análise de um arquivo .well: geometria e volumes, hidráulica de aquífero e séries de teste de bombeamento, produção por período e prazos de outorga, derivações de qualidade da água como balanço iônico, Piper e Stiff.
Ver código-fonte →@welldot/render
O renderizador SVG em D3 que desenha todo perfil deste site em escala real, com tema configurável — incorporável em qualquer aplicação web.
Ver código-fonte →@welldot/pdf
Relatórios PDF personalizáveis com pdfmake: marca, marca d'água, layout de página, tema, seções e sua ordem, textos em en/pt. Funciona sem nenhum framework de UI.
Ver código-fonte →@welldot/vue
Componentes base em Vue 3 para editores .well, com o tema Welldot e um módulo Nuxt.
Ver código-fonte →App do profiler
Este editor, código-fonte incluso. Nuxt 4 + Vue 3, publicado em welldot.org — faça um fork ou veja como é construído.
Ver código-fonte →