Formato de dados aberto em português: como o jsonW funciona?
jsonW é um formato de dados da Wortic com texto compatível com JSON, arquivo em coluna, tipos de negócio e permissões. Veja como funciona.

O jsonW é um formato de dados criado pela Wortic, no Brasil. O mesmo dado existe em três formas sem perda: texto, linha e coluna no arquivo .jsw. Todo JSON válido é um jsonW-texto válido. A versão atual é a 1.4.1, distribuída com a licença Sustainable Use, do tipo fair-code.
O que é o jsonW?
O jsonW é um formato de dados e uma biblioteca em C, sem dependências externas, com ferramenta de linha de comando e SDKs para várias linguagens. O README público resume o projeto como um arquivo que é ao mesmo tempo texto compatível com JSON, armazenamento colunar, índice vetorial para busca por significado e camada de permissão.
As palavras-chave do esquema são em português: texto, dinheiro, medida, codigo, tempo, dic e qualquer. O próprio README explica que o vocabulário é pequeno e fixo, e que o formato nasceu no Brasil.
Na prática, um arquivo jsonW traz no topo um esquema, uma linha com o nome e o tipo de cada coluna. Por exemplo, id, produto, preço e peso. O tipo diz o que o valor significa, e não só como ele está escrito. Um peso marcado como medida em gramas aceita quilos e converte ao gravar.
Como o mesmo dado vira texto, linha e coluna?
Um mesmo conjunto de registros pode ficar em três formas. A forma texto é legível por pessoas. A forma linha, binária, serve para eventos e mensagens. A forma coluna, no arquivo .jsw, serve para lotes, histórico e busca. A conversão entre elas não perde dado. Os comandos abaixo são do README do projeto:
wjsw de-texto 'id:i64,product:texto,price:dinheiro,weight:medida[g],sku:codigo' sales.jsonl sales.jsw
wjsw ver sales.jsw mostra as linhas em jsonW-texto. wjsw conferir sales.jsw faz a verificação completa, com sha256 e crc32c. wjsw para-texto sales.jsw --json devolve o JSON de volta, sem perda.
Quais tipos o jsonW tem que o JSON não tem?
O JSON guarda números, textos e listas. O jsonW acrescenta tipos pensados para dados de negócio, descritos na referência do formato:
dinheiro: cada valor leva a moeda ISO 4217, e a soma só acontece na mesma moeda.decimal[2]: valor exato com escala fixa, sem passar por ponto flutuante.medida[kg]: unidades da mesma grandeza são convertidas ao gravar, e outra grandeza é recusada.codigo: bytes exatos, sem normalizar. Serve para CNPJ, chave, placa e SKU, em que o zero da frente não pode sumir.tempo: microssegundos em UTC.vf16[n]evq8[n]: vetores, para busca por cosseno.
Como o jsonW controla quem vê cada dado?
A permissão fica no esquema. Uma coluna marcada com +pessoal só aparece para quem tem o escopo pessoal. Uma coluna marcada com +escopo(x) só aparece com o escopo x. Se houver uma coluna tenant com número inteiro, a credencial vê só as linhas do seu cliente.
A referência resume a regra assim: o que a sessão não pode ver não sai do servidor. Na conferência, cada bloco tem crc32c e o arquivo tem uma cadeia de SHA-256 ou BLAKE3. Qualquer byte alterado faz a conferência falhar.
O que ainda está em construção?
Há dois pontos para conhecer antes de adotar. O primeiro: a leitura de um arquivo .jsw usa um núcleo só hoje. Os blocos são independentes, o que permite leitura paralela, e ler em vários núcleos é o próximo passo. O segundo: a versão 1.4.0 traz cifragem do arquivo em repouso, com a chave guardada fora do arquivo. Versões mais antigas recusam o arquivo cifrado em vez de ler o conteúdo cifrado.
Dá para usar o jsonW sem trocar o banco de dados?
Dá. O comando wcon leva dados do PostgreSQL, MySQL, MariaDB, SQLite, Redis e MongoDB para um arquivo .jsw e de volta, em ida e volta sem perda, segundo o README. Você continua usando o seu banco. Para a leitura no navegador, há uma versão em WebAssembly do mesmo núcleo, só de leitura.
Quando faz sentido usar o jsonW?
Ele faz sentido quando o dado de negócio exige precisão: valores em dinheiro, medidas com unidade, códigos que não podem perder o zero da frente. Faz sentido também quando a mesma base serve clientes diferentes e cada um deve ver só a sua parte, como as linhas de cada cliente e as colunas marcadas com escopo.
Para uma primeira experiência, comece com um arquivo pequeno. Converta um JSONL com o comando de-texto, confira o resultado com o comando conferir e leia com o comando ver. Se o resultado bater com o que você esperava, o mesmo esquema cresce com os dados reais.
Perguntas frequentes sobre o jsonW
O jsonW é código aberto?
O formato, os SDKs, os tipos e a ferramenta de linha de comando são públicos, e você pode usá-los dentro dos seus produtos sob a licença Sustainable Use. Essa licença é do tipo fair-code, e não é uma licença open source no sentido da OSI. O núcleo em C vem como binário compilado, e você não pode revender o jsonW como serviço.
Preciso trocar meu banco de dados para usar o jsonW?
Não. O wcon faz a ida e a volta entre o seu banco e o arquivo .jsw, sem perda, segundo o README do projeto. Você mantém o banco e ganha o arquivo para análise, busca e permissões.
Dá para ler um arquivo jsonW no navegador?
Sim, desde a versão 1.3.14, pela versão em WebAssembly do mesmo núcleo C. A leitura é só de leitura: a escrita fica no servidor, e dados com permissão devem ter a visão aplicada no servidor antes de chegar ao navegador.
Perguntas frequentes
O jsonW é código aberto?
O formato, os SDKs, os tipos e a ferramenta de linha de comando são públicos, e você pode usá-los dentro dos seus produtos sob a licença Sustainable Use. Essa licença é do tipo fair-code, e não é uma licença open source no sentido da OSI. Você não pode revender o jsonW como serviço.
Preciso trocar meu banco de dados para usar o jsonW?
Não. O wcon faz a ida e a volta entre o seu banco e o arquivo .jsw, sem perda, segundo o README do projeto. Você mantém o banco e ganha o arquivo para análise, busca e permissões.
Dá para ler um arquivo jsonW no navegador?
Sim, desde a versão 1.3.14, pela versão em WebAssembly do mesmo núcleo C. A leitura é só de leitura, e dados com permissão devem ter a visão aplicada no servidor antes de chegar ao navegador.
Fontes
Conheça: jsonW (json Wondrous): o formato de dados da Wortic.
Quer isso funcionando na sua empresa?
Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.
Falar com um consultorEquipe editorial
Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.
- Automacao com IA
- Gestao empresarial
- CRM
- ERP
- Marketing digital
