DB Mode (No Cache)

0000-example

example-problem

C Difficulty

README.md Preview

# 📋 Modelo wokSchema - Estrutura Padrão

## 🎯 Objetivo

Este diretório serve como **modelo/template** para criar novos problemas no sistema wok. Ele define a estrutura padrão e convenções que devem ser seguidas por todas as implementações.

## 📁 Estrutura do Modelo

```
0000-metadata-scheme/
├── metadata.yaml                    # Configuração principal do problema
├── README.md                        # Este arquivo - documentação geral
├── documentation/                   # Guias visuais e interativos
│   ├── index.html                  # Guia principal interativo
│   ├── structure-guide.html        # Guia da estrutura
│   └── examples.html               # Exemplos práticos
├── statements/                      # Enunciados do problema
│   ├── README.md                   # Como criar statements
│   └── default/                    # Exemplo de statement
│       ├── D_pt_default.md         # Enunciado em português
│       ├── D_en_default.md         # Enunciado em inglês
│       ├── D_pt_default.html       # Versão HTML em português
│       └── D_en_default.html       # Versão HTML em inglês
├── solutions/                       # Soluções de exemplo
│   ├── README.md                   # Como criar solutions
│   └── a-solution/                 # Exemplo de solution
│       ├── solution.cpp            # Solução em C++
│       ├── solution.py             # Solução em Python2
│       └── Solution.java           # Solução em Java
└── test-cases/                     # Casos de teste
    ├── README.md                   # Como criar test-cases
    └── a-sample/                   # Exemplo de test-case
        ├── a-sample1.in            # Arquivo de entrada
        └── a-sample1.out           # Arquivo de saída esperada
```

## 🔗 Relação YAML ↔ Estrutura de Diretórios

### **Princípio Fundamental:**
O arquivo `metadata.yaml` define a estrutura de diretórios através dos campos `id`:

```yaml
# metadata.yaml
statements:
- id: "default"          # → statements/default/
solutions:
- id: "a-solution"       # → solutions/a-solution/
testScenarios:
- id: "a-sample"         # → test-cases/a-sample/
```

### **Convenção de Nomenclatura:**

#### **Statements:**
```
statements/
└── {level}-{slug}/
    ├── {level}_{lingua}_{slug}.md
    └── {level}_{lingua}_{slug}.html
```

**Exemplo:**
- `statements/a-padrao/A_pt_padrao.md` = Nível A, Português, slug "padrao"

#### **Solutions:**
```
solutions/
└── {solution-id}/
    ├── {filename}.cpp
    ├── {filename}.py
    └── {filename}.java
```

#### **Test Cases:**
```
test-cases/
└── {scenario-id}/
    ├── {test-name}.in
    └── {test-name}.out
```

## 🚀 Como Usar Este Modelo

### **1. Copiar a Estrutura:**
```bash
cp -r 0000-metadata-scheme/ novo-problema/
```

### **2. Modificar metadata.yaml:**
- Alterar `id`, `name`, `slug`
- Ajustar `statements`, `solutions`, `testScenarios`
- Configurar `skills`, `difficultyLevelId`

### **3. Criar Conteúdo:**
- Adicionar enunciados em `statements/`
- Implementar soluções em `solutions/`
- Criar casos de teste em `test-cases/`

## 📋 Campos Obrigatórios do metadata.yaml

| Campo | Tipo | Descrição | Exemplo |
|-------|------|-----------|---------|
| `origin` | string | Origem do problema | `"wok"` |
| `editorial` | string | Descrição editorial | `"Problema simples..."` |
| `timeComplexity` | string | Complexidade temporal | `"O(1)"` |
| `testType` | string | Tipo de teste | `"TDD"` |
| `paradigm` | string | Paradigma de programação | `"Imperative"` |
| `main` | string | Classe/função principal | `"main"` |
| `filenames` | array | Lista de arquivos | `["solution.cpp"]` |

## 📏 Definições de Enumeráveis e Classificações

### **Níveis de Dificuldade Global (`difficultyLevelId`)**
A escala obedece a uma progressão de competência (A-E):

| Nível | Descrição | Perfil do Desafio | XP Base |
|:-----:|-----------|-------------------|:-------:|
| **E** | **Iniciante** | Sintaxe básica, I/O simples, atribuição direta. | 10 XP |
| **D** | **Fácil** | Estruturas de controle (if/for), vetores básicos. | 20 XP |
| **C** | **Médio** | Laços aninhados, strings, ordenação simples. | 40 XP |
| **B** | **Difícil** | Estruturas complexas, grafos, Programação Dinâmica. | 80 XP |
| **A** | **Expert** | Algoritmos avançados, geometria, otimização fina. | 160 XP |

### **Níveis de Casos de Teste (`testScenarioLevel`)**
Classifica a **severidade** e o **propósito** de um grupo de testes:

- **E (Sanity Check):** Testes de exemplo (como os do enunciado). Obrigatórios para qualquer submissão.
- **D (Básico):** Casos triviais e funcionais simples.
- **C (Padrão):** Casos de borda comuns (ex: vetor vazio, strings nulas).
- **B (Stress):** Testes de carga para verificar Time Limit (TLE) e Memory Limit (MLE).
- **A (Corner Cases):** Casos patológicos, limites matemáticos ou lógicos extremos.

### **Fases de Skills (`Skills Phase`)**
Agrupamento cronológico de competências (Metáfora de Maratona):
- **5K (Iniciante):** CS1 - Lógica básica até Funções.
- **10K (Intermediário):** CS2 - Estruturas de dados lineares e abstração.
- **Meia-Maratona:** CS2/CS3 - Ponteiros, Recursão, Memória Dinâmica.
- **Maratona (Elite):** CS3 - Algoritmos Avançados, Grafos, PD.

### **Configuração de Skills no metadata.yaml**

#### **Skills (Raiz):**
Lista simples de slugs das habilidades principais requeridas pelo problema.
```yaml
skills:
  - lacos
  - operadores
  - vetores
```

#### **Thematic Skills (Enunciado/Casos de Teste):**
Habilidades associadas a contextos específicos, com pontuação.
```yaml
thematicSkills:
  - points: 1
    skill: "matematica"
```
*Geralmente aninhado dentro de objetos `testScenarios` ou definido para o contexto do enunciado.*

## 🎬 Scripts de Execução e Validação

Estes campos são **opcionais** no `metadata.yaml`. Se omitidos, o sistema assume o valor `default`.

### **Scripts de Execução (`runScript`)**
Definem como o código do aluno é executado e interage com o ambiente.

| Valor | Descrição | Uso Típico |
|-------|-----------|------------|
| `default` | **Padrão:** Entrada (`stdin`) $\to$ Saída (`stdout`). | 90% dos problemas (Lógica, Algoritmos). |
| `interactive` | Interage em tempo real com o código do aluno. | Jogos, Diálogos, "Adivinhe o Número". |
| `env_setup` | Prepara o ambiente antes da execução (ex: SQL). | Banco de Dados, Arquivos prévios. |
| `chained` | Pipeline onde a saída de um passo alimenta o próximo. | Sequências didáticas, Problemas multi-etapa. |
| `instrumentation`| Gera artefatos colaterais (UML, Logs) para análise. | Análise estrutural, Engenharia reversa. |
| `behavioral` | Monitora comportamento interno (loops, recursão). | Restrições de projeto, Otimização. |

### **Scripts de Comparação (`compareScript`)**
Definem como a saída do aluno é validada contra o gabarito.

| Valor | Descrição | Uso Típico |
|-------|-----------|------------|
| `default` | **Exact Match:** Comparação byte-a-byte estrita. | Maratonas, Saídas determinísticas. |
| `flexible` | Ignora espaços em branco extras e quebras de linha. | Iniciantes, Formatação relaxada. |
| `float_tolerance` | Aceita erro de precisão ($\epsilon < 10^{-6}$). | Cálculos numéricos, Ponto flutuante. |
| `rich_feedback` | Validador customizado que gera arquivo de feedback. | Erros semânticos complexos, Grafos. |

## ⚙️ Limites e Formatos

### **Tempos e Memória**
- **`timeLimitSegs`**: Inteiro (segundos). Ex: `1`, `2`. (Geralmente < 5s para problemas padrão).
- **`memoryLimitMb`**: Inteiro (Megabytes). Ex: `128`, `256`.

### **Tipos de Teste (`testType`)**
- **TDD**: Comparação exata entrada/saída (padrão maratona).
- **Fuzzy**: Permite pequenas variações (útil para float).
- **Performance**: Foca estritamente no tempo de execução, não apenas corretude.

## 🎨 Documentação Visual

Para uma experiência mais rica, consulte os arquivos HTML em `documentation/`:
- **index.html** - Guia interativo principal
- **structure-guide.html** - Visualização da estrutura
- **examples.html** - Exemplos práticos

## 📚 Próximos Passos

1. **Leia os README.md específicos** em cada pasta
2. **Explore os exemplos** em `statements/default/`
3. **Teste as soluções** em `solutions/a-solution/`
4. **Analise os casos de teste** em `test-cases/a-sample/`

---

**Autor:** Equipe WOKODEX
**Versão:** 1.1
**Data:** 2026-02-09
dummy change for verification

Actions

Workflow do Problema

Local Workspace

Pasta criada no disco
Metadados

Informações básicas preenchidas
3

Validação

Soluções passam nos testes
4

Sincronização

Enviado para DB e GitLab

⚠️ Not in Database

This problem was not found in the database (ID: 0).

Some features like test case sync are disabled.

Components

Statements ✅
Solutions 0 ✅
Test Cases 1 ✅

🚀 Quick Prompts

Structure Scaffolding

Generate metadata & folder structure

ID: 1.1

Context & Description

Draft description & editorial

ID: 1.2

Statements List

ID	Level	Natural Languages	Skills	Status	Action

Statement Details

Select a statement above to view details.

Actions

Statistics

0 Total Statements

By Type (ID)

By Level

🚀 Quick Prompts

Statement Analysis

Analyze ambiguity & clarity

ID: 2.1

WOK Statement Generation

Rewrite in WOK Universe theme

ID: 2.2

Statement Expansion

Expand to 4 difficulty levels

ID: 2.3

0000-example

README.md Preview

Actions

Workflow do Problema

Local Workspace

Metadados

Validação

Sincronização

⚠️ Not in Database

Components

🚀 Quick Prompts

Statements List

Statement Details

Actions

Statistics

By Type (ID)

By Level

🚀 Quick Prompts

📊 Sync Statistics

Actions

Test Case Details

Testcase Scenarios Sync

No Scenarios in YAML

Local Test Cases (Disk)

Scenario: a-sample 1 cases

📊 Sync Statistics

Actions

No Solutions Defined

Solutions Check Report

✅ Verification

🚀 Quick Prompts

📄 Enunciados

💡 Soluções

🧪 Casos de Teste

Metadata (form)

Git Status

Git Workflow

Problem Analysis Report

ℹ️ Not Fixed in API Platform

❌ Not found in Database

Actions

📋 Processo de Criação

Select a Prompt

📤 API Synchronization

📄 Recreating README.md...

💻 Git Action Output

Running Verification...

Ajuda

🚀 Processing Sync Action

🚀 Batch Auto-Link Process

⬇️ Repo Sync Output

📝 Update Manifest Output

Ajuda