O AgroTerra é um projeto de software livre para apoiar a gestão de produtores, propriedades, parceiros e trabalhadores do meio rural.
Important
O projeto está em fase de planejamento (0.1.0-dev) e ainda não possui uma
versão pronta para uso em produção.
O objetivo é reunir informações operacionais, produtivas e financeiras em uma plataforma acessível, auditável e adequada à realidade rural brasileira.
O escopo planejado inclui:
- cadastro de imóveis rurais, agricultores, culturas, implementos e sindicatos;
- acompanhamento de rotação de culturas, insumos, mão de obra e maquinário;
- assistência técnica e extensão rural (ATER);
- controle de notas de produtor rural;
- custos, faturamento, lucro ou prejuízo por cultura e período;
- contratos, relatórios de áreas e documentos de apoio ao crédito rural.
Documentos produzidos pelo sistema deverão ser revisados por profissionais habilitados antes de qualquer uso jurídico, ambiental, contábil ou bancário.
Esta etapa organiza as fundações do repositório. A arquitetura, a stack e o modelo de dados ainda serão definidos por meio de decisões registradas no projeto.
Consulte o plano de evolução para conhecer as próximas entregas.
| Documento | Finalidade |
|---|---|
| Guia de documentação | Índice e regras para manter a documentação |
| Como contribuir | Fluxo de branches, commits e revisões |
| Versionamento | Regras para versões, tags e lançamentos |
| Idiomas e localização | Convenções de tradução e dados regionais |
| Glossário | Vocabulário inicial do domínio rural |
| Histórico de mudanças | Alterações relevantes por versão |
| Suporte | Onde pedir ajuda |
| Segurança | Como comunicar vulnerabilidades |
Antes de implementar uma funcionalidade grande, abra uma issue para alinhar o problema, as regras de negócio e os critérios de aceite. Para preparar o ambiente de contribuição:
git clone <url-do-repositorio>
cd agroterra
git config commit.template .gitmessage
./scripts/check-repository.shAinda não há dependências de aplicação para instalar. As instruções de execução serão acrescentadas quando a stack for escolhida.
O projeto usa Versionamento Semântico. Durante
o desenvolvimento inicial, versões 0.x.y podem evoluir rapidamente. A versão
atual fica no arquivo VERSION, e cada lançamento recebe uma tag Git
anotada no formato vX.Y.Z.
Distribuído sob a licença GNU GPL v3.0 (GPL-3.0-only). Consulte o
arquivo da licença antes de distribuir versões modificadas.