Step 3: analysis-model-view

읽어야 할 파일

먼저 아래 파일들을 읽고 프로젝트의 아키텍처와 이전 step 산출물을 파악하라:

/AGENTS.md
/docs/PRD.md
/docs/ARCHITECTURE.md
/docs/ADR.md
/src/fesa/model/domain.hpp
/src/fesa/model/analysis_step.hpp
/tests/unit/model_domain_test.cpp

이전 step에서 만들어진 Domain과 AnalysisStep을 꼼꼼히 읽고, Domain 복사 없는 step view를 유지하라.

작업

현재 step에서 활성화되는 해석 객체 view를 제공하는 AnalysisModel을 /src/fesa/analysis/에 구현한다.

필수 파일:

/src/fesa/analysis/analysis_model.hpp
/tests/unit/analysis_model_view_test.cpp

필수 interface:

namespace fesa::analysis {

class AnalysisModel {
public:
    AnalysisModel(const model::Domain& domain, core::StepId step_id);

    const model::Domain& domain() const;
    const model::AnalysisStep& step() const;
    const std::vector<const model::Element*>& active_elements() const;
    const std::vector<const model::BoundaryCondition*>& active_boundary_conditions() const;
    const std::vector<const model::Load*>& active_loads() const;

    const model::Property* property_for(const model::Element& element) const;
    const model::Material* material_for(const model::Property& property) const;
};

} // namespace fesa::analysis

구현 규칙:

AnalysisModel은 Domain을 복사하지 않고 const reference 또는 pointer view만 보유한다.
Phase skeleton에서는 모든 Domain elements가 active라고 간주한다.
Boundary condition과 load는 선택된 AnalysisStep에서 가져온다.
property_for와 material_for는 Domain lookup을 사용한다.
없는 step id는 구조화된 exception 대신 std::invalid_argument로 실패해도 된다. 이 skeleton 단계에서는 별도 error hierarchy를 만들지 않는다.
AnalysisModel은 displacement, residual, equation number를 소유하지 않는다.

Tests To Write First

/tests/unit/analysis_model_view_test.cpp
- Domain에 node/element/material/property/step을 만든다.
- AnalysisModel(domain, step_id)가 원본 Domain reference를 유지함을 pointer identity로 확인한다.
- 모든 Domain element가 active_elements()에 const pointer로 나타난다.
- step의 boundary condition과 load가 active view에 const pointer로 나타난다.
- property_for(element)와 material_for(property)가 Domain 소유 객체를 반환한다.
- 없는 step id는 std::invalid_argument를 던진다.

RED 확인:

테스트 파일을 먼저 작성한다.
targeted CTest를 실행해 missing analysis_model.hpp로 실패함을 확인한다.
그 뒤 production header를 작성한다.

Acceptance Criteria

python -m unittest discover -s scripts -p "test_*.py"
python scripts/validate_workspace.py
ctest --test-dir build/msvc-debug --output-on-failure -C Debug -R analysis_model_view_test

검증 절차

위 AC 커맨드를 실행한다.
아키텍처 체크리스트를 확인한다:
- AnalysisModel이 Domain을 복사하지 않는가?
- AnalysisModel이 현재 step view만 제공하고 mutable state를 소유하지 않는가?
- active BC/load가 AnalysisStep에서 온 것임이 테스트되는가?
결과에 따라 phases/solver-core-skeleton/index.json의 step 3을 업데이트한다:
- 성공: "status": "completed", "summary": "AnalysisModel step view added without Domain copies"
- 3회 수정 시도 후 실패: "status": "error", "error_message": "구체적 에러 내용"
- 사용자 개입 필요: "status": "blocked", "blocked_reason": "구체적 사유" 후 중단

금지사항

DofManager나 equation numbering을 이 step에서 구현하지 마라.
AnalysisState를 이 step에서 구현하지 마라.
JavaScript/TypeScript/npm fallback을 추가하지 마라.

3.8 KiB Raw Blame History