AgroBase

Quem somos & Tecnologia e Arquitetura

Este projeto é um website que tem como objetivo exibir informações e dados sobre o agronegócio brasileiro, incluindo informações sobre plantio e cultivo da produção agrícola e pecuária.

QUEM SOMOS

O AgroBase é uma plataforma que tem como objetivo é criar um dashboard com dados relacionados ao agronegócio, a fim de fornecer informações precisas e atualizadas para tomada de decisões estratégicas pelos gestores do setor do agronégocio.

TECNOLOGIAS E ARQUITETURA

A plataforma utilizará tecnologias web como HTML, SCSS e TypeScript para o desenvolvimento de interfaces e aplicações. A arquitetura em camadas (Layered Architecture) será utilizada no sistema que será dividido em camadas distintas, onde cada camada possui responsabilidades específicas. que incluem a interface do usuário, lógica de negócio e acesso a dados.
Para o desenvolvimento do frontend foi utilizando Angular uma framework open-source liderado pela equipe da Google.

Backend

Para o Backend foi desenvolvido uma API em Python utilizando a biblioteca FastAPI, o principal objetivo da API é requisitar o banco de dados MongoDB que está hospedado em serviço de nuvem oferecido pela própria MongoDB, o Atlas.

O banco de dados foi populado utilizando scrips em Python, que são responsáveis por realizar diversas requisições para a API do IBGE. Após as requisições os dados passam por um pequena manipulação e são inseridos no banco de dados.

CÓDIGO DE CONDUTA

O Código de conduta do nosso projeto é fundamental para mantermos um ambiente colaborativo, inclusivo e respeitoso. Nele, estabelecemos as diretrizes que todos os participantes devem seguir para garantir uma comunidade saudável e livre de qualquer comportamento inadequado visando criar um ambiente inclusivo, acolhedor e respeitoso para todas as pessoas envolvidas no desenvolvimento deste projeto.

Como Contribuir

Antes de começar, por favor, leia este documento para entender como colaborar de forma efetiva. Manual do Contribuidor.

Como contribuir

1. Crie um fork do projeto;
2. Clone o fork criado em sua máquina local;
3. Crie uma branch para sua contribuição: git checkout -b minha-contribuicao;
4. Realize as alterações em sua branch;
5. Teste as alterações localmente;
6. Faça um commit com uma mensagem clara e descritiva: git commit -m "Adiciona funcionalidade X";
7. Faça o push da branch para o seu fork: git push origin minha-contribuicao;
8. Abra um pull request para a branch master do repositório original e aguarde a revisão da sua contribuição. Certifique-se de que seu pull request siga as seguintes políticas:;
8.1 Cada pull request deve conter apenas uma funcionalidade ou correção de bug.
8.2 A mensagem de commit deve ser descritiva e objetiva.
8.3 O pull request deve ter pelo menos um revisor antes de ser mesclado.

Regras de contribuição

Para manter a qualidade do projeto, pedimos que você siga as seguintes regras ao contribuir:
1. Escreva código claro e bem documentado.
2. Siga as boas práticas de programação recomendadas para a linguagem e/ou framework utilizado.
3. Teste o código antes de enviar a contribuição.
4. Cada pull request deve conter apenas uma funcionalidade ou correção de bug.

Relatórios de bugs & problemas

Se você encontrar um bug ou tiver algum problema com o projeto, por favor, abra uma issue detalhando o problema encontrado. Nós ficaremos felizes em ajudar e solucionar o problema.

Abrir Issue

Desenvolvedores