Files
vinihcrosaandClaude Sonnet 4.6 d495d7b58d docs: consolidate all documentation under docs/ and enforce single-source rule
Migrate all docs scattered across hidden folders into docs/:
- .compozy/tasks/ → docs/planning/ (PRDs, tech specs, tasks, memory) and docs/adr/ (ADRs by phase)
- .specs/ → docs/specs/ (codebase, features, project specs)
- .docs/ → docs/legacy/ (legacy reference implementation docs)
- .discussions/ → docs/discussions/ (design discussions and open questions)

Delete .compozy/, .specs/, .docs/, and .discussions/.

Update AGENTS.md: add explicit docs/ location table, hard rule against hidden doc folders,
and new AI-assisted development section (context lazy loading, scope control, verification).

Update CLAUDE.md: fix .docs/ references to docs/legacy/.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-28 01:09:54 -03:00

62 lines
2.0 KiB
Markdown

# Ymir — Testing
## C++ (atual)
**Framework:** Catch2 v3.5.4 (FetchContent)
**7 test executables:**
| Target | Cobre | Arquivos |
|--------|-------|----------|
| `ymir_smoke_tests` | Sanidade geral | `SmokeTest.cpp` |
| `ymir_common_tests` | Math utilities | `TestMath.cpp` |
| `ymir_physics_tests` | Body, ForceModel, Forces | 4 arquivos |
| `ymir_integrator_tests` | CVODE integration loop | `TestIntegrator.cpp` |
| `ymir_simulation_tests` | NavalInfra, coupling, domains | 7 arquivos |
| `ymir_world_tests` | Environment, waves, coupling registry | 6 arquivos |
| `ymir_persistence_tests` | JSON scenario reader | `TestScenarioReader.cpp` |
**Coverage target:** ≥ 80% line coverage (LLVM `llvm-cov`)
**Rodar testes:**
```bash
# Docker
make test
# Nativo
ctest --test-dir build --output-on-failure
# Com coverage
cmake -B build -DYMIR_ENABLE_COVERAGE=ON
cmake --build build --target ymir_coverage
```
**Filtros de coverage:** ignora `build*`, `_deps/`, `tests/`
## Gate checks (C++)
Qualquer task C++ passa quando:
1. `cmake --build build --parallel` sem erros
2. `ctest --test-dir build --output-on-failure` — todos passam
3. Coverage ≥ 80% (verificado em tasks que adicionam código)
## Testes Planejados (pós-migração)
### Integrador RK45 (substitui TestIntegrator.cpp)
- Teste de precisão: problema ODE com solução analítica conhecida (ex: oscilador harmônico)
- Teste de step adaptation: erro local dentro de tolerância `rtol=1e-6, atol=1e-8`
- Teste de regressão: mesmos casos de integração que existiam com CVODE
### WASM smoke test (browser)
- Playwright: carrega página, inicia simulação, verifica que estado avança por 10 steps
- Não substitui testes C++ — testa apenas que o binding funciona no browser
### API (Fastify)
- Framework: Vitest + `fastify.inject()` para rotas (sem HTTP real)
- Cada rota tem teste de: happy path, schema inválido, not found
### Frontend (React)
- Framework: Vitest + React Testing Library
- Componentes críticos testados em isolamento
- Worker não testado unitariamente — coberto pelo teste Playwright