docs: align feature guidance with adopted Refactor structure

This commit is contained in:
KOKO\Mimi
2026-10-18 03:35:15 +09:00
parent 7562d5a303
commit 0635cec53d
19 changed files with 224 additions and 29 deletions
+13 -3
View File
@@ -1,7 +1,7 @@
# FESA Structural Solver
FESA는 개인 연구를 위해 개발하는 유한요소 구조해석 솔버이며 외부 사용자 배포를 장기
목표로 한다. C++17 이상·Windows MSVC·CMake/CTest를 사용하고 승인된 Abaqus 입력
목표로 한다. C++17 이상·Windows MSVC·직접 MSBuild와 CMake/CTest를 사용하고 승인된 Abaqus 입력
subset에서 재현 가능한 해석과 HDF5 결과를 제공한다. 코드 존재와 기능 검증 완료는 다르다.
## 프로젝트 문서와 영역
@@ -39,8 +39,12 @@ subset에서 재현 가능한 해석과 HDF5 결과를 제공한다. 코드 존
│ └── hdf5/AGENTS.md → schema·readback·finalize
├── tests/
│ └── AGENTS.md → 계층별 검사·실패·비교 evidence
└── cmake/
└── AGENTS.md → dependency·runtime 연결
├── cmake/
│ └── AGENTS.md → dependency·runtime 연결
├── msvc/
│ └── AGENTS.md → 직접 MSBuild·source 등록·runtime 연결
└── scripts/
└── AGENTS.md → 읽기 전용 결과 비교 도구
```
## 핵심 규칙
@@ -87,3 +91,9 @@ Public header 변경은 대응하는 src 영역의 책임과 consumer까지 확
문서만 변경하면 정적 검토를 하고 build/test를 실행하지 않는다. 동작 변경은 관련 검사부터,
솔버 기능 완료 시에는 구성된 전체 MSVC x64 Debug build/CTest와 필수 reference 비교를 수행한다.
직접 MSBuild가 주 개발 빌드이며 CMake/Ninja는 같은 제품·검사 source를 사용하는 보조 경로다.
실제 명령·환경·`.build/native/Debug` 및 `.build/cmake-debug` 출력은 solver-core를 따른다.
두 경로의 세 검사 target 전체와 별도 Python suite·필수 reference 비교를 구분해 확인한다.
과거 Refactor의 정적 선별 실행 제한은 현재 전체 검증을 줄이는 근거가 아니다.
`reference/temp`는 검증에 사용하지 않는다. 정식 자료 누락은 미완료로 기록하고 통과로 바꾸지 않는다.