modify docu

docs/io-definitions/README.md

@@ -4,11 +4,11 @@
 
 FESA 솔버의 입력 파일은 Abaqus input file이다. 다만 초기 FESA는 Abaqus 전체 문법 호환을 목표로 하지 않고, 기능별로 지원할 Abaqus keyword subset과 내부 모델 매핑을 명확히 정의한다.
 
-기본 파일명은 `docs/io-definitions/<feature-id>-io.md` 형식을 사용한다. 각 문서는 Requirement Agent, Formulation Agent, Numerical Review Agent의 산출물을 입력으로 받아 Abaqus `.inp` 입력 계약, authoritative HDF5 result schema, deterministic CSV view schema를 정의해야 한다.
+기본 파일명은 `docs/io-definitions/<feature-id>-io.md` 형식을 사용한다. 각 문서는 Requirement Agent, Formulation Agent, Numerical Review Agent의 산출물을 입력으로 받아 Abaqus `.inp` 입력 계약, authoritative HDF5 result schema, FESA HDF5 to Reference CSV comparison schema를 정의해야 한다.
 
 ## I/O Definition Agent 역할
 
-I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, output request mapping, HDF5 result schema, comparison CSV view schema를 정의한다.
+I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, output request mapping, HDF5 result schema, reference CSV comparison row schema를 정의한다.
 
 수행한다:
 - 기능별 supported Abaqus keyword subset을 정의한다.
@@ -16,13 +16,13 @@ I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, o
 - model data와 history data를 내부 solver 개념으로 매핑한다.
 - node, element, set, material, section, boundary condition, load, step, output request의 의미 계약을 정의한다.
 - `results.h5`의 authoritative HDF5 schema를 정의한다.
-- `csv/displacements.csv`, `csv/reactions.csv`, `csv/element_forces.csv`, `csv/stresses.csv` deterministic CSV view schema를 정의한다.
+- FESA HDF5 dataset을 `reference/<model-id>/` 아래 Abaqus reference CSV rows와 비교하기 위한 deterministic row schema를 정의한다.
 
 수행하지 않는다:
 - parser를 구현하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference HDF5 파일이나 deterministic CSV view를 생성하지 않는다.
+- Abaqus reference CSV 파일을 생성하거나 수정하지 않는다.
 - solver 결과와 reference 결과를 비교하지 않는다.
 - release readiness를 승인하지 않는다.
 - 명시적으로 정의되지 않은 Abaqus full compatibility를 주장하지 않는다.
@@ -123,18 +123,20 @@ I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, o
 | element_force | /steps/<step>/frames/<frame>/field_outputs/element_forces | <nrow, ncomp> | float64 | component_names, element_ids, location | element | feature-dependent |
 | stress | /steps/<step>/frames/<frame>/field_outputs/S | <nrow, ncomp> | float64 | component_names, element_ids, integration_points | integration_point | feature-dependent |
 
-## Deterministic CSV View Schemas
+## FESA HDF5 to Reference CSV Comparison Schema
 
-CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 authoritative storage가 아니다.
+FESA solver output은 `results.h5`이다. Comparison tooling reads required HDF5 datasets and maps them to deterministic row records that can be matched against Abaqus reference CSV files under `reference/<model-id>/`.
 
 공통 규칙:
-- directory: `csv/`
+- reference_root: `reference/<model-id>/`
+- hdf5_schema_version: <version>
+- reference_csv_schema_version: <version>
 - sort_order: step, frame, id, location, component
 - numeric_format: <precision and exponent policy>
 - missing_component_policy: 0 | N/A | omitted, feature-specific
-- view_source: HDF5 dataset path를 각 파일 metadata 또는 report에 기록한다.
+- hdf5_dataset_source: HDF5 dataset path를 각 row schema 또는 report에 기록한다.
 
-### csv/displacements.csv
+### displacement rows / `<model-id>_displacements.csv`
 | column | type | description |
 | --- | --- | --- |
 | step | string | step name or index |
@@ -144,7 +146,7 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 | uy | float | displacement component or 0/N/A |
 | uz | float | displacement component or 0/N/A |
 
-### csv/reactions.csv
+### reaction rows / `<model-id>_reactions.csv`
 | column | type | description |
 | --- | --- | --- |
 | step | string | step name or index |
@@ -154,7 +156,7 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 | rfy | float | reaction component or 0/N/A |
 | rfz | float | reaction component or 0/N/A |
 
-### csv/element_forces.csv
+### internal force rows / `<model-id>_internalforces.csv`
 | column | type | description |
 | --- | --- | --- |
 | step | string | step name or index |
@@ -164,7 +166,7 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 | component | string | force component name |
 | value | float | component value |
 
-### csv/stresses.csv
+### stress rows / `<model-id>_stresses.csv`
 | column | type | description |
 | --- | --- | --- |
 | step | string | step name or index |
@@ -183,7 +185,7 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 - coordinate_conventions: <policy>
 - output_quantity_availability: <policy>
 - hdf5_schema_validation: <required datasets and attributes>
-- csv_view_validation: <stable ordering and required columns>
+- reference_csv_validation: <stable ordering and required columns>
 
 ## Open Issues and Downstream Handoff
 
@@ -191,10 +193,10 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 - <Abaqus input examples and reference artifact schema needs>
 
 ### Implementation Planning Agent
-- <parser acceptance cases, unsupported keyword diagnostics, HDF5 writer tests, CSV view exporter tests>
+- <parser acceptance cases, unsupported keyword diagnostics, HDF5 writer tests, comparison row mapping tests>
 
 ### Reference Verification Agent
-- <HDF5 dataset paths, CSV view schemas, ID matching rules, units, coordinate conventions, tolerance-relevant fields>
+- <HDF5 dataset paths, reference CSV row schemas, ID matching rules, units, coordinate conventions, tolerance-relevant fields>
 ```
 
 ## 품질 기준
@@ -206,4 +208,4 @@ CSV view는 HDF5 dataset에서 추출한 deterministic comparison view이며 aut
 - 내부 모델 계약은 semantic fields로 작성하고 C++ class/function/API를 확정하지 않는다.
 - `results.h5`가 authoritative solver output임을 명시해야 한다.
 - HDF5 schema는 dataset path, dtype/shape, required attributes, ID field, component naming, coordinate system, units, step/frame identity, quantity location을 포함해야 한다.
-- CSV view schema는 column name, stable sort order, ID field, component naming, coordinate system, units, step/frame identity, quantity location을 포함해야 한다.
+- Reference CSV comparison row schema는 column name, stable sort order, ID field, component naming, coordinate system, units, step/frame identity, quantity location을 포함해야 한다.