📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados em Guia de Linguagens de Programação. Recomendado revisar antes de começar.

🌍 Saudação & Hello World Multilinguagem em 38 Stacks

v1.0 — Ponto de Entrada (main), Entrada/Saída (I/O) e Sintaxe Inicial em 38 Tecnologias

Trilha de Especialização Pedagógica — Projeto 1 de 4

• ➡️ v1 (este): Saudação & Hello World · Ponto de Entrada · I/O · 38 Linguagens
• v2: Calculadora de IMC com Condicionais em 38 Linguagens
• v3: Manipulação de Arquivos e Estruturas em 38 Linguagens
• v4: Cliente HTTP & Consumo de JSON em 38 Linguagens

🎓 Nível Profissional Simulado: Desenvolvedor Poliglota / Estudante de Ciência da Computação. Todo grande programador começa com o tradicional “Hello World”. Neste projeto, você descobre a anatomia do ponto de entrada (main), argumentos de terminal e impressão de texto nas 38 principais linguagens do ecossistema de tecnologia mundial.

🎯 Objetivo & Escopo do Projeto

Construir o projeto canônico de Saudação Customizada com Argumentos CLI em 38 linguagens de programação, comparando lado a lado: como a função principal é declarada, como parâmetros de terminal são recebidos (args) e como strings são formatadas e impressas no console.

🧑‍💼 Fase 1 — Levantamento de Requisitos

O Briefing do Cliente (Coordenador do Portal de Cursos)

“Queremos um catálogo de referência rápida para os alunos iniciarem qualquer curso do portal. Cada uma das 38 linguagens deve ter um programa executável que: receba o nome do usuário como argumento de linha de comando (com fallback para ‘Mundo’ caso não seja informado) e imprima a mensagem ‘Olá, [Nome]! Bem-vindo ao Portal de Cursos!’.”

Requisitos Funcionais (RF) e Não-Funcionais (RNF)

📋 Fase 2 — Backlog & User Stories

🌿 Fase 3 — Engenharia em Equipe (Git Flow & Execução)

# Branch da funcionalidade
git checkout -b feature/US01-saudacao-multilinguagem

# Executar em Python
python saudacao.py "Ricardo"

# Executar em Go
go run saudacao.go "Ricardo"

# Executar em Rust
cargo run -- "Ricardo"

🛠️ Fase 4 — Implementação Guiada (Exemplos Go, Rust e Python)

// Go
package main
import ("fmt"; "os")
func main() {
    nome := "Mundo"
    if len(os.Args) > 1 { nome = os.Args[1] }
    fmt.Printf("Olá, %s! Bem-vindo ao Portal de Cursos!
", nome)
}

// Rust
fn main() {
    let args: Vec<String> = std::env::args().collect();
    let nome = if args.len() > 1 { &args[1] } else { "Mundo" };
    println!("Olá, {}! Bem-vindo ao Portal de Cursos!", nome);
}

🚀 Como Executar no Laboratório

1. Abra o terminal na pasta deste projeto

No seu editor/IDE, abra a pasta deste projeto (File > Open Folder) ou navegue via terminal:

cd multilang_saudacoes_38

2. Execute a aplicação ou testes

# Executar comandos específicos da tecnologia:
python main.py # ou npm run dev / ./gradlew build

[!TIP] Dica para execução a partir da raiz do repositório: Se você abriu o repositório completo no VS Code, basta navegar até a pasta antes de executar: cd catalogo_projetos/multilang_saudacoes_38`

🧭 Decisões de Arquitetura (ADRs)

• ADR 001: Adoção de padrão unificado de I/O em 38 linguagens para fins de nivelamento inicial.

🧪 Testes de Validação & Asserções

Entrada: ./saudacao "Dev"
Saída Esperada: "Olá, Dev! Bem-vindo ao Portal de Cursos!"

🏛️ Arquitetura Visual & Engenharia do Sistema

O diagrama abaixo sintetiza a organização dos artefatos, contratos e diretrizes arquiteturais na subpasta multilang/:

flowchart TD
    subgraph Especificacao["Especificação & Contratos"]
        E1["Contratos Formais"] --> E2["Modelagem de Domínio"]
    end
    subgraph Implementacao["Implementação & Stacks"]
        I1["Arquiteturas & Código"] --> I2["Paridade Multilinguagem"]
    end
    subgraph Padroes["Governança & Padrões"]
        P1["Living Styleguides"] --> P2["Conformidade de Design"]
    end
    subgraph Homologacao["Qualidade & Homologação"]
        Q1["Matriz de Rastreabilidade"] --> Q2["Checkpoints CP-01..05 PASS"]
    end

    Especificacao --> Implementacao
    Implementacao --> Padroes
    Padroes --> Homologacao

    style Especificacao fill:#e3f2fd,stroke:#1976d2,stroke-width:1.5px
    style Implementacao fill:#fffde7,stroke:#fbc02d,stroke-width:1.5px
    style Padroes fill:#e8f5e9,stroke:#388e3c,stroke-width:1.5px
    style Homologacao fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1.5px

🎯 Engenharia de Requisitos & Modelagem Formal

👤 User Stories (Histórias de Usuário)

⚙️ Requisitos Funcionais (RF)

🛡️ Requisitos Não-Funcionais (RNF)

🔗 Matriz de Rastreabilidade (RTM)

🏁 Checkpoints de Qualidade & Homologação