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

Step 3: Qualification Report

읽어야 할 파일

• /AGENTS.md
• /docs/PRD.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md
• /docs/formulation/timoshenko-beam-3d.md
• /docs/HDF5_SCHEMA.md
• /tests/unit/elements/
• /tests/reference/
• /tests/fixtures/reference/

작업

docs/VALIDATION.md에 Phase 1의 실제 검증 증거와 제한을 기록한다.

• analytical: axial, torsion, bending y/z, biaxial, shear-dominant, rigid body, rotated frame, slenderness sweep
• physics: equilibrium, symmetry, reaction, nonzero prescribed DOF
• determinism: tested thread counts와 repeated runs
• Abaqus: 현재 cantilever displacement/reaction의 tolerance와 maximum error
• contract-only: synthetic internal-force/stress CSV schema와 component mapping
• 미제공 Abaqus internal-force/stress는 not yet Abaqus-qualified라고 명시한다.

보고서 수치를 새 test output에서 수집하며 수동 추정값을 쓰지 않는다.

Acceptance Criteria

cmake --build --preset windows-debug
ctest --preset windows-debug --output-on-failure
ctest --preset windows-debug -R "Reference|Beam3D2|Determinism" --output-on-failure

모든 실행이 통과하고 보고서의 test 이름, tolerance, 최대오차와 disposition이 실제 출력과 일치해야 한다.

검증 절차

1. 전체 suite를 새로 실행한다.
2. 결과를 benchmark/quantity별 표에 기록한다.
3. synthetic coverage와 Abaqus-backed qualification을 명확히 분리한다.
4. index summary에 보고서 경로와 test counts를 기록한다.

금지사항

• 실행하지 않은 결과를 보고서에 쓰지 마라. 이유: 검증 증거가 아니다.
• Abaqus 내력/응력 qualification을 추론하지 마라. 이유: CSV가 아직 없다.
• 실패 테스트를 제외하거나 disable하지 마라. 이유: release gate를 약화한다.