Introdução

Os arquivos estão organizados em pacotes Go, sendo esses os quatro principais:

1. download/ responsável pelo download dos dados (basicamente uma automação utiliZando o chunk)
2. transform/ é um ETL que lê os arquivos baixados pelo pacote acima, processa cada um deles e salva os dados no banco de dados — entenda melhor sobre essa etapa lendo sobre os detalhes do ETL
3. db/ implementação dos backends de banco de dados, ou seja, implementa as interfaces necessárias pelo ETL e pela API em diferentes bancos de dados (PostgreSQL é utilizado em produção)
4. api/ a API web que serve os dados do projeto para o público

Escreva testes e rode os testes, use autoformatação e linter:

$ gofmt ./
$ golanglint-ci run ./...
$ go test --race ./...

Os testes requerem uma instância de cada banco de dados implementado. Atualmente eles precisam ser configurados em TEST_POSTGRES_URL e TEST_MONGODB_URL, como no exemplo em .env, e podem ser facilmente criados com o Docker Compose.

Vibe coding

Sobre contribuições e vibe coding:

• Você pode usar LLMs para ajudar a gerar código, desde que você leia e entenda o código que foi gerado.
• O código enviado deve ser algo que você testou, compreende e é capaz de discutir sobre a implementação, abstrações e testes sugeridos.
• Você deve seguir os critérios de transparência como na política da comunidade do Fedora; resumindo: se uma parte signifiativa da contribuição foi gerada por LLM e você não mudou quase nada, é obrigatório informar sobre o emprego dessas ferramentas.

Contribuições que não se encaixem nesses critérios serão simplesmente descartadas. Se você não se importou em escrever teu código, não espere que alguém vá se importar em lê-lo.