docs: make reference metadata optional

This commit is contained in:
KOKO\Mimi
2026-08-12 02:22:01 +09:00
parent f28dbd7e42
commit 2bd297d84b
24 changed files with 127 additions and 95 deletions
@@ -430,8 +430,9 @@ Abaqus `.inp` 자체에는 단위 선언이 없으므로 일반 solver run의 un
`user-consistent-unspecified`로 기록하고 solver가 입력 파일만 보고 SI를 추론하지
않는다. 승인된 cantilever B33 reference에 한해서는 이 설계와 후속 Reference Model
Contract가 입력 수치의 단위계를 SI로 선언하고, reference verification이 동일한 입력으로
생성된 FESA 결과에 그 외부 단위 계약을 적용한다. 새 reference model은 별
`metadata.json`에 단위계를 선언해야 한다.
생성된 FESA 결과에 그 외부 단위 계약을 적용한다. 새 reference model도 승인된
Reference Model Contract에 단위계를 선언한다. 선택 `metadata.json`이 존재하면 그
단위 선언을 read-only 보조 자료로 계약과 대조한다.
- displacement: `[node_count, 6]`
- reaction: `[node_count, 6]`
@@ -575,11 +576,12 @@ step time 1.0 계약으로 해석한다.
| stress | N/A: beam stress reference comparison은 승인 범위에서 제외 |
이 기존 bundle의 space-containing filename과 CAE report header는 승인된 legacy alias로
그대로 지원하며 reference artifact를 rename하거나 rewrite하지 않는다. `metadata.json`
`README.md`는 이 baseline에 한해서 N/A다. 이 설계와 Step 5의 Reference Model Contract가
대신 model ID, provenance, units, coordinate system, schema, file inventory, tolerance와
stress N/A 사유를 기록한다. 이후 추가하는 reference model에는 canonical artifact 이름,
`metadata.json`, `README.md` 요구한다.
그대로 지원하며 reference artifact를 rename하거나 rewrite하지 않는다. `README.md`는 이
baseline에 한해서 N/A다. `metadata.json`은 프로젝트 전역에서 선택 artifact이며 이
bundle에는 존재하지 않는다. 이 설계와 Step 5의 Reference Model Contract가 model ID,
provenance, units, coordinate system, schema, file inventory, tolerance와 stress N/A 사유를
기록한다. 이후 추가하는 reference model에는 canonical artifact 이름과 `README.md`
요구하며, 선택 `metadata.json`이 존재하면 계약과 대조한다.
Reference verification은 build/test gate 통과 후 승인 input으로 FESA `results.h5`
생성하고 다음을 직접 비교한다.
@@ -592,8 +594,9 @@ Reference verification은 build/test gate 통과 후 승인 input으로 FESA `re
Artifact check는 네 파일의 존재, B33 element type, expected header, 유일한 row key,
finite value를 확인한다. 하나라도 충족하지 않으면 `needs-reference-artifacts` 또는
`schema-mismatch`로 분류하고 comparison을 시작하지 않는다. 현재 baseline은
`metadata.json` 또는 `README.md` 부재만으로 차단하지 않는다.
`schema-mismatch`로 분류하고 comparison을 시작하지 않는다. `metadata.json` 부재는 모든
bundle에서 허용되며, 현재 baseline의 `README.md` 부재도 승인된 legacy 예외로 차단하지
않는다.
Agent와 Harness는 Abaqus를 실행하거나 reference artifact를 생성·수정하지 않는다.