# Step 0: Result Database

## 읽어야 할 파일

- `/AGENTS.md`
- `/docs/PRD.md`
- `/docs/ARCHITECTURE.md`
- `/docs/ADR.md`
- `/include/fesa/model/domain.hpp`
- `/include/fesa/core/diagnostic.hpp`

## 작업

HDF5와 독립적인 최소 Phase 1 result semantic model을 만든다.

```cpp
struct NodalFrame final {
    std::vector<NodeId> node_ids;
    std::vector<std::array<double, 6>> displacement;
    std::vector<std::array<double, 6>> reaction;
};
struct ResultFrame final {
    double step_time;
    NodalFrame nodal;
    std::vector<Diagnostic> diagnostics;
};
struct ResultStep final {
    std::string name;
    std::vector<ResultFrame> frames;
};
struct ResultDatabase final {
    std::string schema_version;
    std::vector<ResultStep> steps;
};
```

- size mismatch, duplicate node, nonfinite field, duplicate step/frame을 실패 테스트로
  먼저 작성한다.
- 이 step에는 element result를 미리 만들지 않는다.

## Acceptance Criteria

```powershell
cmake --build --preset windows-debug
ctest --preset windows-debug -R "ResultDatabase|NodalFrame" --output-on-failure
ctest --preset windows-debug --output-on-failure
```

## 검증 절차

1. 유효/무효 result model 테스트를 먼저 실행한다.
2. 불변 읽기 계약에 필요한 최소 저장만 구현한다.
3. HDF5 include가 없는지 확인한다.
4. 전체 테스트와 index를 갱신한다.

## 금지사항

- HDF5 handle을 result model에 넣지 마라. 이유: semantic/adaptor 경계를 깨뜨린다.
- velocity, acceleration, temperature를 추가하지 마라. 이유: Phase 1에서 사용하지 않는다.
- 빈 element output hierarchy를 만들지 마라. 이유: 필요한 phase에서만 실체화한다.