📘 App Demo ERP

---

📘 Aplicação de Demonstração ERP

Projeto desenvolvido em Spring Boot com arquitetura MVC, testes unitários e de integração, integração contínua e ferramentas de DevSecOps. O objetivo é servir como base de aprendizado e referência de boas práticas, simulando o dia a dia de um time profissional em projetos Java.

---

🎯 Objetivos

• 🗄️ Persistência com JPA/Hibernate
• ✅ Testes automatizados (JUnit 5 + Mockito)
• 🔄 CI com GitHub Actions
• 📊 Cobertura de testes integrada ao Codecov
• 📦 Publicação de pacotes no GitHub Packages
• 📈 Dependency Graph atualizado via pipeline
• 📄 SBOM (CycloneDX) gerado e publicado
• 🚨 Dependabot Alerts habilitados
• 📑 Relatórios de testes como artefatos CI
• 🔍 Qualidade e segurança monitoradas via SonarCloud
• 🏷️ Badges de status no README

---

⚙️ Pré-requisitos

• Java 21+
• Maven 3.8+
• Plugin Lombok na IDE

---

🗄️ Banco de Dados (H2 Console)

• URL: http://localhost:8080/h2-console
• JDBC URL: jdbc:h2:mem:testdb
• Usuário: sa
• Senha: (vazio)

---

✅ Comandos Maven

🔌 Plugin	⚡ Fase padrão	▶️ Execução manual
maven-resources-plugin	process-resources	mvn resources:resources
maven-compiler-plugin	compile	mvn compiler:compile
spring-boot-maven-plugin	package	mvn spring-boot:run / mvn spring-boot:repackage
jacoco-maven-plugin	verify	mvn jacoco:prepare-agent / mvn jacoco:report
maven-surefire-plugin	test	mvn test
cyclonedx-maven-plugin	verify	mvn cyclonedx:makeAggregateBom

---

📦 Como Compilar e Executar

# Clonar
git clone https://github.com/seu-usuario/app-demo.git
cd app-demo

# Compilar
mvn clean install

# Rodar local
mvn spring-boot:run

App disponível em 👉 http://localhost:8080

---

🌐 Collection de Endpoints

O repositório inclui a collection Postman pronta para importação:

👉 Baixar app-demo-collection.json

Como importar

1. Abra o Postman ou Insomnia
2. Clique em Import > File
3. Selecione o arquivo app-demo-collection.json

---

🗂️ Estrutura do Projeto

app-demo
├── src/main/java/br/com/springboot/erp
│   ├── controller                  # Controllers REST
│   ├── model                       # Entidades JPA
│   ├── repository                  # Repositórios Spring Data
│   ├── service                     # Regras de negócio
│   └── AppDemo.java                # Classe principal
├── src/test/java/...               # Testes unitários e de integração
├── pom.xml                         # Build Maven
├── Dockerfile                      # Build da imagem da aplicação
├── docker-compose.yml              # Orquestração de containers (app, banco, etc.)
├── .github/workflows/maven.yml     # Pipeline CI/CD (GitHub Actions)
└── app-demo-collection.json        # Collection de APIs (Postman)  

---

🔐 Configurações de CI/CD

Secrets necessários no GitHub:

• SONAR_TOKEN → SonarCloud
• CODECOV_TOKEN → Codecov
• GITHUB_TOKEN → fornecido automaticamente

⚠️ Importante: use CI-based Analysis no SonarCloud (não AutoScan).

---

🐳 Docker

# Build da imagem
docker build -t app-demo:1.4.1 .

# Executar container
docker run --rm -p 8080:8080 app-demo:1.4.1

# Config externa (application.properties)
docker run --rm -p 8080:8080 app-demo:1.4.1 -e SPRING_CONFIG_LOCATION=file:/config/application.properties 

---

🐳 Docker Compose

# Subir serviços
docker-compose up -d --build

# Subir apenas a Infra do Kafka
docker compose up -d zookeeper kafka

# Logs
docker-compose logs -f app-demo

# Derrubar tudo
docker-compose down

📊 JMeter – Execução de Testes de Carga

# Linux
rm -rf /temp/jmeter/
mkdir -p /temp/jmeter/

# Windows
Remove-Item -Recurse -Force "/temp/jmeter"
New-Item -ItemType Directory -Path "/temp/jmeter"
jmeter -n -t post-customers-10000-random.jmx -l /temp/jmeter/results.jtl -e -o /temp/jmeter/report

---

📜 Licença

Distribuído sob a licença MIT. Sinta-se livre para usar, modificar e compartilhar.