feat: define simulator data contracts

2026-08-28 09:07:58 +09:00
parent 4c5756a5a9
commit 582d0013e6
15 changed files with 2373 additions and 0 deletions
@@ -1,3 +1,12 @@
 # Schemas

 마이크 배열, scene, experiment, result의 versioned JSON Schema를 둡니다.
+
+JSON Schema Draft 2020-12 형식입니다.
+
+- `array.schema.json`: 배열 크기, 좌표계, 마이크 위치와 선택적 보정값
+- `scene.schema.json`: 재현 가능한 음원 recipe, asset 참조와 ground-truth 위치
+- `experiment.schema.json`: scan plane/grid, 주파수 대역, STFT와 DAS 설정
+- `result.schema.json`: 실행 환경, timing, peak와 평가 지표 요약
+
+중복 id, Nyquist, 시간 구간과 참조 무결성은 `packages/contracts/validation.js`에서 추가로 검증합니다.