FESA/phases/beam-reference-qualification/step1.md

Step 1: Reference CSV Adapters

읽어야 할 파일

• /AGENTS.md
• /docs/PRD.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md
• /docs/superpowers/specs/2026-07-29-abaqus-assembly-reference-design.md
• /include/fesa/validation/comparison.hpp
• /reference/cantilever beam/cantilever beam displacements.csv
• /reference/cantilever beam/cantilever beam reactions.csv

작업

네 물리량의 명시적 CSV schema를 읽어 canonical reference row로 변환한다.

struct ReferenceRow final {
    ReferenceQuantity quantity;
    ResultPosition position;
    std::vector<double> values;
};
struct ReferenceCsvReadResult final {
    std::vector<ReferenceRow> rows;
    std::vector<Diagnostic> diagnostics;
};
[[nodiscard]] ReferenceCsvReadResult read_reference_csv(
    ReferenceQuantity,
    const std::filesystem::path&,
    std::string_view single_instance_name);

• displacement/reaction은 제공된 whitespace 포함 Abaqus header를 읽는다.
• internal force schema: Part Instance Name, Element Label, Node Label, SF-SF1..SF-SF3, SM-SM1..SM-SM3
• stress schema: Part Instance Name, Element Label, Node Label, Sxx
• 단일 Instance에서는 Instance 열 생략을 허용하고 request 이름으로 보완한다.
• tests/fixtures/reference에 synthetic internalforce/stress CSV를 먼저 만들고, 6개 내력 component와 centroid stress row를 실패 테스트로 고정한다.

Acceptance Criteria

cmake --build --preset windows-debug
ctest --preset windows-debug -R "ReferenceCsv|InternalForceCsv|StressCsv" --output-on-failure
ctest --preset windows-debug --output-on-failure

검증 절차

1. four-schema parser test 실패를 확인한다.
2. header/value trim과 선택적 UTF-8 BOM만 허용한다.
3. missing column, duplicate row, invalid number를 진단한다.
4. 전체 테스트와 index를 갱신한다.

금지사항

• metadata.json을 요구하지 마라. 이유: 승인된 reference 계약과 다르다.
• unknown column으로 필수 column 누락을 숨기지 마라. 이유: 잘못된 비교를 만든다.
• 내력/응력 파일이 없다는 이유로 adapter 구현을 생략하지 마라. 이유: 필수 루틴이다.