MottuFlow - Sistema de Gerenciamento de Frotas

🚀 Visão Geral

MottuFlow é uma aplicação híbrida desenvolvida em Java para gerenciamento inteligente de frotas de motocicletas. O sistema oferece uma solução completa com interface web administrativa e API REST robusta, deployada na nuvem Microsoft Azure com pipeline CI/CD totalmente automatizada.

Características Principais

🔧 API REST Completa - Integração para aplicações mobile e front-ends
🌐 Interface Web Administrativa - Dashboard com Thymeleaf
🔐 Autenticação JWT - Segurança robusta para APIs
☁️ Cloud-Ready - Deploy automatizado no Azure
🐳 Containerizado - Aplicação totalmente dockerizada
⚙️ CI/CD Automático - Pipeline de integração e deploy contínuo

✨ Funcionalidades

O sistema oferece gerenciamento completo de:

👥 Funcionários - Cadastro e gerenciamento de colaboradores
🏢 Pátios - Controle de localidades e estacionamentos
🏍️ Motos - Gestão completa da frota de motocicletas
📹 Câmeras - Sistema de monitoramento integrado
🏷️ ArUco Tags - Tags de identificação para rastreamento
📊 Status das Motos - Monitoramento em tempo real
📍 Localidades - Gestão geográfica das operações

🏗️ Arquitetura

graph TB
    DEV["👨‍💻 Desenvolvedor"]
    
    subgraph GitHub["📦 SOURCE CONTROL"]
        REPO["GitHub Repository<br/>(Código-fonte)"]
        MASTER["🔴 Branch Main"]
    end
    
    subgraph AzureDevOps["🔷 AZURE DEVOPS"]
        VARIABLES["🔐 Pipeline Variables<br/>(Protected)"]
        
        subgraph CI["🔨 CI PIPELINE"]
            BancoDados["1️⃣ Stage: BancoDados<br/>(MySQL em ACI)"]
            BuildAndTest["2️⃣ Stage: BuildAndTest<br/>(Maven + Testes)"]
            BuildDocker["3️⃣ Stage: BuildDocker<br/>(Docker Build + Push)"]
        end
        
        subgraph CD["🚀 CD PIPELINE"]
            Deploy["4️⃣ Stage: Deploy<br/>(Deploy em ACI)"]
        end
    end
    
    subgraph Azure["☁️ AZURE CLOUD"]
        DB["🗄️ MySQL Database<br/>(ACI)"]
        APP["🔷 Aplicação Java<br/>(ACI)"]
        DOCKERHUB["📦 Docker Hub<br/>(Images)"]
    end
    
    subgraph Application["🎯 APPLICATION"]
        SPRING["⚙️ Spring Boot 3.4.5<br/>(Java 21)"]
        SECURITY["🔒 Spring Security<br/>(JWT Auth)"]
        FLYWAY["🗂️ Flyway<br/>(Migrations)"]
        THYMELEAF["🖼️ Thymeleaf<br/>(Templates)"]
        WEB["🌐 Web Interface"]
        APIREST["🔌 API REST"]
    end
    
    FUNCIONARIO["👷 Funcionário<br/>(App Mobile)"]
    GERENTE["👔 Gerente<br/>(Web)"]
    
    %% Fluxo Principal
    DEV -->|"git push"| REPO
    REPO --> MASTER
    
    %% CI Flow
    BancoDados --> BuildAndTest
    BuildAndTest --> BuildDocker
    BuildDocker --> DOCKERHUB
    
    %% CD Flow
    BuildDocker --> Deploy
    VARIABLES -.->|"credentials"| Deploy
    DOCKERHUB -->|"pull image"| APP
    
    %% Database
    BancoDados -.->|"creates"| DB
    Deploy -->|"configures"| DB
    
    %% Trigger
    MASTER -->|"trigger automático"| BancoDados
    
    %% Application Stack
    APP --> SPRING
    SPRING --> SECURITY
    SPRING --> FLYWAY
    SPRING --> THYMELEAF
    SPRING --> APIREST
    FLYWAY --> DB
    SPRING --> DB
    THYMELEAF --> WEB
    
    %% Personas acessando a aplicação
    APIREST -->|"acessa via mobile"| FUNCIONARIO
    WEB -->|"acessa via browser"| GERENTE
    
    %% Estilos
    classDef github fill:#f0f0f0,stroke:#333,stroke-width:2px,color:#000
    classDef ci fill:#ffe0b2,stroke:#ef6c00,stroke-width:2px,color:#000
    classDef cd fill:#ffccbc,stroke:#d84315,stroke-width:2px,color:#000
    classDef azure fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px,color:#000
    classDef app fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000
    classDef web fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px,color:#000
    
    class REPO,MASTER github
    class BancoDados,BuildAndTest,BuildDocker ci
    class Deploy cd
    class VARIABLES,AzureDevOps,DB,APP,DOCKERHUB azure
    class SPRING,SECURITY,FLYWAY app
    class THYMELEAF,WEB web

🛠️ Tecnologias

Backend

Java 21 - Linguagem principal
Spring Boot 3.4.5 - Framework de aplicação
Spring Security - Segurança e autenticação
JWT - Tokens de autenticação
Flyway - Migração de banco de dados

Frontend

Thymeleaf - Template engine para interface web

Banco de Dados

MySQL 8.0 - Banco de dados relacional

Infraestrutura

Docker - Containerização
Microsoft Azure - Cloud provider
- Azure Container Instances (ACI)
- Azure DevOps - Pipeline CI/CD

🚀 Pipeline CI/CD

A aplicação utiliza Azure DevOps para automação completa de Integração Contínua (CI) e Deployment Contínuo (CD).

📋 Como Funciona

A pipeline executa automaticamente sempre que você faz git push na branch main:

┌─────────────────────────┐
│   Você faz PUSH         │
│   git push origin main  │
└────────┬────────────────┘
         │
         ▼
╔══════════════════════════════════════════════════╗
║         STAGE 1: BancoDados (CI)                 ║
║  ✅ Cria Container MySQL em Azure                ║
║  ✅ Aguarda estar 100% pronto                    ║
║  ✅ Obtém IP para próximas stages                ║
╚────────┬─────────────────────────────────────────╝
         │
         ▼
╔══════════════════════════════════════════════════╗
║      STAGE 2: BuildAndTest (CI)                  ║
║  ✅ Instala Java 21                              ║
║  ✅ Executa: mvn clean package                   ║
║  ✅ Executa TESTES AUTOMÁTICOS com BD real       ║
║  ✅ Publica JAR no Azure DevOps                  ║
╚────────┬─────────────────────────────────────────╝
         │
         ▼
╔════════════════════════════════════════════╗
║     STAGE 3: BuildDocker (CI)              ║
║  ✅ Build da imagem Docker (Dockerfile)    ║
║  ✅ Login no Docker Hub                    ║
║  ✅ Push da imagem para Docker Hub         ║
║     → seu_usuario/mottuflow-app:123        ║
╚────────┬───────────────────────────────────╝
         │
         ▼
╔════════════════════════════════════════╗
║      STAGE 4: Deploy (CD)              ║
║  ✅ Remove container anterior          ║
║  ✅ Cria novo Container em ACI         ║
║  ✅ Configura variáveis de ambiente    ║
║  ✅ Aplicação fica disponível          ║
╚════════════════════════════════════════╝
         │
         ▼
    ✅ SUCESSO!
    Aplicação está rodando em produção!

🔄 Detalhamento de Cada Stage

Stage 1: BancoDados 🗄️

O que faz:

Provisiona um container MySQL em Azure Container Instance (ACI)
Aguarda o banco estar 100% pronto para aceitar conexões
Obtém o IP público do banco de dados
Disponibiliza esse IP para as próximas stages

Tempo: ~2-3 minutos

Stage 2: Build e Tests 🏗️

O que faz:

Instala Java 21 na máquina de build
Obtém o IP do MySQL da stage anterior
Executa mvn clean package que:
- Compila o código-fonte
- Executa testes automáticos (conectando ao MySQL real!)
- Gera arquivo JAR
Publica o JAR no Azure DevOps (artefato)

Testes: Usa os testes padrão do Spring Boot com banco real

Tempo: ~2-3 minutos

Stage 3: BuildDocker 🐳

O que faz:

Faz build da imagem Docker usando seu Dockerfile multistage
Faz login no Docker Hub com credenciais protegidas
Envia (push) a imagem para Docker Hub com tags:
- seu_usuario/mottuflow-app:12345 (build ID)
- seu_usuario/mottuflow-app:latest (mais recente)

Dockerfile: Localizado em MottuFlow/Dockerfile

Resultado: Imagem disponível em Docker Hub

Tempo: ~1-2 minutos

Stage 4: Deploy 🚀

O que faz:

Remove container anterior ( se existir )
Cria novo container em Azure Container Instance com:
- Imagem do Docker Hub
- Variáveis de ambiente
- Porta 8080 exposta
Torna aplicação acessível via HTTP

Resultado: Aplicação rodando em: http://mottuflow-app.brazilsouth.azurecontainer.io:8080

Tempo: ~1-2 minutos

⏱️ Tempo Total da Pipeline

~6-10 minutos do push até a aplicação estar em produção

🔐 Variáveis Protegidas

As credenciais são armazenadas no Azure DevOps Secret Group chamado mottuflow-secrets:

DOCKERHUB_USER          # Seu usuário Docker Hub
DOCKERHUB_PASSWORD      # Sua senha Docker Hub
DB_USER                 # Usuário do banco de dados
DB_PASSWORD             # Senha do banco de dados
DB_NAME                 # Nome do banco (mottuflow)

📂 Estrutura do Projeto

mottuflowdevops/
├── 📄 MottuFlow-links.pdf  # PDF com links para vídeo e repositório
├── 📄 azure-pipelines.yml  # Pipeline CI/CD
├── 📄 README.md            # Este arquivo aqui
├── 📄 ARQUITETURA.md       # Detalhes da Arquitetura do projeto
└── mottuflow/
    ├── 📄 Dockerfile                 # Configuração do container
    ├── 📄 docker-compose.yml         # Ambiente local
    ├── 📁 jsonsAPIREST/              # Coleção Postman
    ├── 🧹 limpar.sh                  # Script de limpeza
    └── 📁 src/
        ├── 📁 main/
        │   ├── 📁 java/              # Código fonte Java
        │   └── 📁 resources/
        │       ├── 📁 db/migration/  # Scripts Flyway
        │       ├── 📁 templates/     # Templates Thymeleaf
        │       └── 📁 static/        # Assets estáticos
        └── 📁 test/                  # Testes unitários

💾 Banco de Dados

Gerenciamento de Migrações

O projeto utiliza o MySQL como banco de dados e o Flyway para versionamento automático dos dados:

Localização: src/main/resources/db/migration/
Formato: V1__create_tables.sql, V2__insert_data.sql, etc.
Execução: Automática no deploy da aplicação

Script Consolidado

Existe também um arquivo consolidado em src/main/resources/db/script_bd.sql contendo todas as estruturas e dados iniciais.

⚠️ Nota: Este arquivo não é executado pelo Flyway automaticamente.

🔧 Instalação e Deploy

Pré-requisitos

Certifique-se de ter instalado:

Azure CLI (v2.0+)
Docker (v20.0+)
Git
Bash

Setup Inicial - Azure DevOps

Criar projeto no Azure DevOps:
- Nome: Sprint 4 – Azure DevOps
- Visibility: Private
- Version control: Git
- Work item process: Scrum
Conectar repositório GitHub:
- Vá em Pipelines → New Pipeline
- Selecione GitHub
- Autorizando acesso ao repositório

Criar Secret Group (mottuflow-secrets):

Vá em Pipelines → Library → Variable groups
Crie novo grupo: mottuflow-secrets

Adicione variáveis:

DOCKERHUB_USER = seu_usuario ( por padrão está as credencias de João Gabriel )
DOCKERHUB_PASSWORD = sua_senha ( por padrão está as credencias de João Gabriel )
DB_USER = rm554874
DB_PASSWORD = Mottuflow4874#
DB_NAME = mottuflow

Criar Service Connection Docker Hub:
- Vá em Project Settings → Service connections
- New: Docker Registry
- Nome: dockerhubConnection
- Docker ID: seu_usuario_dockerhub ( por padrão está as credencias de João Gabriel )
- Docker Password: sua_senha ( por padrão está as credencias de João Gabriel )
Adicionar arquivo de pipeline:
- Coloque azure-pipelines.yml na raiz do repositório
- Faça commit: git add azure-pipelines.yml && git commit -m "Add CI/CD pipeline"

Instruções de atualização da aplicação

A pipeline executa automaticamente a cada push na branch main:

# 1. Clone do repositório
git clone https://github.com/thejaobiell/MottuFlowDevops
cd MottuFlowDevops

# 2. Faça suas alterações
echo "seu código aqui" >> arquivo.txt

# 3. Commit e Push
git add .
git commit -m "Sua mensagem"
git push origin main

# 4. Pipeline dispara automaticamente!
# Acompanhe em: Azure DevOps → Pipelines → [sua pipeline]

💻 Como Usar

Interface Web (Thymeleaf)

Acesse a URL fornecida após o deploy

Credenciais de acesso:

📧 Email: admin@email.com
🔑 Senha: adminmottu

Funcionalidades disponíveis:
- Dashboard administrativo
- Gestão de funcionários
- Controle de pátios e motos
- Monitoramento em tempo real

🔌 API REST

Configuração no Postman

Importe a coleção da pasta jsonsAPIREST/
Configure a URL base substituindo localhost pelo FQDN
Obtenha o token JWT de autenticação

Autenticação

POST /api/login
Content-Type: application/json

{
  "email": "admin@email.com",
  "senha": "adminmottu"
}

Configuração do Bearer Token no Postman

1 - Clique em API - MottuFlow

2 - Vá para Variables

3 - Mude o valor da varíavel JWT para o seu token JWT

Exemplos de Uso

# Obter token JWT
curl -X POST http://mottuflow-app.brazilsouth.azurecontainer.io:8080/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@email.com","senha":"adminmottu"}'

# Listar funcionários (com token)
curl -X GET http://mottuflow-app.brazilsouth.azurecontainer.io:8080/api/funcionario/listar \
  -H "Authorization: Bearer [tokenAcesso]"

📊 Monitoramento da Pipeline

Acompanhar Execução

Vá em Azure DevOps → Pipelines
Clique em sua pipeline
Acompanhe em tempo real:
- Status de cada stage
- Logs detalhados
- Tempo de execução

Se a Pipeline Falhar

Clique no stage que falhou
Verifique a seção "Logs"
Erros comuns:
- ❌ Java 21 não encontrado → Verifique compatibilidade do agente
- ❌ Docker Hub credentials inválidos → Revise secret group
- ❌ Testes falhando → Verifique conectividade com MySQL
- ❌ Deploy não encontra imagem → Confirme push para Docker Hub

🧹 Limpeza de Recursos

⚠️ Importante: Sempre execute para evitar custos desnecessários:

./limpar.sh

Remove:

Todos os containers (MySQL e aplicação)
Resource Groups
Todos os recursos associados

👥 Equipe

_{João Gabriel Boaventura}
_{RM554874 • 2TDSB2025}

_{Leo Mota Lima}
_{RM557851 • 2TDSB2025}

_{Lucas Leal das Chagas}
_{RM551124 • 2TDSB2025}

Name		Name	Last commit message	Last commit date
Latest commit History 131 Commits
MottuFlow		MottuFlow
DocumentaoMottuFlow.pdf		DocumentaoMottuFlow.pdf
README.md		README.md
arquivo.txt		arquivo.txt
azure-pipelines.yml		azure-pipelines.yml

thejaobiell/MottuFlowDevops

Folders and files

Latest commit

History

Repository files navigation

MottuFlow - Sistema de Gerenciamento de Frotas

🚀 Visão Geral

Características Principais

✨ Funcionalidades

🏗️ Arquitetura

🛠️ Tecnologias

Backend

Frontend

Banco de Dados

Infraestrutura

🚀 Pipeline CI/CD

📋 Como Funciona

🔄 Detalhamento de Cada Stage

Stage 1: BancoDados 🗄️

Stage 2: Build e Tests 🏗️

Stage 3: BuildDocker 🐳

Stage 4: Deploy 🚀

⏱️ Tempo Total da Pipeline

🔐 Variáveis Protegidas

📂 Estrutura do Projeto

💾 Banco de Dados

Gerenciamento de Migrações

Script Consolidado

🔧 Instalação e Deploy

Pré-requisitos

Setup Inicial - Azure DevOps

Instruções de atualização da aplicação

💻 Como Usar

Interface Web (Thymeleaf)

🔌 API REST

Configuração no Postman

Autenticação

Configuração do Bearer Token no Postman

Exemplos de Uso

📊 Monitoramento da Pipeline

Acompanhar Execução

Se a Pipeline Falhar

🧹 Limpeza de Recursos

👥 Equipe

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages