Skip to content

Jbatist71/Protocolo

Repository files navigation

PMTA - Protocolo de Monitoramento da Transição Agroecológica

Um aplicativo web profissional para diagnóstico e acompanhamento de propriedades familiares em transição para a agroecologia.

🌱 Sobre o Projeto

O PMTA é uma ferramenta desenvolvida para auxiliar técnicos de extensão rural e agricultores familiares a diagnosticar, planejar e monitorar o processo de transição de um modelo de produção convencional para a Agroecologia.

O protocolo avalia a propriedade através de 17 indicadores distribuídos em 6 dimensões do agroecossistema:

  • A. Manejo do Solo e da Fertilidade (4 indicadores)
  • B. Agrobiodiversidade (3 indicadores)
  • C. Manejo de Pragas e Doenças (2 indicadores)
  • D. Recursos Hídricos e Energia (2 indicadores)
  • E. Autonomia e Dependência Externa (2 indicadores)
  • F. Social, Comercialização e Gestão (4 indicadores)

🎯 Funcionalidades

Formulário Interativo - Interface amigável com navegação por abas ✅ Cálculo Automático - Pontuação em tempo real com identificação de fase ✅ Relatório Técnico - Análise automática com gráficos e recomendações ✅ Gráfico Radar - Visualização do desempenho por dimensão ✅ Plano de Ação - Definição de ações, responsáveis e prazos ✅ Galeria de Fotos - Upload e gerenciamento de fotos da propriedade ✅ Exportação PDF - Download do laudo técnico formatado

📋 Fases de Transição Identificadas

Pontuação Fase Descrição
0-15 Convencional Alta dependência de insumos externos
16-35 Fase 1: Racionalização Redução e otimização de insumos
36-55 Fase 2: Substituição Substituição por insumos orgânicos
56-75 Fase 3: Redesenho Redesenho do agroecossistema
76-85 Fase 4: Consolidação Sistema resiliente e autônomo

🚀 Como Usar

Instalação

  1. Clone o repositório
git clone https://github.com/seu-usuario/pmta-app.git
cd pmta-app
  1. Instale as dependências
pnpm install
  1. Inicie o servidor de desenvolvimento
pnpm dev
  1. Acesse a aplicação Abra seu navegador e acesse: http://localhost:3000

Preenchimento do Formulário

  1. Informações Gerais - Preencha os dados da propriedade e da vistoria
  2. Avaliação - Atribua notas de 0 a 5 para cada indicador com base na observação técnica
  3. Laudo - Visualize automaticamente o diagnóstico, pontos fortes e desafios
  4. Ações - Defina recomendações técnicas e plano de ação conjunto
  5. Fotos - Adicione fotos da propriedade para documentação

Exportação do Laudo

Clique no botão "Exportar PDF" no header para baixar o laudo técnico completo em PDF, pronto para impressão ou compartilhamento.

🛠️ Stack Tecnológico

  • Frontend: React 19 + TypeScript
  • Styling: Tailwind CSS 4 + shadcn/ui
  • Gráficos: Recharts (gráfico radar)
  • PDF: jsPDF + html2canvas
  • Build: Vite
  • Gerenciamento de Estado: React Context API

📦 Estrutura do Projeto

pmta-app/
├── client/
│   ├── public/              # Arquivos estáticos
│   ├── src/
│   │   ├── components/      # Componentes React
│   │   ├── contexts/        # Context API (FormContext)
│   │   ├── hooks/           # Custom hooks
│   │   ├── pages/           # Páginas da aplicação
│   │   ├── App.tsx          # Componente raiz
│   │   ├── main.tsx         # Entry point
│   │   └── index.css        # Estilos globais
│   └── index.html           # HTML template
├── package.json             # Dependências
├── tsconfig.json            # Configuração TypeScript
├── vite.config.ts           # Configuração Vite
└── README.md                # Este arquivo

🔧 Desenvolvimento

Adicionar um novo indicador

  1. Edite o arquivo client/src/pages/Home.tsx
  2. Adicione o indicador no objeto INDICATORS_DATA
  3. O cálculo será automático

Personalizar cores

Edite o arquivo client/src/index.css para alterar a paleta de cores verde agroecológica.

Modificar fases de transição

Edite o arquivo client/src/hooks/useAgroecologyAnalysis.ts para alterar os ranges e descrições das fases.

📱 Responsividade

A aplicação é totalmente responsiva e funciona em:

  • Desktop (1920px+)
  • Tablet (768px - 1024px)
  • Mobile (até 768px)

🔐 Privacidade

Todos os dados são armazenados localmente no navegador do usuário. Nenhuma informação é enviada para servidores externos.

📄 Licença

Este projeto está disponível sob licença MIT. Veja o arquivo LICENSE para mais detalhes.

👥 Contribuições

Contribuições são bem-vindas! Para contribuir:

  1. Faça um fork do projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📧 Suporte

Para dúvidas ou sugestões sobre o protocolo PMTA, entre em contato com:

Para questões técnicas sobre a aplicação, abra uma issue no repositório GitHub.

🙏 Agradecimentos

Este projeto foi desenvolvido com base no Protocolo de Monitoramento da Transição Agroecológica (PMTA), criado por João Batista para auxiliar técnicos de extensão rural e agricultores familiares na transição para a agroecologia.


Desenvolvido com ❤️ para a agroecologia

About

Monitoramento Transição Agroecológica

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published