⚠️ Projeto Arquivado
Este projeto não recebe mais atualizações ou correções. O código permanece disponível como referência e pode ser utilizado livremente sob a licença MIT. Fique à vontade para fazer fork caso deseje continuar o desenvolvimento.

Índice

• Sobre o Projeto
• Funcionalidades
• Tecnologias
• Arquitetura
• Estrutura do Projeto
• Começando
  • Pré-requisitos
  • Instalação
  • Uso
• Scripts Disponíveis
• Testes
• Qualidade e Governança
• FAQ
• Licença
• Contato

Sobre o Projeto

Aplicação de console modular que demonstra conceitos básicos de Java de forma prática e interativa. O sistema apresenta um menu principal com 5 módulos funcionais, cada um encapsulado em sua própria classe com separação clara entre lógica pura e I/O.

O repositório prioriza:

• Arquitetura modular — Cada funcionalidade isolada em classe própria dentro de com.esousa.interativo.modulo, com métodos estáticos e construtores privados (classes utilitárias)
• Scanner centralizado — ConsoleUtils gerencia uma única instância de Scanner compartilhada entre todos os módulos, evitando conflitos de buffer e duplicação de código de validação
• Lógica pura separada de I/O — Métodos como calcular(), gerarSaudacao() e gerarMensagemIdade() não fazem I/O, tornando-os diretamente testáveis sem mocks
• Build reprodutível — Maven com pom.xml completo, Maven Wrapper incluído (mvnw/mvnw.cmd), JAR executável configurado com maven-jar-plugin
• Testes parametrizados — JUnit 5 com @ParameterizedTest, @CsvSource, @Nested e @DisplayName para testes expressivos e com boa cobertura
• Análise estática — Checkstyle com regras simplificadas baseadas no Google Java Style (nomenclatura, imports, braces, espaçamento, tamanho de método ≤60 linhas, tamanho de arquivo ≤500 linhas)

Funcionalidades

• Hello World Interativo — Saudações personalizadas com 3 estilos (clássica, formal, descontraída) e opção de exibir todas simultaneamente
• Perfil Interativo — Coleta de nome, idade, profissão e hobby com validação de entrada e mensagem personalizada por faixa etária (<18, 18-64, 65+)
• Estudos e Anotações — Visualização de anotações padrão sobre Java (listas imutáveis), adição de anotações personalizadas com timestamp e dicas de estudo
• Calculadora Básica — Soma, subtração, multiplicação e divisão com entrada interativa ou operações pré-definidas, tratamento de divisão por zero e operação inválida
• Informações do Sistema — Exibição de versão Java, Java Home, sistema operacional, usuário, diretório atual e data/hora

Tecnologias

Dependências: JDK 17+ (sem dependências de runtime externas), JUnit Jupiter 6.0.2 (test), Maven Checkstyle Plugin 3.6.0, Maven Compiler Plugin 3.15.0, Maven Surefire Plugin 3.5.4.

Arquitetura

graph TD
    subgraph "com.esousa.interativo"
        A[SistemaInterativo]
    end

    subgraph "com.esousa.interativo.modulo"
        B[HelloWorld]
        C[PerfilInterativo]
        D[EstudosInterativo]
        E[CalculadoraBasica]
    end

    subgraph "com.esousa.interativo.util"
        F[ConsoleUtils]
    end

    A --> B
    A --> C
    A --> D
    A --> E
    B --> F
    C --> F
    D --> F
    E --> F

Camadas

Decisões de Design

Estrutura do Projeto

primeiroprojetoJ/
├── src/
│   ├── main/java/com/esousa/interativo/
│   │   ├── SistemaInterativo.java              # Entry point — banner + menu loop
│   │   ├── modulo/
│   │   │   ├── HelloWorld.java                 # Saudações interativas (3 estilos)
│   │   │   ├── PerfilInterativo.java           # Coleta de perfil com mensagem por idade
│   │   │   ├── EstudosInterativo.java          # Anotações e dicas (listas imutáveis)
│   │   │   └── CalculadoraBasica.java          # 4 operações com tratamento de erros
│   │   └── util/
│   │       └── ConsoleUtils.java               # Scanner único + I/O centralizado
│   └── test/java/com/esousa/interativo/modulo/
│       ├── CalculadoraBasicaTest.java           # Testes parametrizados (soma, sub, mult, div, erros)
│       ├── HelloWorldTest.java                  # Testes de saudação (3 estilos + fallback)
│       ├── EstudosInterativoTest.java           # Testes de imutabilidade das listas
│       └── PerfilInterativoTest.java            # Testes de mensagem por faixa etária
├── docs/
│   └── architecture.md                          # Diagrama e decisões arquiteturais
├── assets/
│   └── Desafios.png                             # Screenshot do menu
├── .github/
│   ├── workflows/
│   │   └── ci.yml                               # Build + Test + Checkstyle (JDK 17, 21)
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── dependabot.yml                           # Maven + GitHub Actions (semanal)
├── .mvn/wrapper/
│   └── maven-wrapper.properties                 # Maven 3.9.6
├── mvnw                                         # Maven Wrapper (Unix)
├── mvnw.cmd                                     # Maven Wrapper (Windows)
├── pom.xml                                      # Build config (JDK 17, JUnit 5, Checkstyle)
├── checkstyle.xml                               # Regras simplificadas (Google Java Style)
├── .editorconfig                                # UTF-8, LF, indent 4
├── .gitattributes                               # Normalização de line endings
├── CHANGELOG.md                                 # Keep a Changelog
├── CONTRIBUTING.md                              # Guia de contribuição
├── CODE_OF_CONDUCT.md                           # Contributor Covenant 2.1
├── SECURITY.md                                  # Política de segurança
└── LICENSE                                      # MIT

Começando

Pré-requisitos

java -version   # JDK 17 ou superior
mvn -v          # Maven 3.8+ (ou use o Maven Wrapper incluído)

Instalação

git clone https://github.com/ESousa97/primeiroprojetoJ.git
cd primeiroprojetoJ
mvn clean verify

O projeto inclui Maven Wrapper — se não tiver Maven instalado, substitua mvn por ./mvnw (Unix) ou mvnw.cmd (Windows).

Uso

Via Maven Exec:

mvn exec:java -Dexec.mainClass="com.esousa.interativo.SistemaInterativo" -q

Via JAR:

mvn package -DskipTests
java -jar target/sistema-interativo-1.0.0.jar

Scripts Disponíveis

# Compilar
mvn compile

# Executar testes unitários
mvn test

# Build completo (compile + test + checkstyle)
mvn verify

# Verificar estilo de código
mvn checkstyle:check

# Gerar JAR executável
mvn package

# Gerar JAR sem testes
mvn package -DskipTests

Testes

mvn test

Testes unitários com JUnit 5 cobrindo os 4 módulos:

• CalculadoraBasicaTest — Testes parametrizados (@CsvSource) para soma, subtração, multiplicação, divisão; exceções para divisão por zero e operação inválida; verificação de operadores
• HelloWorldTest — Saudações clássica, formal, descontraída e todas; fallback para tipo desconhecido; não-nulidade para entradas variadas
• EstudosInterativoTest — Verificação de não-vazio e imutabilidade (UnsupportedOperationException) das listas de anotações e dicas
• PerfilInterativoTest — Mensagens corretas por faixa etária (7 cenários parametrizados: <18, 18-64, 65+); não-nulidade

Qualidade e Governança

• CI — GitHub Actions com matrix strategy (JDK 17 + 21): compile → test → checkstyle → package JAR (upload como artifact com retenção de 7 dias)
• Checkstyle — Regras simplificadas baseadas no Google Java Style: nomenclatura (TypeName, MethodName, ParameterName, LocalVariableName, MemberName, ConstantName), imports não utilizados/redundantes, braces obrigatórias, espaçamento, métodos ≤60 linhas, arquivos ≤500 linhas, sem trailing whitespace
• Dependabot — Atualizações semanais de Maven e GitHub Actions
• Governança — Issue templates (Bug Report, Feature Request), PR template com checklist, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md
• Zero dependências de runtime — Apenas JDK padrão em produção; JUnit 5 e Checkstyle são exclusivamente de build/test

Para diretrizes de contribuição, consulte CONTRIBUTING.md. Para política de segurança, consulte SECURITY.md.

FAQ

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

MIT License - você pode usar, copiar, modificar e distribuir este código.

Contato

José Enoque Costa de Sousa