Verdantis (VITS - Visual Information Tracking System)

📋 Sobre o Projeto

O Verdantis é um sistema de rastreabilidade e visualização inteligente desenvolvido para transformar o agronegócio brasileiro. O Brasil perde mais de R$ 12 bilhões anuais em exportações por falta de rastreabilidade e certificação sustentável. Nossa solução une Oracle Database, Spring Boot e tecnologias modernas para oferecer transparência, sustentabilidade e valor agregado aos produtos agrícolas.

🎯 Problema que Resolve

Falta de rastreabilidade: Dificulta exportações e certificações sustentáveis
Gestão ineficiente: Desperdício de água, energia e insumos
Baixa digitalização: Pequenos produtores sem acesso a ferramentas modernas
Pressão internacional: Mercados EUA/UE rejeitam produtos sem comprovação de origem

💡 Solução

Uma plataforma integrada de rastreabilidade digital que conecta produtores, distribuidores e compradores, permitindo registro, visualização e certificação de cadeias produtivas agrícolas.

PDF da documentação completa em /documentation

⚠️ Tipos de Usuário

Para criar um usuário, você precisa referenciar um tipo existente. Consulte os tipos disponíveis via:

GET http://localhost:8080/user-types

Por que classe ao invés de enum?

Optamos por entidade JPA para permitir:

Adicionar novos tipos dinamicamente
Gerenciamento via banco de dados Oracle
Normalização e integridade referencial
Conselho do professor de Banco de Dados

👥 Equipe GreenCore

Integrantes e Responsabilidades

Nome	Responsabilidades
Caio Lucas Silva Gomes	Frontend (Next.js/React Native), Documentação, Design, Banco de Dados Oracle
João Gabriel Fuchs Grecco	Backend (Spring Boot), API .NET, Oracle APEX, Banco de Dados Oracle
Madjer Henrique Almeida Finamor	IoT, Cloud & DevOPS, QA

🚀 Como Rodar a Aplicação

Pré-requisitos

Java 17 ou superior
Maven 3.8+
Oracle Database (configurado e acessível)
Git

Configuração do Banco de Dados

Configure as credenciais do banco de dados no arquivo application.properties:

spring.datasource.url=jdbc:oracle:thin:@//oracle.fiap.com.br:1521/ORCL
spring.datasource.username=SEU_USUARIO
spring.datasource.password=SUA_SENHA

Passos para Execução

Opção 1: Usando Maven Wrapper (Recomendado)

# Clone o repositório
git clone https://github.com/joaoGFG/VitsAPI.git

# Entre no diretório do projeto
cd VitsAPI/vits-agrochain

# Execute a aplicação (Windows)
mvnw.cmd spring-boot:run

# Execute a aplicação (Linux/Mac)
./mvnw spring-boot:run

Opção 2: Usando Maven Instalado

# Clone o repositório
git clone https://github.com/joaoGFG/VitsAPI.git

# Entre no diretório do projeto
cd VitsAPI/vits-agrochain

# Compile o projeto
mvn clean install

# Execute a aplicação
mvn spring-boot:run

A aplicação estará disponível em: http://localhost:8080

Verificação da API

Acesse o endpoint de status:

GET http://localhost:8080/

Resposta esperada: "Verdantis API is running"

Credenciais do Banco de Dados para funcionamento presentes no PDF de documentação.

🏗️ Arquitetura e Diagramas

Diagrama de Entidade-Relacionamento (DER) (De zoom para melhor visibilidade)

![DER]

Diagrama de Classes UML

![Diagrama de Classes UML]

Arquitetura da Solução

┌─────────────────────────────────────────────────────┐
│                   FRONTEND LAYER                    │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────┐  │
│  │  Next.js +   │  │ React Native │  │   APEX    │  │
│  │    React     │  │    Mobile    │  │ Dashboards│  │
│  └──────────────┘  └──────────────┘  └───────────┘  │
└─────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────┐
│                   BACKEND (API)                     │
│  ┌──────────────────────────────────────────────┐   │
│  │              Spring Boot (Java 17)           │   │
│  │  • UserController (REST API)                 │   │
│  │  • Repository Pattern (JPA)                  │   │
│  │  • Validation & Exception Handling           │   │
│  └──────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────┐
│             DATA PERSISTENCE LAYER                  │
│  ┌──────────────────────────────────────────────┐   │
│  │              Oracle Database                 │   │
│  │  • VITS_ORC_USUARIO                          │   │
│  │  • VITS_ORC_TIPO_USUARIO                     │   │
│  │  • VITS_ORC_PAIS / ESTADO / MUNICIPIO        │   │
│  │  • Sequences & Constraints                   │   │
│  └──────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────┐
│              BLOCKCHAIN LAYER (Futuro)              │
│  ┌──────────────────────────────────────────────┐   │
│  │             Hyperledger Fabric               │   │
│  │  • Registro Imutável de Lotes                │   │
│  │  • Hash de Segurança                         │   │
│  └──────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘

📹 Vídeo de Apresentação

🎬 Assista ao vídeo do Pitch

O vídeo apresenta:

Proposta Tecnológica do Verdantis
Público-alvo da aplicação (produtores, distribuidores, compradores)
Problemas que a aplicação se propõe a solucionar
Demonstração das funcionalidades principais

📡 Documentação da API (Endpoints)

🔗 Swagger UI

A documentação interativa da API está disponível através do Swagger UI:

URL do Swagger: http://localhost:8080/swagger-ui/index.html

Ou acesse diretamente:

OpenAPI JSON: http://localhost:8080/v3/api-docs

Base URL

http://localhost:8080

Endpoints Disponíveis

1. Health Check

Verifica se a aplicação está em execução.

Request:

GET /

Response:

Status: 200 OK
Body: "Verdantis API is running"

2. Listar Tipos de Usuário

Retorna todos os tipos de usuário disponíveis no sistema.

Request:

GET /user-types

Response:

Status: 200 OK
Content-Type: application/json

[
  {
    "userTypeId": 1,
    "userDescription": "Produtor Rural"
  },
  {
    "userTypeId": 2,
    "userDescription": "Gestor"
  },
  {
    "userTypeId": 3,
    "userDescription": "Comprador"
  }
]

3. Buscar Tipo de Usuário por ID

Retorna um tipo de usuário específico.

Request:

GET /user-types/{id}

Response:

Status: 200 OK
Content-Type: application/json

{
  "userTypeId": 1,
  "userDescription": "Produtor Rural"
}

Erro (404):

{
  "timestamp": "2025-10-11T10:30:00",
  "status": 404,
  "error": "Not Found",
  "message": "UserType não encontrado com o id: 999"
}

4. Listar Usuários

Retorna todos os usuários cadastrados.

Request:

GET /users

Response:

Status: 200 OK
Content-Type: application/json

[
  {
    "userId": 1,
    "userName": "João Silva",
    "registrationDate": "2025-10-11T14:30:00",
    "userType": {
      "userTypeId": 1,
      "userDescription": "Produtor Rural"
    }
  }
]

5. Buscar Usuário por ID

Retorna um usuário específico.

Request:

GET /users/{id}

Response:

Status: 200 OK
Content-Type: application/json

{
  "userId": 1,
  "userName": "João Silva",
  "registrationDate": "2025-10-11T14:30:00",
  "userType": {
    "userTypeId": 1,
    "userDescription": "Produtor Rural"
  }
}

Erro (404):

{
  "timestamp": "2025-10-11T10:30:00",
  "status": 404,
  "error": "Not Found",
  "message": "Usuário não encontrado com o id: 999"
}

6. Criar Usuário

Cria um novo usuário no sistema (produtor, gestor ou comprador).

Request:

POST /users
Content-Type: application/json

{
  "userName": "João Silva",
  "registrationDate": "2025-10-11T14:30:00",
  "userType": {
    "userTypeId": 1
  }
}

Response:

Status: 201 CREATED
Content-Type: application/json

{
  "userId": 1,
  "userName": "João Silva",
  "registrationDate": "2025-10-11T14:30:00",
  "userType": {
    "userTypeId": 1,
    "userDescription": "Produtor Rural"
  }
}

Validações:

userName: Obrigatório, máximo 200 caracteres
registrationDate: Obrigatório (formato ISO-8601: YYYY-MM-DDTHH:mm:ss)
userType.userTypeId: Obrigatório, deve existir no banco de dados

🧪 Testes da Aplicação

Estratégia de Testes

O projeto foi testado utilizando as seguintes abordagens:

Testes de Integração: Verificação da integração com Oracle Database Testes de API: Documentação e testes realizados via Postman

Executando os Testes

![Get Users]

![GetByID Users]

![Post Users]

![Get User Types]

![GetByID User Types]

Coleção de Testes (Postman)

Coleção Postman

Endpoints (Swagger)

![Endpoints]

🛠️ Tecnologias Utilizadas

Categoria	Tecnologia	Função
Backend	Java	Linguagem de programação
Framework	Spring Boot	Framework para API REST
Persistência	Spring Data JPA	Camada de acesso a dados
Banco de Dados	Oracle Database	Armazenamento principal
Driver JDBC	ojdbc11	Conexão com Oracle
Validação	Hibernate Validator	Validação de dados
Build	Maven	Gerenciamento de dependências
Utilitários	Lombok	Redução de boilerplate code
Logging	SLF4J	Sistema de logs
Monitoramento	Spring Actuator	Health checks e métricas

🎯 Funcionalidades Core

Para Produtores:

✅ Cadastro rápido no sistema
✅ Registro digital de perfil
🔄 Registro de lotes agrícolas (em desenvolvimento)
🔄 Dashboards de produtividade (em desenvolvimento)

Para Gestores:

✅ Visualização de usuários cadastrados
🔄 Mapa interativo da produção (planejado)
🔄 Métricas de sustentabilidade (planejado)
🔄 Analytics de exportação (planejado)

Para Compradores:

🔄 Consulta de rastreabilidade via QR Code (planejado)
🔄 Validação de origem e sustentabilidade (planejado)
🔄 Marketplace integrado (planejado)

Legenda:

✅ Implementado
🔄 Em desenvolvimento
📋 Planejado

📄 Licença

Este projeto foi desenvolvido como parte do Challenge Oracle na FIAP.

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
.vscode		.vscode
documentation		documentation
vits-agrochain		vits-agrochain
README.md		README.md
exemplo1.png		exemplo1.png
exemplo2.png		exemplo2.png
exemplo3.png		exemplo3.png
exemplo4.png		exemplo4.png
exemplo5.png		exemplo5.png

joaoGFG/VitsAPI

Folders and files

Latest commit

History

Repository files navigation

Verdantis (VITS - Visual Information Tracking System)

📋 Sobre o Projeto

🎯 Problema que Resolve

💡 Solução

PDF da documentação completa em /documentation

⚠️ Tipos de Usuário

Por que classe ao invés de enum?

👥 Equipe GreenCore

Integrantes e Responsabilidades

🚀 Como Rodar a Aplicação

Pré-requisitos

Configuração do Banco de Dados

Passos para Execução

Opção 1: Usando Maven Wrapper (Recomendado)

Opção 2: Usando Maven Instalado

Verificação da API

Credenciais do Banco de Dados para funcionamento presentes no PDF de documentação.

🏗️ Arquitetura e Diagramas

Diagrama de Entidade-Relacionamento (DER) (De zoom para melhor visibilidade)

Diagrama de Classes UML

Arquitetura da Solução

📹 Vídeo de Apresentação

📡 Documentação da API (Endpoints)

🔗 Swagger UI

Base URL

Endpoints Disponíveis

1. Health Check

2. Listar Tipos de Usuário

3. Buscar Tipo de Usuário por ID

4. Listar Usuários

5. Buscar Usuário por ID

6. Criar Usuário

🧪 Testes da Aplicação

Estratégia de Testes

Executando os Testes

Coleção de Testes (Postman)

Endpoints (Swagger)

🛠️ Tecnologias Utilizadas

🎯 Funcionalidades Core

Para Produtores:

Para Gestores:

Para Compradores:

📄 Licença

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages