Executando verificação de segurança...
5

[UPDATE] Pitch: Abri o banco de dados (JSON de 2.8MB) e a lógica das 1190 ferramentas do Utilweb no GitHub

Salve pessoal!!
Há uns meses compartilhei aqui o Utilweb, um projeto de utilitários que desenvolvo nas minhas madrugadas de plantão na drogaria.
O negócio tomou uma proporção muito maior do que eu esperava. Segui os conselhos de vocês no último post e inclusive adicionei o conversor de moedas que me pediram por aqui... E hoje o site bateu mais de 1190 ferramentas rodando.
Só que a realidade bateu na porta, basicamente cheguei no meu limite físico de tempo.
Conciliar o trabalho da madrugada, a atenção com a minha esposa e minha filha durante o dia e ainda revisar regras de rescisão da CLT e dezenas de fórmulas matemáticas sozinho... simplesmente não tá dando. É muita coisa pra uma só pessoa manter 100% atualizado.
Para não deixar o projeto estagnar ou ficar com cálculos zuados, decidi dar um passo além. Abri no GitHub os bancos de dados principais do site e as lógicas em JS.
Liberei lá:
• Meu conversores-db.json: Tem quase 3MB só de fatores de conversão já mapeados e mastigados (física, culinária, medidas, etc).
• As lógicas em JS puro: Códigos de calculadoras que são bem chatas de fazer do zero (Rescisão CLT atualizada, Salário Líquido, Juros Compostos, etc).
O meu pedido de ajuda:
Se você tá criando algum app ou projeto e precisa desses dados de conversão, fica à vontade pra usar (só peço a moral de linkar o Utilweb como fonte dos dados).
Por outro lado, se você notar alguma regra trabalhista desatualizada, um fator de conversão com erro decimal, ou quiser adicionar a lógica de uma ferramenta nova no JSON, por favor, manda um PR. Vai salvar as minhas madrugadas de verdade!
O repositório com tudo está aqui: https://github.com/vandaumm/utilweb-open-data
Para quem não conhece o portal ainda: https://utilweb.com.br
Mais uma vez, valeu demais pelo apoio que me deram desde o início. Isso aqui continua sendo um baita aprendizado.

EDIT:
Fala pessoal, passando para dar um update da madrugada. O plantão hoje rendeu graças aos feedbacks de vocês, principalmente o toque do @swxtz.

Percebi que no primeiro commit eu tinha jogado muito ruído lá dentro. Tinha guia de texto e algumas lógicas misturadas que não faziam sentido para uma base de dados aberta. Tava meio confuso.

Fiz uma limpa e organizei tudo. Agora o repositório tá focado 100% em infraestrutura de dados.

Foco triplo: Conversores, Moedas e Horários.
Organização: Cada categoria agora tem o seu JSON limpo (o banco de dados) e o seu JS isolado (a lógica matemática).
Documentação: Adicionei um readme bilíngue (Inglês e PT-BR) já com a licença MIT e a instrução de atribuição.

Como o próximo passo é estruturar a tipagem disso tudo, deixo o convite: se alguém manjar de TypeScript e quiser mandar o primeiro PR com o esqueleto das interfaces, vai salvar demais.

O link continua o mesmo: https://github.com/vandaumm/utilweb-open-data
Valeu demais por ajudarem a melhorar o projeto. Tmj!

Carregando publicação patrocinada...
4

Uma dica amigo, embora seja um projeto para brasileiros tem valores de conversão que pode ser usado mundialmente, passe o projeto para typescript para ter suporte para o typescript e faça os nomes dos arquivos e variáveis e principalmente a documentação em inglês assim qualquer um pode colaborar no seu projeto

2

Muito obrigado pelo insight, man.

Acabei focando no que era mais rápido, JS puro e português. Mas você tem razão, fatores de conversão física e matemática são universais.

Fazendo o projeto em TypeScript e documentando em inglês, eu abro as portas para colaboradores do mundo inteiro.

Vou colocar essa refatoração no meu próximo "plantao de desenvolvimento kkk". Começarei traduzindo o README e as chaves principais do JSON para inglês. Se você ou mais alguém manjar de TS e quiser abrir um PR com o primeiro esqueleto da tipagem, vai ser um aprendizado enorme pra mim.

Muito obrigado por enxergar esse potencial. Sucesso!

2
2

Valeu demais pelo interesse, @realfakenerd!
Acabei de fazer um update pesado no repositório para facilitar justamente essa parte visual. Agora já subi os arquivos CSS e organizei as pastas de estilo e lógica separadinhas, exatamente como rodam no servidor.
Dá uma olhada no caminho assets/css/tools/. Se você tiver qualquer sugestão de refinamento de layout, espaçamento, tipografia ou cores, sinta-se à vontade para mandar um PR ou abrir uma Issue lá. O foco inicial foi funcionalidade bruta, então qualquer tapa no visual vai ajudar muito a deixar o portal mais profissional.
Valeu pela força!

Ah, coloquei o mapa do site no readme. Da uma olhada tambem.
Caso queira mexer em alguma ferramenta em especifico que nao esteja no github, so falar que subo tudo la.

3

Você construiu uma API? Que tal disponibilizar esse imenso e muito útil conjunto de ferramentas na forma deuma API pública? Posso ajudar nisso.

1

Muito boa a ideia da API.
Isso daria uma escala muito grande para o projeto. Como meu tempo tá bem curto por causa do plantão na drogaria, se você quiser abrir uma Issue ou um Draft PR lá no GitHub com uma proposta de como estruturar essa API (se for em TS melhor ainda), a gente vai trocando ideia por lá. Tmj e muito obrigado mesmo!