Find-Word/.agent/ACCEPTANCE-v0.2.3.md

Find-Word v0.2.3 수용 기준

버전·문서

• package.json/package-lock.json/index.html/UI/README가 0.2.3이다.
• CHANGELOG.md가 존재하고 v0.2.3의 모든 요구사항·오류 수정·자산·검증 변경을 설명한다.
• 정확한 Designed by OZ at Heat-T Medical Inc.를 보존한다.
• README, ARCHITECTURE, DEPLOYMENT, 오디오 provenance가 새 동작과 일치한다.
• 직접 변경한 모듈·함수·클래스·핵심 변수/매개변수·비자명한 로직에 목적 중심의 상세 한국어 주석이 있다.

3문항·난이도

• createQuestions는 라운드당 정확히 3개의 서로 다른 문제를 반환한다.
• 시작 난이도 1~5를 명시적으로 받으며 3문항이 모두 같은 level/db로 생성된다.
• 정상 완료 후 다음 단계 3문항을 시작할 수 있고 5단계 경계를 넘지 않는다.
• 진행률, 안내문, 결과 분모에 하드코딩된 10이 남지 않는다.
• mixed 모드가 3문항에서도 choice와 text를 모두 포함한다.

수준/SNR 직접 조절

• 시작 화면에서 시작 난이도 1~5를 선택할 수 있다.
• 사용자가 배경 대비 목표 음성 SNR dB를 직접 조절할 수 있다.
• 허용 범위 밖·NaN 값은 안전한 범위/기본값으로 정규화한다.
• 변경 값은 현재 문제의 재청취와 남은 라운드 문항에 일관되게 적용된다.
• 화면에 양/0/음수 dB 의미와 현재 값을 정확히 설명한다.

중도 종료

• loading/playing/answer/feedback 어느 단계에서도 종료할 수 있다.
• 종료 즉시 fetch/Web Audio source/timer가 취소되고 늦은 완료 이벤트가 상태를 되살리지 않는다.
• 중도 종료 결과가 정답 수/응답 수를 표시하고 무응답을 오답으로 세지 않는다.
• 결과에서 초기 화면으로 돌아가며 새 라운드에 이전 답·오디오·난이도 override가 새지 않는다.

실제 배경음

• 8개 Environment 각각 고유 same-origin 정적 WAV URL을 가진다.
• 정확히 8개 실제 현장 녹음 WAV가 빌드에 포함된다.
• 8개 모두 24,000Hz mono PCM16이며 non-silent이고 hash가 서로 다르다.
• manifest/provenance에 environment id, 표시 이름, source page/direct URL, creator, license, attribution, conversion, source SHA-256, output SHA-256, bytes, duration, RMS, peak가 있다.
• 라이선스가 수정·공개 재배포를 허용하며 attribution/notice가 dist에도 포함된다.
• 실제 엔진은 procedural synth가 아니라 선택한 environment 파일을 fetch/decode/loop한다.
• 404/decode/timeout/abort 오류가 복구 가능한 한국어 메시지로 처리된다.
• 배경과 목표는 각각 RMS 정규화 후 gain = 10^(dB/20)의 상대 비율을 사용하고 clipping headroom을 유지한다.
• 외부 runtime 요청이 0이며 누락 배경/음성 경로는 SPA HTML이 아니라 404다.

회귀·품질

• 기존 10개 mechanic/100개 목표 문장/101개 neural voice assets를 보존한다.
• 객관식·주관식·mixed, 채점, 점수, 재청취, IME 보호, 볼륨, 접근성이 동작한다.
• lint/typecheck, unit/component/Python tests, build verifier, npm audit가 통과한다.
• sandboxed system Chrome desktop/mobile browser suite가 실제 목표·배경 WAV를 decode/play한다.
• 브라우저에서 3문항 완료 → 다음 난이도, 시작 난이도 변경, SNR 변경, 재생 중 종료, 답변 후 종료, 초기화 흐름을 검증한다.
• console/page errors, failed requests, 외부 페이지 요청, axe 위반이 0이다.
• desktop/mobile start/game/normal-results/early-exit screenshots를 생성한다.
• 비밀정보 검사 0, production build에 runtime dependency 및 ambience attribution notice가 포함된다.

릴리스

• Neo 독립 검증 후 feature branch를 push한다.
• main fast-forward merge, annotated tag v0.2.3, fresh-clone readback을 완료한다.
• findword.heart-m.com에 commit-addressed release로 원자 배포하고 기존 release를 rollback 대상으로 보존한다.
• 공개 서비스에서 버전, 배경/목표 MIME·hash, cache-busting, 3문항·다음 단계·중도 종료를 실제 Chrome으로 검증한다.