FESA/phases/results-and-pipeline/step0.md

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을 만든다.

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

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에서만 실체화한다.