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

Step 2: Linear Static Analysis

읽어야 할 파일

• /AGENTS.md
• /docs/PRD.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md
• /include/fesa/model/domain.hpp
• /include/fesa/fem/dof_manager.hpp
• /include/fesa/assembly/
• /include/fesa/constraints/
• /include/fesa/solvers/linear/
• /include/fesa/results/result_database.hpp

작업

기존 production 모듈을 조율하는 LinearStaticAnalysis lifecycle을 구현한다.

struct AnalysisRunResult final {
    bool succeeded;
    std::optional<ResultDatabase> results;
    std::vector<Diagnostic> diagnostics;
};
class LinearStaticAnalysis final {
public:
    [[nodiscard]] AnalysisRunResult run(const Domain&) const;
};

• parser나 HDF5를 호출하지 않고 이미 검증된 Domain을 입력받는다.
• DofManager, pattern/assembly, BC elimination, PARDISO, full reconstruction, reaction recovery, nodal ResultDatabase 순서로 실행한다.
• hand-check 가능한 한 요소 Domain으로 변위, 반력, residual을 먼저 테스트한다.

Acceptance Criteria

cmake --build --preset windows-debug
ctest --preset windows-debug -R "LinearStaticAnalysis|StaticEquilibrium" --output-on-failure
ctest --preset windows-debug --output-on-failure

검증 절차

1. analysis test가 연결 누락으로 실패하는 것을 확인한다.
2. orchestration만 구현하고 수치 kernel을 복제하지 않는다.
3. (Ku-f-r) 평형과 finite result를 검사한다.
4. 전체 테스트와 index를 갱신한다.

금지사항

• CLI option parsing을 analysis에 넣지 마라. 이유: application 경계를 깨뜨린다.
• nonlinear loop나 여러 step을 추가하지 마라. 이유: Phase 1 범위 밖이다.
• test-only solver 경로를 만들지 마라. 이유: production pipeline을 검증해야 한다.