feat: add realistic portable localization core

schemas/README.md

@@ -4,9 +4,17 @@
 
 JSON Schema Draft 2020-12 형식입니다.
 
-- `array.schema.json`: 배열 크기, 좌표계, 마이크 위치와 선택적 보정값
-- `scene.schema.json`: 재현 가능한 음원 recipe, asset 참조, 정적 위치와 선택적 trajectory
+- `array.schema.json`: 배열 크기, 좌표계, 마이크 위치와 선택적 scalar/주파수 응답 보정값
+- `scene.schema.json`: 음원 recipe, asset·trajectory와 선택적 sparse shoebox 음향 환경
 - `experiment.schema.json`: scan plane/grid, 주파수 대역, STFT/DAS와 peak 검출 임계값
 - `result.schema.json`: raw/display/후처리 map, 복수 peak, 비확률 beam spread, timing과 평가 지표
 
-중복 id, Nyquist, 시간 구간과 참조 무결성은 `packages/contracts/validation.js`에서 추가로 검증합니다.
+마이크 주파수 응답점은 배열 계약 자체이므로 특정 Scene의 Nyquist와 결합하지 않고 0~1 MHz의
+안전 범위에서 엄격한 오름차순을 요구합니다. 실제 분석에서는 선택한 Scene/STFT의 bin 주파수만
+보간합니다. 중복 id, Nyquist, 시간 구간과 참조 무결성은
+`packages/contracts/validation.js`에서 추가로 검증합니다.
+
+Scene `acoustics`는 기본 `free-field` 또는 `shoebox`입니다. shoebox는 room bounds, 0/1차
+반사와 scattering 비율, bounded diffuse tail, 최대 8개의 AABB occluder를 저장합니다.
+room·occluder의 각 축은 `min < max`여야 하고 source/trajectory와 occluder는 room 안에
+있어야 합니다. 이 계약은 전체 파동 해석이 아니라 sparse path 근사의 입력입니다.