add uncommitted files

2026-07-29 23:32:26 +09:00
parent fb0f8f39a0
commit f5379472ce
80 changed files with 7461 additions and 1 deletions
@@ -0,0 +1,60 @@
+# Step 0: Result Database
+
+## 읽어야 할 파일
+
+- `/AGENTS.md`
+- `/docs/PRD.md`
+- `/docs/ARCHITECTURE.md`
+- `/docs/ADR.md`
+- `/include/fesa/model/domain.hpp`
+- `/include/fesa/core/diagnostic.hpp`
+
+## 작업
+
+HDF5와 독립적인 최소 Phase 1 result semantic model을 만든다.
+
+```cpp
+struct NodalFrame final {
+    std::vector<NodeId> node_ids;
+    std::vector<std::array<double, 6>> displacement;
+    std::vector<std::array<double, 6>> reaction;
+};
+struct ResultFrame final {
+    double step_time;
+    NodalFrame nodal;
+    std::vector<Diagnostic> diagnostics;
+};
+struct ResultStep final {
+    std::string name;
+    std::vector<ResultFrame> frames;
+};
+struct ResultDatabase final {
+    std::string schema_version;
+    std::vector<ResultStep> steps;
+};
+```
+
+- size mismatch, duplicate node, nonfinite field, duplicate step/frame을 실패 테스트로
+  먼저 작성한다.
+- 이 step에는 element result를 미리 만들지 않는다.
+
+## Acceptance Criteria
+
+```powershell
+cmake --build --preset windows-debug
+ctest --preset windows-debug -R "ResultDatabase|NodalFrame" --output-on-failure
+ctest --preset windows-debug --output-on-failure
+```
+
+## 검증 절차
+
+1. 유효/무효 result model 테스트를 먼저 실행한다.
+2. 불변 읽기 계약에 필요한 최소 저장만 구현한다.
+3. HDF5 include가 없는지 확인한다.
+4. 전체 테스트와 index를 갱신한다.
+
+## 금지사항
+
+- HDF5 handle을 result model에 넣지 마라. 이유: semantic/adaptor 경계를 깨뜨린다.
+- velocity, acceleration, temperature를 추가하지 마라. 이유: Phase 1에서 사용하지 않는다.
+- 빈 element output hierarchy를 만들지 마라. 이유: 필요한 phase에서만 실체화한다.