Skip to content

api-6-pixel/api-doc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sistema Inteligente de Planejamento e Monitoramento de Reflorestamento (SIPMR)

📄 Desafio Proposto

Este projeto visa desenvolver um sistema inteligente para planejamento e monitoramento de reflorestamento, utilizando uma base de dados de plantio para prever padrões de crescimento, sugerir melhores estratégias de recuperação ambiental e monitorar a evolução das áreas reflorestadas.

📚 Solução

Nosso sistema proporcionará um controle eficiente de dados agrícolas, abrangendo informações sobre plantio, espécies cultivadas, condições ambientais e lotes. Com uma interface intuitiva, os usuários poderão acompanhar esses dados em tempo real, garantindo maior organização e precisão no gerenciamento dos lotes.

O principal objetivo é permitir a projeção detalhada do crescimento da colheita mês a mês, facilitando o planejamento estratégico e a tomada de decisões. Além disso, o sistema oferecerá estimativas do custo projetado para o tratamento de cada lote e tipo de solo, auxiliando no controle financeiro e na otimização dos recursos disponíveis

📋 Backlog

Confira o backlog do produto:
Prioridade Feature Sprint Requisitos
Alta Dashboard Projeção de crescimento da colheita do lote informado 1 RF-6, RNF-1
Alta Dashboard Projeção de desempenho (R$) da espécie com base nas condições de cada lote 1 RF-6, RNF-1
Alta Dashboard Projeção de gastos com tratamento do solo 1 RF-6, RNF-1
Alta Tela de dashboards 1 RF-6, RNF-1, RNF-4, RNF-6
Alta Tela de atualização diária de plantios 1 RF-3, RNF-4, RNF-6
Alta Tela de cadastro de plantios 1 RF-2, RNF-4, RNF-6
Alta Autenticação de Usuário 2 RF-1, RNF-4, RNF-6, RNF-5
Alta Criação de Conta 2 RF-1, RNF-4, RNF-6, RF-7, RNF-2
Media Deleção de Conta 2 RF-8, RNF-4, RNF-6
Media Permissionamento da tela de Usuário 2 RF-1, RNF-4, RNF-6
Alta Notificação de vazamento de dados do usuários 2 RF-09, RNF-02
Baixa Visualização de Informações Pessoais 2 RF-5, RNF-2
Baixa Atualização de dados Pessoais 2 RNF-2, RF-5, RF-1
Media Cadastro de Lotes 3 RF-4, RNF-4, RNF-6
Media Visualização de Lotes 3 RF-4, RNF-4, RNF-6
Media Deleção de Lotes 3 RF-4, RNF-4, RNF-6
Baixa Portabilidade de Dados 3 RF-7, RNF-3, RNF-02

Requisitos Funcionais

RF-id Requisito Descrição
RF-01 Gerenciamento de Usuários O sistema deve permitir o gerenciamento de usuários, com dois tipos de acesso: Operador (gestão de dados) e Usuário (visualização de gráficos e dados do plantio). O objetivo é garantir a segurança e evitar acesso não autorizado aos dados sensíveis.
RF-02 Cadastro de Plantio O sistema deve permitir ao usuário inserir dados iniciais da colheita e criar vários lotes atrelados ao plantio. Cada lote deve incluir informações sobre espécie, quadrante, condição ambiental do dia e dados do solo.
RF-03 Atualização de Plantio Diário O sistema deve permitir que o usuário atualize todas as informações do plantio, exceto a espécie plantada. Além disso, o usuário poderá finalizar o plantio após a colheita, liberando o espaço para novos plantios.
RF-04 Gerenciamento de Lotes O sistema deve permitir ao usuário cadastrar, visualizar, deletar e gerenciar os lotes. Esses lotes podem ser utilizados nas funcionalidades do sistema, como projeção gráfica e atualização de dados.
RF-05 Disponibilização de Dados do Usuário O sistema deve permitir que os usuários visualizem e gerenciem seus próprios dados pessoais cadastrados, garantindo a conformidade com a LGPD (Lei Geral de Proteção de Dados).
RF-06 Projeção Gráfica dos Lotes O sistema deve oferecer um dashboard com projeções gráficas detalhadas para o usuário, incluindo: crescimento da colheita, desempenho financeiro (R$) da espécie, e gastos com tratamento do solo para cada lote.
RF-07 Autorização dos Termos de Uso O sistema deve solicitar autorização explícita do usuário em relação aos termos de uso
RF-08 Modificação ou Exclusão de Dados Pessoais O sistema deve permitir que o usuário solicite a modificação ou exclusão de seus dados pessoais a qualquer momento, proporcionando controle total sobre seus dados.
RF-09 Notificação de Vazamento de Dados O sistema deve enviar e-mails de notificação a todos os usuários em caso de vazamento de dados, informando quais dados foram expostos, conforme necessário pela LGPD.

Requisitos não funcionais

RNF-id Requisito Descrição
RNF-01 Aprendizado de Máquina O sistema deve utilizar modelos de aprendizado de máquina para prever dados importantes para o plantio, como crescimento, desempenho financeiro e necessidade de tratamentos do solo.
RNF-02 Transparência no Uso de Dados O sistema deve fornecer uma política de privacidade clara, informando como os dados dos usuários serão utilizados, por quanto tempo serão armazenados e quais dados específicos serão coletados, garantindo transparência e confiança.
RNF-03 Portabilidade de Dados O sistema deve permitir que os dados do usuário possam ser exportados e transferidos para outros sistemas, mantendo a segurança durante o processo de portabilidade, conforme exigido pela LGPD.
RNF-04 Compatibilidade com Resolução de Tela Desktop O sistema deve ser otimizado para telas de desktop, garantindo uma boa visualização e experiência de uso em dispositivos de tela maior.
RNF-05 Autenticação com JWT O sistema deve implementar autenticação e autorização utilizando tokens JWT (JSON Web Tokens), garantindo segurança nas interações do sistema e no acesso aos dados dos usuários.
RNF-06 Compatibilidade com Navegadores Principais O sistema deve ser compatível com os principais navegadores da web, como Edge, Chrome e Firefox, para garantir que todos os usuários possam acessar a plataforma de maneira funcional e sem problemas de compatibilidade.

DOR

• A história esta testável(com BDD definido).
• Prioridades da história esta alinhada com cliente.
• Quebra da história realizada e pontuada.
• Requisitos estão definidos na história.

DOD

• Testes foram realizados na branch de develop.
• Projetos afetados descritos no JIRA.
• Todas histórias movidas para CONCLUÍDO.

Dicionario de dados

tb_atualizacao
Nome Tipo Constraint Observação
atualizacao_indice_uv double precision NOT NULL Índice U.V. do solo em %
atualizacao_ph_solo double precision NOT NULL PH do solo em %
atualizacao_temperatura_ambiente double precision NOT NULL Temperatura ambiente em Celsius
atualizacao_temperatura_solo double precision NOT NULL Temperatura do solo em Celsius
atualizacao_umidade_ambiente double precision NOT NULL Umidade do ambiente
atualizacao_umidade_solo double precision NOT NULL Umidade o solo
atualizacao_id bigint PRIMARY KEY (IDENTITY) Identificador único
atualizacao_registro timestamp NOT NULL Data hora da criação do registro
plantacao_id bigint NOT NULL, FK Campo de relacionamento com a tabela de tb_plantacao
tb_cad_termo
Nome Tipo Constraint Observação
codigo bigint PRIMARY KEY (IDENTITY) Identificador único
data_criacao timestamp NULLABLE Data hora da criação do registro
descricao character varying(255) NULLABLE Descrição o termo
titulo character varying(255) NULLABLE Titulo do termo
versao character varying(255) NULLABLE Qual a versão eu o termo se encontra
tb_cad_termo_item
Nome Tipo Constraint Observação
obrigatorio boolean NOT NULL Obrigatoriedade deste termo
codigo bigint PRIMARY KEY (IDENTITY) Identificador único
termo_codigo bigint NOT NULL, FK Campo de relacionamento com a tabela de tb_cad_termo
descricao character varying(255) NULLABLE Descrição o item do termo
tb_cad_termo_item_aceite
Nome Tipo Constraint Observação
aceito boolean NOT NULL Se o termo foi aceito ou não
codigo bigint PRIMARY KEY (IDENTITY) Identificador único
termo_aceite_codigo bigint NOT NULL Campo de relacionamento com a tabela de tb_cad_termo_item_aceite_usuario_historico
termo_item_codigo bigint NOT NULL, FK Campo de relacionamento com a tabela de tb_cad_termo_item
tb_cad_termo_item_aceite_usuario_historico
Nome Tipo Constraint Observação
codigo bigint PRIMARY KEY (IDENTITY) Identificador único
data_aceite timestamp NULLABLE Data hora de aceite
data_alteracao timestamp NULLABLE Data hora de alteração do termo
termo_codigo bigint NOT NULL FK Campo de relacionamento com a tabela de tb_cad_termo
usuario_codigo bigint NOT NULL FK Campo de relacionamento com a tabela de tb_usuario
tb_fazenda
Nome Tipo Constraint Observação
fazenda_area double precision NOT NULL Area de plantio da fazenda
fazenda_criacao timestamp NOT NULL Data hora de criação do registro
fazenda_id bigint PRIMARY KEY (IDENTITY) Identificador único
fazenda_localizacao character varying(255) NOT NULL Localização da fazenda
fazenda_nome character varying(255) NOT NULL Nome da fazenda
tb_plantacao
Nome Tipo Constraint Observação
plantacao_area double precision NOT NULL Area de plantação
plantacao_custo double precision NOT NULL Custo estimado
plantacao_data timestamp NOT NULL Data hora da criação do registro
plantacao_id bigint PRIMARY KEY (IDENTITY) Identificador único
usuario_id bigint NOT NULL, FK Campo de relacionamento com a tabela de tb_usuario
plantacao_especie character varying(255) NOT NULL Espécie plantada
plantacao_fazenda character varying(255) NOT NULL Nome do lote
tb_usuario
Nome Tipo Constraint Observação
usuario_dt_criacao timestamp NOT NULL Data hora da criação do registro
usuario_id bigint PRIMARY KEY (IDENTITY) Identificador único
usuario_documento character varying(255) NOT NULL CPF/CNPJ (criptografada)
usuario_email character varying(255) NOT NULL Email do usuário
usuario_funcao character varying(255) NOT NULL Funaro do usuário no sistema (criptografada)
usuario_nome character varying(255) NOT NULL Nome do usuário (criptografada)
usuario_senha character varying(255) NOT NULL Senha o usuário (criptografada)

Sprint 1

Dashboard de Projeções

Requisitos:

  • Projeção de crescimento da colheita do lote informado (mensal)
  • Projeção de desempenho (R$) da espécie com base nas condições de cada lote
  • Projeção de gastos com tratamento do solo
Cadastro de Plantio

Requisitos:

  • Cada lote deve conter:
    • Espécie plantada
    • Quadrante
    • Condição ambiental do dia
    • Dados relacionados ao solo
Atualização Diária de Plantio

Requisitos:

  • Permitir atualização de todas as informações, exceto a espécie plantada
  • Possibilitar finalização do plantio após a colheita
  • Liberar o quadrante para novo plantio após colheita

Sprint 2

[PX-41] Autenticação de Usuários

Requisitos:

  • Gerenciamento de Usuário
  • Compatibilidade com Resolução de Tela Desktop
  • Autenticação com JWT
  • Compatibilidade com Navegadores Principais
[PX-42] Cadastro de Usuário

Requisitos:

  • Gerenciamento de Usuários
  • Aceite dos termos de uso
  • Transparência no Uso de Dados
  • Compatibilidade com Resolução de Tela Desktop
  • Compatibilidade com Navegadores Principais
[PX-47] Visualização de Dados Pessoais

Requisitos:

  • Gerenciamento de Usuários
  • Transparência no Uso de Dados
  • Compatibilidade com Resolução de Tela Desktop
  • Compatibilidade com Navegadores Principais
[PX-43] Deleção de Conta

Requisitos:

  • Gerenciamento de Usuários
  • Modificação ou Exclusão de Dados Pessoais
  • Compatibilidade com Resolução de Tela Desktop
  • Compatibilidade com Navegadores Principais
[PX-48] Atualização de Dados Pessoais

Requisitos:

  • Gerenciamento de Usuários
  • Modificação ou Exclusão de Dados Pessoais
  • Compatibilidade com Resolução de Tela Desktop
  • Compatibilidade com Navegadores Principais
[PX-46] Notificação de Vazamento de Dados

Requisitos:

  • Permissionamento de Usuário
  • Transparência no Uso de Dados

Sprint 3

[PX-110] Uso Administrativo do Sistema

Requisitos:

  • Permissionamento do sistema
  • Visibilidade de Lotes do Usuário
  • Compatibilidade com Navegadores Principais
  • Compatibilidade com Resolução Desktop
[PX-111] Portabilidade de Dados

Requisitos:

  • Portabilidade dos dados
[PX-113] Como Melhorar a Sua Colheita

Requisitos:

  • Projeção gráfica dos lotes
  • Melhoria de Lotes do Usuário
[PX-145] Extração de Dados de Lote do Usuário

Requisitos:

  • Extração de dados do plantio via Excel
  • Disponibilização dos dados offline
  • Compatibilidade com Navegadores Principais
  • Compatibilidade com Resolução Desktop
[PX-146] Extração de Dados de Projeção do Usuário

Requisitos:

  • Extração de dados de previsibilidade do lote via Excel

📆 Entregas

Sprint Periodo Status
1 10/03/25 - 30/03/25
2 07/04/25 - 27/04/25
3 05/05/25 - 25/05/25

👥 Equipe de desenvolvimento

Função Nome
Product Owner Matheus Cruz Fiebig
Scrum Master Luciano do Nascimento Pamplona da Silva
Dev Alisson dos Santos Pereira
Dev Beatrice Lopes Correa
Dev Danillo Wesley da Costa Silva
Dev Wagner de Deus da Silva Júnior

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •