Skip to content

PorygonAPI/Porygon3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

API 4º SEMESTRE

Sumário

Integrantes da Equipe Projeto API Produto Tecnologias Utilizadas Configurar o Ambiente Wireframe do Produto Requisitos Backlog do Produto Backlog das Sprints

👥 Integrantes da Equipe

Integrantes

Integrantes Redes Sociais
Renato Mendes - Product Owner
Ruth Mira - Scrum Master
Alexandre Jonas - Developer
Carla Daiane - Developer
João Pedro - Developer
João Arruda - Developer
Pablo Henrique - Developer
Vitor Morais - Developer

Arquivo de Contribuição do Projeto

📌 Projeto API

📝 Tema

Manipulação de dados armazenados em banco relacional com visualização em tela e / ou acesso por meio de API

🎯 Objetivos

  • API Application Programming Interface (Interface de Programação de Aplicação)
  • Criação de APIs RESTful
  • Injeção de Dependências e Arquitetura Modular
  • Gerenciamento de Banco de Dados com JPA/Hibernate
  • Segurança com Spring Security
  • Aprofundamento no conhecimento de banco de dados relacional por meio de tarefas de administração
  • Programação de backend em banco de dados utilizando PL/SQL do Oracle
  • Componentização e Reutilização de Código
  • Gerenciamento de Estado com Vue
  • Manipulação e Visualização de Dados em Tempo Real
  • Diretivas Personalizadas e Renderização Condicional:

🔍 Tríade da API

  • Laboratório de Desenvolvimento em BD IV
  • Programação Avançada em BD
  • Administração de BD

⏳ Prazos

  • 24/02 a 28/02 - Kick-off
  • 10/03 a 30/03 - Primeira Sprint
  • 31/03 a 04/04- Sprint Review / Planning
  • 07/04 a 27/04 - Segunda Sprint
  • 28/04 a 02/05 - Sprint Review / Planning
  • 05/05 a 25/05 - Terceira Sprint
  • 26/05 a 30/05 - Sprint Review
  • 17/06 - Feira de Soluções e Apresentação Final API

🛠️ Produto

💻 Tecnologias Utilizadas

  • Java 22
  • Spring Boot 3.3.3
    • Spring Data JPA
    • Spring Web
    • Spring DevTools
  • MySQL
  • Docker
  • Vue

⚙️ Configurar o Ambiente

Para instalar e configurar os ambientes e demais informações importantes para a utilização do sistema, consulte o Arquivo de Teste.

📐 Wireframe do Produto

Wireframe do produto disponível pelo Figma

🎲 Banco de Dados

Modelo Físico

✅ Requisitos

Requisitos Funcionais:

Código Requisito Funcional
R1 Três tipos de usuários: administrador, analista e consultor
R2 Analista irá visualizar informações da área bem como aprovar ou não a área cadastrada no sistema. Caso a área não seja aprovada, editá-la e atualizá-la no banco
R3 Consultor terá acesso aos dashboards, mapa e poderá fazer o cadastro de área no sistema
R4 Administrador poderá realizar as mesmas funções que o Consultor e o Analista, além do cadastro de usuários
R5 Cadastro de geometria via upload de arquivo .geojson
R6 Para o cadastro deve ser informado nome da fazenda, cultura (exemplo: soja, milho...), produtividade por ano, área, tipo de solo, cidade e estado
R7 Dashboards deverão apresentar informações a partir de filtros dos dados e destacar no mapa as áreas resultantes

Requisitos Não Funcionais:

Código Requisito Não Funcional
RN1 Ferramenta de desenho para edição de geometria

🗃️ Backlog do Produto

Ranking Prioridade User Story Sprint Requisitos
1 Média Como administrador, preciso cadastrar, editar e excluir usuários (analistas e consultores) para que possam acessar e operar o sistema com determinadas permissões, e eu terei acesso a todas as funcionalidades 1 R1 e R4
2.1 Alta Como consultor, eu quero poder cadastrar áreas agrícolas para que, posteriormente, os analistas possam verificar e corrigir os vetores das áreas 1 R3, R4, R5 e R6
2.2 Alta Como analista, eu preciso visualizar os mapas de classificação automática (marcação das ervas daninhas feita por IA) dos talhões que atribuir a mim, para posteriormente editar e/ou aprovar de acordo com a minha análise 2 R2, R4 e RN1
3.1 Média Como analista, eu preciso comparar imagens de diferentes momentos (antes e depois de ajustes) para auxiliar na minha edição e aprovação, garantindo que os dados estão corretos 2 R2, R4 e RN1
3.2 Média Como analista, eu preciso aprovar mapas de classificação automática que estiverem de acordo e editar as marcações que não condizem com a realidade antes de aprovar 2 R2, R4 e RN1
4.1 Média Como consultor, eu preciso que o tempo gasto na aprovação dos mapas de classificação seja visível e armazenado, desde o momento em que o registro é cadastrado e disponibilizado para a análise até o momento de sua aprovação 3 R4 e R7
4.2 Média Como consultor, quero acessar dashboards para acompanhar as atividades dos analistas, progresso de análise e cadastramento das áreas 3 R4 e R7
4.3 Média Como consultor, quero acessar dashboards para métricas de produtividade das safras. 3 R4 e R7
5 Baixa Como administrador, preciso que a aplicação seja segura e todos os dados sensíveis estejam protegidos, tendo as permissões e acessos apenas quem eu configurar no cadastro 3 R2, R3, R4 e R7

📆 Backlog das Sprints

SPRINT 1

Vídeo da aplicação e suas funcionalidades:

Assista pelo Youtube ou pelo seu Reprodutor de Vídeos

1 - User Story - Cadastro - R1 e R4

Como administrador, preciso cadastrar novos usuários (analistas e consultores) para que possam acessar e operar o sistema com determinadas permissões.

Critérios de Aceite:

  • O Administrador consegue cadastrar, editar e excluir usuários.
  • Os dados para cadastro são nome completo, e-mail, senha e cargo. O login será feito por meio de e-mail e senha.
  • Usuários autenticados com diferentes permissões só acessam funções específicas e o Administrador possuirá acesso a todas as funções.

2.1 - Cadastro de Áreas Agrícolas - R3, R4, R5 e R6

Como consultor, eu quero poder cadastrar áreas agrícolas para que, posteriormente, os analistas possam verificar e corrigir os vetores das áreas.

Critérios de Aceite:

  • O Consultor consegue cadastrar novas áreas com informações completas e fazer upload de .geojson. (Validar após recebimento dos arquivos)
  • O cadastro de áreas precisa das seguintes informações: nome da fazenda, cultura, produtividade por ano, área, tipo de solo, cidade e estado.
  • O sistema salva as alterações e atualiza o banco de dados corretamente.

Visualizar o Wireframe da Sprint 1

Visualizar o Modelo Físico da Sprint 1

SPRINT 2

Vídeo da aplicação e suas funcionalidades:

2.2 - Visualização e Edição - R2, R4 e RN1

Como analista, eu preciso visualizar os mapas de classificação automática (marcação das ervas daninhas feita por IA) dos talhões que atribuir a mim, para posteriormente editar e/ou aprovar de acordo com a minha análise.

Critérios de Aceite:

  • O Analista visualiza os talhões cadastrados e pode atribuir talhões a si para análise, edição e aprovação.
  • A visualização dos talhões acompanha: nome da fazenda, cultura, produtividade por ano, ano, área, tipo de solo, cidade e estado.
  • O Analista visualiza o talhão atribuído junto ao mapa de classificação automática sobreposto, com as marcações de ervas daninhas detectadas por IA.

3.1 - Edição e Análise de Imagens - R2, R4 e RN1

Como analista, eu preciso comparar imagens de diferentes momentos (antes e depois de ajustes) para auxiliar na minha edição e aprovação, garantindo que os dados estão corretos.

Critérios de Aceite:

  • O Analista consegue visualizar e comparar imagens antigas e novas de uma área, comparando o mapa de classificação automática do Consultor e a versão editada pelo Analista.
  • Dados corrigidos são armazenados no banco e ficam disponíveis tanto quando salvos para continuar a edição quanto quando aprovados.

3.2 - Edição e Análise de Imagens - R2, R4 e RN1

Como analista, eu preciso aprovar mapas de classificação automática que estiverem de acordo e editar as marcações que não condizem com a realidade antes de aprovar.

Critérios de Aceite:

  • O analista consegue visualizar e comparar imagens antigas e novas de uma área, comparando o mapa de classificação automática do Consultor e a versão editada pelo Analista no momento da edição.
  • Dados corrigidos são armazenados no banco ao serem salvos, mesmo antes da aprovação, para permitir continuidade da edição posteriormente.

Visualizar o Wireframe da Sprint 2 para a entrega das funcionalidades do Analista e do Consultor

Visualizar o Modelo Físico da Sprint 2

SPRINT 3

Vídeo da aplicação e suas funcionalidades:

4.1 - Dashboards e Relatórios - R4 e R7

Como consultor, eu preciso que o tempo gasto na aprovação dos mapas de classificação seja visível e armazenado, desde o momento em que o registro é cadastrado e disponibilizado para a análise até o momento de sua aprovação.

Critérios de Aceite:

  • O tempo gasto nas edições dos mapas precisa ser armazenado para a visualização do próprio analista e servir de parâmetro no Dashboard.
  • O sistema salva as alterações e atualiza o banco de dados corretamente, mantendo o mapa inicial para comparação.
  • Quando o mapa é salvo para terminar a edição posteriormente, não pode ser pausada a contagem. Ela só acaba quando o mapa é aprovado.

4.2 - Dashboards e Relatórios - R4 e R7

Como consultor, quero acessar dashboards para acompanhar as atividades dos analistas, progresso de análise e cadastramento das áreas.

Critérios de Aceite:

  • O consultor e o administrador visualizam o progresso das análises em gráficos interativos.
  • Filtros permitem visualizar dados específicos (áreas analisadas, status de aprovação, prazos de entrega).
  • Os dashboards são atualizados em tempo real com base nas atividades dos analistas.

4.3 - Dashboards e Relatórios - R4 e R7

Como consultor, quero acessar dashboards para métricas de produtividade das safras.

Critérios de Aceite:

  • O consultor e o administrador visualizam o progresso das análises em gráficos interativos.
  • Filtros permitem visualizar dados específicos (produtividade por cultura, cultura mais produtiva, produtividade média por estado e estado mais produtivo).
  • Os dashboards são atualizados em tempo real com base nas atividades dos analistas.

5 - Integração e Segurança - R2, R3, R4 e R7

Como administrador, preciso que a aplicação seja segura e todos os dados sensíveis estejam protegidos, tendo as permissões e acessos apenas quem eu configurar no cadastro.

Critérios de Aceite:

  • Apenas usuários autenticados acessam a plataforma.
  • O sistema mantém logs de atividades (login, alterações de dados, aprovações).
  • Dados sensíveis estão protegidos conforme os padrões de segurança.
  • Implementar autenticação e autorização com Spring Security.
  • Adicionar controle de sessões de usuários e logs de atividades.

Visualizar o Wireframe da Sprint 3 para a entrega das funcionalidades Consultor

Visualizar o Modelo Físico da Sprint 3

Acesse a documentação de Contribuição do Projeto no arquivo CONTRIBUTING

🚀 Desempenho da Equipe | Burndown

SPRINT 1 |

Nesta sprint, organizamos os prazos em três ciclos de seis dias. As tarefas foram classificadas por prioridade: alta, média e baixa.

Burndown - Sprint 1

Última Atualização: 30/03/2025

SPRINT 2 |

Nesta sprint, organizamos os prazos em três ciclos de sete dias. As tarefas foram classificadas por prioridade: alta, média e baixa.


Burndown - Sprint 2

Última Atualização: 01/10/2024 -->

SPRINT 3 |

Nesta sprint, organizamos os prazos em três ciclos de sete dias. As tarefas foram classificadas por prioridade: alta, média e baixa.


Burndown - Sprint 3

Última Atualização: 05/05/2025 -->

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors