fix: Task #520 partial revert restore — exam_science p2 7번 글상자 ㉠ 사각형 y 회귀 정정 (closes #624)

[planet6897]

Summary

PR #561 cherry-pick (3de0505) 시 Task #520 의 일부 정정 누락 (3 라인) 회귀 복원.

증상: samples/exam_science.hwp page 2 의 7번 문제 글상자 (pi=33 ci=0, 1x1 Table) 안 p[1] 단락의 ㉠ 사각형 (Control::Shape, treat_as_char=true, ls[1] 위치) 이 Line 1 영역 (y=213.95) 에 잘못 그려져 본문 텍스트 "분자당 구성 …" 위에 겹침.

정정 효과: ㉠ 사각형 + ㉠ 텍스트 모두 Line 2 영역 (y=235.41 / 251.45) 으로 정확히 이동. Δ +21.47 px = ls[1].vpos − ls[0].vpos / 75 정확 일치.

회귀 출처 (git diff 9dc40dd 3de0505)

시점	커밋	Picture tac_img_y	Shape tac_img_y	shape_area.y	layout_cell_shape para_y
Task #520	313e65d	seg.vpos - first_vpos ✓	seg.vpos - first_vpos ✓	tac_img_y ✓	tac_img_y ✓
Task #544 v2 Stage 3 (원저자)	9dc40dd	seg.vpos - first_vpos ✓	seg.vpos - first_vpos ✓	tac_img_y ✓	tac_img_y ✓
PR #561 cherry-pick	3de0505	seg.vpos ✗ (회귀)	seg.vpos - first_vpos ✓	para_y_before_compose ✗ (회귀)	para_y_before_compose ✗ (회귀)

원저자 9dc40dd 는 Task #520 fix 유지 + Task #548 추가, PR #561 cherry-pick 메인테이너 정리 단계에서 conflict resolution 누락 추정.

정정 내용

src/renderer/layout/table_layout.rs 3 라인 정정 (+9/-2):

1. Picture 분기 tac_img_y 산식 — seg.vpos → seg.vpos - first_vpos (이중 합산 회귀 해소)
2. Shape 분기 shape_area.y — para_y_before_compose → tac_img_y (target_line 기반 위치)
3. Shape 분기 layout_cell_shape para_y 인자 — 동일

회귀 발생 4 조건 분석

Control::Shape(shape) if shape.common().treat_as_char 분기에서 다음 4 조건 모두 성립 시 회귀 가시화:

조건	exam_science p[1]	다른 5 multi-line + tac rect 케이스
(a) cell 안 paragraph	✓	✓
(b) multi-line	✓ (2)	✓ (2~10)
(c) target_line > 0 (rect on ls[1]+)	✓	varies
(d) first_vpos > 0 (paragraph[i>0])	✓ (1610)	✗ (모두 0)
회귀 가시화	YES	NO

→ exam_science p[1] 만이 (c) AND (d) 동시 성립 — 광범위 sweep 결과 (1/1496) 와 정확히 부합.

안전성 분석 (edge cases)

케이스	정정 후 동작	사유
first_vpos = 0 (cell 첫 paragraph)	동일 동작 보장	seg.vpos - 0 = seg.vpos, 산식 결과 동일
target_line = 0 (rect on ls[0])	동일 동작 보장	target_line > current_tac_line 가드로 if 블록 미진입
line_segs.len() = 1 (single-line)	동일 동작 보장	target_line = 0 으로 위와 동일
wrap = Square / InFrontOfText / TopAndBottom	본 분기 영향 없음	treat_as_char=true 만 처리

검증

항목	결과
cargo test --lib test_624_textbox_inline_shape_y_on_line2_p2_q7	RED → GREEN
cargo test --lib (전체)	1135 passed / 0 failed / 2 ignored
cargo test --test svg_snapshot	6/6 passed
cargo clippy --lib -- -D warnings	clean
cargo build --release	success

광범위 fixture sweep (158 fixture / 1,496 페이지)

카테고리	페이지 수	비율
의도된 정정	1	0.067%
회귀	0	0%
byte-identical	1,495	99.933%

의도된 정정 1 건 (samples/exam_science.hwp page 2):

-<rect x="117.066" y="213.946" width="62.986" height="22.880" fill="#ffffff" stroke="#000000" stroke-width="0.5"/>
-<text x="141.56"  y="229.986" ...>㉠</text>
+<rect x="117.066" y="235.413" width="62.986" height="22.880" fill="#ffffff" stroke="#000000" stroke-width="0.5"/>
+<text x="141.56"  y="251.453" ...>㉠</text>

TDD 흐름

Stage	커밋	내용
0	b3408fe	수행 계획서 + 구현 계획서
1	e5811c9	TDD RED 통합 테스트 (test_624_textbox_inline_shape_y_on_line2_p2_q7) — y=213.95 회귀 재현
2 (분석)	c30e886	영향 범위 분석 + edge case 검증 + 후속 권고
2 (정정)	242955b	Task #520 부분 회귀 정정 (3 line)
3	9cf9fc5	광범위 sweep + 최종 보고서 + orders 갱신

Test plan

• cargo test --lib 1135 passed (회귀 0)
• cargo test --lib test_624_textbox_inline_shape_y_on_line2_p2_q7 GREEN
• cargo test --test svg_snapshot 6/6 passed
• cargo clippy --lib -- -D warnings clean
• 시각 판정: output/svg/ 의 exam_science_002.svg ㉠ 사각형이 Line 2 영역 (y≈235) 에 위치, 본문 "분자당 구성" 위 겹침 해소

참조

• closes exam_science p2 7번 글상자 ㉠ 사각형 y-위치 회귀 — Task #520 부분 회귀 정정 #624
• 회귀 출처: PR Task #548: 셀 inline TAC Shape margin + indent 정정 (closes #548) #561 cherry-pick (3de0505)
• 원저자 commit: 9dc40dd (@planet6897 / Jaeook Ryu)
• 본질 commit: Task exam_science.hwp 문제7: inline 도형(tac=true, wrap=TopAndBottom)이 다음 문단 라인에 그려져 텍스트와 겹침 #520 (313e65d)
• 인접 task: Task exam_science.hwp 2페이지 7번 박스 안 동일 텍스트 중복 렌더링 #495 (text_before 추출 multi-line 가드), Task exam_science 페이지 2 박스 안 사각형이 multi-line paragraph 의 잘못된 줄 위치에 그려짐 #500 (Picture target_line 도입), Task 셀 내부 paragraph 첫줄 inline TAC Shape 의 margin_left + first-line indent 누락 (Task #547 후속) #548 (cell inline TAC Shape margin_left + indent)

후속 권고

1. PR cherry-pick 시 base diff 자동 점검: 본 결함은 9dc40dd → 3de0505 비교만으로 즉시 식별 가능. 동일 함수 영역 산식 비교 자동화 권고.
2. 회귀 테스트 가드: 본 PR 의 test_624_textbox_inline_shape_y_on_line2_p2_q7 가 RED → GREEN 가드 역할.

🤖 Generated with Claude Code