승인된 Blender 컷의 실제 합성과 최종 검수 근거 추가

2026-10-10 04:11:08 +09:00
parent 78fcd49a54
commit ff28b7b47c
26 changed files with 6955 additions and 220 deletions
@@ -83,3 +83,18 @@ if ($LASTEXITCODE -ne 0) { throw '계약 회귀 검사 실패' }
 ```

 검사는 기존 1.0 예제·실제 제작 JSON, 새 1.1 빈 양식, 잘못된 버전·엔진·추가 키·검증 원본의 해시/버전 누락·프로필·시간을 다룬다. 의미 사례는 .blend의 media 위장, ID 중복·미존재 참조·Scene 불일치·9:16·루트 상대 경로·result=null 완료 금지를 다룬다. 전체 원본·미디어·승인·화면의 실제 검증은 각 단계의 실행 경로와 검토 근거로 확인한다. [1.1 연결 예제](../examples/blender-contract/README.md)는 실제 파일이 없는 요청 예제다.
+
+## 승인된 물 영상 Blender 컷의 실제 합성
+
+기존 Remotion + FFmpeg 설치와 패키지/잠금 파일을 유지한다. [제작 렌더러 안내](../projects/water-hydrogen-bond-surface-tension/renderer/README.md)의 현재 입력·실제 파일 검사를 먼저 실행한다. 저장소 루트의 PowerShell에서:
+
+```powershell
+npm.cmd --prefix projects/water-hydrogen-bond-surface-tension/renderer run check
+npm.cmd --prefix projects/water-hydrogen-bond-surface-tension/renderer run render -- compose
+& 'C:/Users/baram/anaconda3/python.exe' -B -X utf8 projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/verify_final.py
+& 'C:/Users/baram/anaconda3/python.exe' -B -X utf8 projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/mobile_views.py
+```
+
+새 compose는 현재 13 revision의 새 render-attempts 폴더에 실제 MP4/SRT와 입력/실측/최종 프레임 표본을 만들며 기존 파일을 재사용하거나 r1을 덮어쓰지 않는다. 실행기는 artifact/project·사용자 승인을 쓰지 않는다. 담당자가 실제 받은 결과 경로를 13에 연결한 뒤 verify_final을 실행한다. 현재 제출한 r2는 [13 검토](../projects/water-hydrogen-bond-surface-tension/stages/13-compose/r2/review.md)와 [14 검수](../projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/review.md)에 있다.
+
+이 제작의 verify_final은 제출한 r2 결과·렌더 당시 project 증거·현재 유효 선행 입력과 실제 파일을 검사한다. 총괄의 13/14 상태·final 기록 갱신은 렌더 시점 project 바이트와 구별하지만 원 WAV·컷·선행 artifact·합성 코드/패키지 SHA 변경은 거부한다. 새 합성 시도는 새 렌더 시점 project 증거와 결과를 담당자가 연결해야 한다. 기술 검사·모바일 표본·신호 대조를 정상 속도 전체 재생·청취나 사용자 final 승인으로 처리하지 않는다. 미검수 영역은 not_checked/incomplete로 제출하고 실제 완성본은 final 검토에 제공한다.
@@ -36,12 +36,19 @@
 - 남은 확인: 현재 세션은 오디오 입력을 지원하지 않으며 정상 속도 전체 시청·청취를 수행하지 못했다. 원 WAV에 대한 기존 사용자 청취 확인은 보존하되 최종 MP4의 청취 확인으로 바꾸지 않는다. 파일·신호·정지 표본 검사로 미검수 영역을 pass 처리하지 않았다.
 - 영향: 실제 13 출력과 14 보고는 사용자 final 검토에 제출할 수 있다. 13/14는 awaiting_review이며 14 추천은 incomplete다. 영상 파일 부재나 실행 경로 부재로 기다리는 상태가 아니다. 시청 중 실제 증상이 확인되면 시간/컷과 원인 단계로 돌아간다.

- 이후 사용자 피드백: 내용은 수용했으나 이미지 품질 변경을 요청해 Blender 3D로 전환했다. 현재 13/14 r1은 stale, 기존 final은 changes_requested다. 기존 결과·미청취 기록은 보존하며, 새 08·09 r2와 실제 3D 대표 샘플의 scenes 검토를 기다린다. 새 완성본의 재생·청취 확인은 전체 제작 후 다시 진행한다.
+- 이후 사용자 피드백: 내용은 수용했으나 이미지 품질 변경을 요청해 Blender 3D로 전환했다. 13/14 r1은 stale이고 기존 final의 changes_requested 피드백을 보존한다. 이후 수정한 07 r1·08 r3·09 r3가 실제 승인되어 정식 10–12 r2와 새 13/14 r2로 진행했다. 새 완성본은 실제 MP4/SRT가 있으며 아래 최종 재생·청취 대기 기록을 따른다.

-## 물 분자와 표시 체적의 포함 관계 — 해소, r3 장면 검토 대기
+## 물 분자와 표시 체적의 포함 관계 — 해소, r3 장면 승인

 - 대상: 08-scenes r2의 c16 Interface. [실제 사용자 피드백](../../projects/water-hydrogen-bond-surface-tension/history/scenes-r2-feedback.md)을 보존했다.
 - 확인: PNG에서 하단 분자가 물 영역 실루엣 밖에 보인다. 작성 코드의 WaterCutawayBody 범위는 y=0.95–2.45, z=-2.65–0.35인데 분자는 앞쪽 y에 배치돼 있고 하단 원자 일부도 z 범위를 벗어난다. 설명용 절개라는 문구로 표시 체적과 분자의 실제 포함 관계 오류를 정당화할 수 없다.
 - 영향: r2 시각 품질 통과 판단을 취소하고 08·09 r3를 작성한다. 기존 대본·WAV·r2 결과를 보존하며 전체 제작은 시작하지 않는다.
 - 수정·검증: 실제 물 영역과 절개 화면을 맞추고, 분자 중심이 아닌 평가된 전체 원자·결합 mesh를 Interface의 모든 프레임에서 검사한다. 기존 원본 RED와 수정 GREEN, 실제 새 PNG·MP4·모바일 화면으로 확인한다.
- 해소: r3의 실제 앞면·윗면 열린 절개 안에 분자·결합을 배치했다. 전체 705프레임·평가 정점 11,747,388개가 물 체적과 실제 네 표시 면의 투영 영역 안에 포함된다. 기존 r2와 중심을 유지한 원자 정점 오류는 정확한 포함 assertion으로 종료 1, 수정 원본은 종료 0이다. 실제 새 c16 MP4 전체 디코드와 시작·중간·마지막·모바일 화면에서도 돌출이 없음을 확인했다. 이전 r2 실물 75개와 전환 전 기준 36개 파일은 SHA-256 동일하다. [새 검토](../../projects/water-hydrogen-bond-surface-tension/stages/08-scenes/r3/review.md)는 사용자 scenes 승인을 기다리며 전체 제작 완료로 처리하지 않는다.
+- 해소: r3의 실제 앞면·윗면 열린 절개 안에 분자·결합을 배치했다. 전체 705프레임·평가 정점 11,747,388개가 물 체적과 실제 네 표시 면의 투영 영역 안에 포함된다. 기존 r2와 중심을 유지한 원자 정점 오류는 정확한 포함 assertion으로 종료 1, 수정 원본은 종료 0이다. 실제 새 c16 MP4 전체 디코드와 시작·중간·마지막·모바일 화면에서도 돌출이 없음을 확인했다. 이전 r2 실물 75개와 전환 전 기준 36개 파일은 SHA-256 동일하다. [새 검토](../../projects/water-hydrogen-bond-surface-tension/stages/08-scenes/r3/review.md)는 이후 실제 “수정본을 승인합니다” 응답으로 승인됐고 정식 10–12 r2를 제작했다. 최종 사용자 승인과는 구분한다.
+
+## 새 3D 완성본의 전체 재생·청취 — final 검토 대기
+
+- 대상: [13 r2 실제 MP4/SRT](../../projects/water-hydrogen-bond-surface-tension/stages/13-compose/r2/review.md)와 [14 r2 여섯 영역 보고](../../projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/review.md).
+- 완료한 확인: 실제 1080×1920·50fps·5528F·110560ms, 31컷/38 SRT 원문·시간, 전체 AV 디코드·원 WAV/AAC 신호·원 입력 SHA 및 실제 최종 163프레임/모바일 표본 관찰. c02의 공중 연결선은 별도 전체 시도로 수정했고 첫 시도는 보존한다.
+- 남은 범위: 현재 세션 오디오 입력 미지원과 정상 속도 전체 연속 재생 미확인으로 visual/audio/captions 전체 판정은 not_checked, 추천은 incomplete다. 원 WAV의 기존 사용자 수용을 새 MP4의 청취 승인으로 바꾸지 않는다.
+- 영향: 실제 파일·검토 근거가 준비돼 13/14 awaiting_review를 제안하며 사용자 final 검토를 기다린다. 확인된 결함으로 재생성을 요구하거나 파일 부재로 실행을 멈춘 상태가 아니다. 시청에서 증상이 있으면 실제 시간/컷과 원인 단계의 새 버전으로 돌아간다.
@@ -15,15 +15,18 @@ JSON·TOML·스킬 형식과 링크·단계 참조를 실제 명령으로 확인

 Codex CLI의 존재·버전은 확인했지만 새 세션에서 사용자 지정 역할·스킬의 자동 탐색은 아직 확인하지 않았다. 물 제작의 기존 06 r1에는 사용자 수용 응답과 실제 Qwen3-TTS WAV·실측 구간이 있으며, 기존 13 r1에는 실제 합성 MP4/SRT가 있다. 이 기존 결과의 전체 재생·청취 검수는 완료로 기록하지 않는다.

-Blender 5.2.2에서 작은 검사 씬의 EEVEE/GPU와 Cycles/CPU 렌더·PNG/MP4 전체 디코드를 확인했다. EEVEE의 50fps 실행과 Cycles/OPTIX GPU 정지 렌더도 확인했다. 검사 씬은 물 영상의 품질 승인 근거가 아니다. 실행기의 14개 회귀 검사와 10개 계약 검사는 통과했으며, 미승인 제작·누락 파일·잘못된 참조·이전 시각 버전 혼입을 거부한다.
+Blender 5.2.2에서 작은 검사 씬의 EEVEE/GPU와 Cycles/CPU 렌더·PNG/MP4 전체 디코드를 확인했다. EEVEE의 50fps 실행과 Cycles/OPTIX GPU 정지 렌더도 확인했다. 검사 씬은 물 영상의 품질 승인 근거가 아니다. 실행기의 17개 회귀 검사와 10개 계약 검사는 통과했으며, 미승인 제작·누락 파일·잘못된 참조·이전 시각 버전 혼입을 거부한다.

-물 제작은 01–07 r1과 승인된 WAV를 유지한다. 사용자가 지적한 r2의 분자·물 영역 포함 관계 오류를 앞선 시각 검수가 놓쳤으며 [r2 피드백](../../projects/water-hydrogen-bond-surface-tension/history/scenes-r2-feedback.md)을 보존했다. 새 08·09 r3에서 실제 영역과 전체 원자·결합을 수정하고 705프레임 전체 mesh 정점 및 실제 표시 면의 투영 영역 검사를 통과했다. 실제 새 대표 PNG·MP4 각각 3개와 직접 관찰 근거를 [r3 장면 검토](../../projects/water-hydrogen-bond-surface-tension/stages/08-scenes/r3/review.md)에 제출한다. 현재 r3는 awaiting_review, scenes 결정은 pending이고 기존 10–14 r1은 stale이다. [전환 전 진행 기록](../../projects/water-hydrogen-bond-surface-tension/history/pre-blender-project.json)과 r2 결과·미디어도 보존한다.
+물 제작은 01–07 r1과 승인된 WAV를 유지한다. 사용자가 지적한 r2의 분자·물 영역 포함 관계 오류를 앞선 시각 검수가 놓쳤으며 [r2 피드백](../../projects/water-hydrogen-bond-surface-tension/history/scenes-r2-feedback.md)을 보존했다. 새 08·09 r3에서 실제 영역과 전체 원자·결합을 수정하고 705프레임 전체 mesh 정점 및 실제 표시 면의 투영 영역 검사를 통과했다. 실제 새 대표 PNG·MP4 각각 3개와 직접 관찰 근거를 [r3 장면 검토](../../projects/water-hydrogen-bond-surface-tension/stages/08-scenes/r3/review.md)에 제출한다. 사용자가 07 r1·08 r3·09 r3에 “수정본을 승인합니다”라고 응답해 scenes가 approved이며 정식 10–12 r2를 제작했다. 기존 10–14 r1은 stale로 보존한다. [전환 전 진행 기록](../../projects/water-hydrogen-bond-surface-tension/history/pre-blender-project.json)과 r2 결과·미디어도 보존한다.

-## 다음 구현
+## 새 3D 완성본과 남은 검토

-1. 준비된 물 영상의 새 3D 장면 설계와 대표 PNG·짧은 MP4에 대해 실제 scenes 검토를 받는다.
-2. 해당 승인 후 기준 모델·62개 끝점 ID·31개 실제 컷 영상을 새 버전으로 제작한다.
-3. 기존 Remotion + FFmpeg로 새 컷과 기존 음성·38개 자막을 합성하고 실제 여섯 영역 검수와 final 검토를 진행한다.
-4. 다른 소재의 장면 제작은 이 범용 실행 경로를 사용하되 소재별 모델과 근거를 별도로 작성한다.
+승인된 10 r2의 기준 모델, 11 r2의 62끝점 ID·실제 앵커, 12 r2의 31무음 MP4로 새 13 r2 MP4/SRT를 만들었다. 원 대본·제목·WAV·38자막은 유지했다. 실제 완성본은 1080×1920·50fps·5528프레임·110560ms이며 전체 AV 디코드·원 WAV/AAC 신호·모든 컷과 자막/주석 전환의 실제 최종 163표본을 확인했다. 합성 입력 검사의 24개 거부 사례도 통과한다.

-대표 영상의 실제 디코드 화면 비교에서 비활성 Scene의 애니메이션이 정지하는 문제를 발견했고, 렌더 전에 선택 Scene을 활성화하도록 수정했다. 초기 활성 Scene이 Idle인 같은 원본에서 두 장면의 PNG·MP4 실제 RGB 움직임 검사가 실패→통과로 바뀌었으며 독립 검토도 통과했다. 물 대표 렌더는 수정된 실행기로 재제작하고 실제 움직임을 확인했다. 전체 컷 제작·새 완성본 검수는 scenes 승인 후의 후속 작업이다.
+[새 합성 검토](../../projects/water-hydrogen-bond-surface-tension/stages/13-compose/r2/review.md)와 [여섯 영역 보고](../../projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/review.md)를 사용자 final 검토에 제출한다. 정상 속도 전체 시청·청취는 현재 세션에서 확인하지 못해 visual/audio/captions는 not_checked, 추천은 incomplete다. 13/14는 awaiting_review를 제안하며 새 final 승인이나 제작 완료를 기록하지 않았다. 영상 실행·파일 부재로 멈춘 상태는 아니다.
+
+1. 실제 새 MP4의 정상 속도 전체 재생·청취와 사용자 final 검토를 마친다.
+2. 증상이 발견되면 실제 시간/컷과 원인 단계의 새 버전으로 수정한다.
+3. 다른 소재는 같은 실행 경로를 사용하되 별도 근거·모델·장면을 작성한다.
+
+대표 영상의 실제 디코드 화면 비교에서 비활성 Scene의 애니메이션이 정지하는 문제를 발견했고, 렌더 전에 선택 Scene을 활성화하도록 수정했다. 초기 활성 Scene이 Idle인 같은 원본에서 두 장면의 PNG·MP4 실제 RGB 움직임 검사가 실패→통과로 바뀌었으며 독립 검토도 통과했다. 물 대표 렌더는 수정된 실행기로 재제작하고 실제 움직임을 확인했다. 이후 실제 r3 scenes 승인 뒤 정식 10–12 r2와 새 13/14 r2로 진행했다. 정상 속도 전체 재생·청취와 새 final 승인은 남아 있다.
@@ -20,7 +20,7 @@ JSON 34개 중 데이터 양식·예제 30개는 해당 스키마로 검증했

 ## Blender 전환 진행 중 검사

-아래는 초기 기반 검사 이후 실제 실행한 추가 검사다. 기존 물 제작의 WAV와 r1 결과를 보존하고 새 3D 대표 렌더를 준비하는 중이며, 정식 전체 제작·새 완성본의 검사 기록은 아직 없다.
+아래는 초기 기반 검사 이후 실제 실행한 추가 검사다. 기존 물 제작의 WAV와 r1 결과를 보존하고 새 3D 대표 렌더를 준비하는 중이며, 당시 정식 전체 제작·새 완성본 검사는 아직 없었다. 이후 실제 기록은 아래 새 완성본 절에 추가한다.

 | 실제 실행 | 종료 코드 | 확인한 내용 |
 | --- | --- | --- |
@@ -65,4 +65,25 @@ JSON 34개 중 데이터 양식·예제 30개는 해당 스키마로 검증했
 | 실제 새 MP4 3개 probe·전체 디코드·프레임 추출 | 0 | 50fps·1080×1920·202/244/200프레임·4040/4880/4000ms. 실제 9프레임·모바일 화면에서 돌출 없음과 움직임 직접 확인 |
 | 기존 작업 루트의 실물·이력 SHA-256 대조 | 0 | 새 실물 25개 동일, 이전 r2 파일 75개·전환 전 기준 36개 변경 없음 |

-최소 모델 축 여백은 0.3246/0.4540/0.1150, 투영 윤곽 여백은 47.94px다. 설명 모형·카메라의 검사 수치이며 과학적 측정값이나 최종 자막·플랫폼 안전영역 보증이 아니다. 사용자 scenes refs는 07 r1·08 r3·09 r3이고 결정은 pending이다.
+최소 모델 축 여백은 0.3246/0.4540/0.1150, 투영 윤곽 여백은 47.94px다. 설명 모형·카메라의 검사 수치이며 과학적 측정값이나 최종 자막·플랫폼 안전영역 보증이 아니다. 당시 사용자 scenes refs는 07 r1·08 r3·09 r3이고 결정은 pending이었다. 이후 실제 “수정본을 승인합니다” 응답으로 approved가 되어 정식 전체 제작을 진행했다.
+
+## 승인된 Blender 전체 컷과 새 완성본
+
+2026-10-10 확인. 07 r1·08 r3·09 r3의 실제 사용자 scenes 승인 이후 정식 10/11/12 r2를 사용했다. 원 대본·제목·WAV·38자막·스타일과 r1 피드백은 보존했다. 설치·Blender 모델/원 컷 재렌더·전역 설정 변경은 합성 작업에서 실행하지 않았다.
+
+| 실제 실행 | 종료 코드 | 확인한 내용 |
+| --- | --- | --- |
+| 렌더러 폴더의 첫 `npm.cmd run check` | 1 (RED) | r1 고정 승인 검사에서 실제 승인 r3를 거부하는 `3 !== 1` 재현 |
+| 같은 폴더의 최종 `npm.cmd run check` | 0 | 실제 원본/PNG/MP4/WAV·현재 포인터/승인·SHA·시간과 24거부 사례. 31컷·62끝점·38자막·5528F |
+| `npm.cmd run render -- preview c01 c05 c09 c16 c19 c24 c27 c31` | 0 | 실제 새 MP4/앵커를 사용한 합성 화면 24표본. 최종 검수와 구분 |
+| `npm.cmd run render -- compose` 두 전체 시도 | 각각 0 | 실제 MP4/SRT 생성. 첫 c02의 빈 확대 위치 연결선을 최종 디코드 화면에서 발견·수정해 새 시도로 전체 재출력 |
+| `C:/Users/baram/anaconda3/python.exe -B -X utf8 projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/verify_final.py` | 0 | 실제 최종 H.264/AAC·1080×1920·50fps·5528F·0–110560ms, 전체 AV 디코드, 원 8단위/통합 PCM 동일, SRT 38원문/시간 정확 동일·입력/렌더러 SHA 유지 |
+| 같은 Python의 `projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/mobile_views.py` | 1→0 | cut 접두사가 caption까지 포함하는 파생 판 분류 오류 RED→GREEN. 실제 최종 93컷/38자막/32주석 전환 표본을 360px 검사 판 16/7/6개로 확인 |
+| `C:/Users/baram/anaconda3/python.exe -B -X utf8 tools/blender/test_runner.py` | 0 | 기존 실행기 회귀 17개 |
+| `C:/Users/baram/anaconda3/python.exe -B -X utf8 contracts/check.py` | 0 | 계약 회귀 10개 |
+
+채택 MP4는 6,117,533바이트, SHA-256 `c36bfe927acffde38d60d5068cfc1acc22784bc4d4fdd30ca015bb141f919ce6`이다. [13 실제 경로·입력·실측](../../projects/water-hydrogen-bond-surface-tension/stages/13-compose/r2/provenance.json)과 [14 기술 검사](../../projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/technical-check.json)를 따른다. 원 WAV 2653440샘플과 디코드 AAC의 원 길이 구간 상관계수 0.9999665011969985, SNR 41.68737842978274dB다. AAC 끝의 패딩 768샘플은 원 발화 길이와 구별하며 원 WAV·속도·gain·trim은 바꾸지 않았다.
+
+실제 최종 163프레임·29모바일 검사 판에서 전하 대상·원자/결합·물 영역 포함·같은 양/별도 비교 조건·확대개념도·글자/가림과 22 continuous/8 cut 연결을 직접 확인했다. 소스 프레임 검사를 최종 영상 검사로 대체하지 않았다. 정상 속도 전체 재생·청취 및 플랫폼 앱 UI는 미확인이므로 [14 보고](../../projects/water-hydrogen-bond-surface-tension/stages/14-review/r2/review.md)의 해당 영역은 not_checked, 추천은 incomplete다. 새 final 승인 전에는 제작 완료가 아니다.
+
+렌더 당시 project 바이트는 별도 render-time-project.json에 보존했다. 이 증거 SHA와 현재 brief/settings/01–12 포인터·상태 및 topic/story/scenes 승인을 엄격히 대조한다. 총괄의 같은 13/14 포인터에 대한 정상 상태 변경과 final 검토 갱신을 입력 원본 변경과 구별한다. 기존/실패 시도·캐시·이전 r1을 삭제하지 않았다.