Repository navigation
Data Grid Cell Merge
상태: 가로 병합(#833)·세로 병합(#835) 모두 구현됨. Epic #829. 상위 문서: Data-Grid-Block · 선례: 수식(#799)·셀 서식(#828)
현재 구조는 모든 행이 열 수만큼 셀을 갖는다는 직사각형 가정 위에 서 있고, 그 가정이 여러 곳에 박혀 있다.
-
dataset_row.cells= 열 key→값 맵. 한 셀이 여러 행/열을 덮는다는 개념이 없다. -
MAX_CELLS(1,000,000) =rowCount × columnCount— 열 추가·행 추가 검증이 전부 이 곱에 의존. - API 투영(
RowView.cells)이 행 단위 직사각형(위치 배열)을 전제. - FE 본문은 각 행이 독립 absolute div(고정 높이
ROW_HEIGHT=36)이고 가상화가 보이는 행만 그린다.
이 블록의 불변식은 cells는 직사각형 값 맵이고, 부가정보는 값을 건드리지 않는 sparse 사이드 테이블(dataset_formula·dataset_cell_style)에 얹어 읽기·투영·수식 경로를 그대로 둔다는 것이다. 병합도 같은 원리를 적용한다.
병합은 모델 변경이 아니라 렌더 오버레이다. 덮인 셀의 값은
cells에 그대로 남고, 병합 테이블은 "어느 앵커가 몇 칸을 덮는가"만 기록한다. 렌더 시점에 앵커를 span으로 넓게 그리고 덮인 칸을 숨긴다.
이 한 결정이 나머지 오픈 아이템 대부분을 연쇄적으로 푼다(§3~§8).
dataset_merge(
id BIGINT PK,
dataset_id BIGINT FK NOT NULL ON DELETE CASCADE,
anchor_row_id BIGINT FK NOT NULL ON DELETE CASCADE, -- 좌상단 셀. 행 정체성 = id (row_index 아님)
anchor_col_key VARCHAR(64) NOT NULL,
row_span INT NOT NULL, -- >=1
col_span INT NOT NULL -- >=1
) -- (row_span, col_span) = (1,1)은 병합 아님 → 그런 행은 두지 않는다(sparse)
- 앵커 주소
(anchor_row_id, anchor_col_key)는 수식·서식과 같은 정체성 모델.row_id는 행이 밀려도 안 바뀌고,col_key는 순서 변경에 안 밀린다. -
덮인 셀의 기존 값은 버리지 않는다.
cells는 직사각형 그대로. 병합은 표시 시점에만 작용. - 기각한 대안 — 앵커에 colspan/rowspan + 덮인 셀 tombstone:
cells를 깨고(직사각형 붕괴)MAX_CELLS재정의를 강제하며, 투영·수식이 전제하는 직사각형을 무너뜨린다. sparse 오버레이가 기존 불변식과 양립한다.
오버레이 모델에선 물리 셀 수가 불변이다(cells는 여전히 직사각형). rowCount × columnCount가 그대로 물리 셀 수와 일치하므로 상한 계산을 바꿀 이유가 없다. 논리/물리 셀 수가 갈리는 문제 자체가 생기지 않는다.
(tombstone 방식이라면 논리≠물리라 재정의가 강제됐을 것 — 오버레이가 이 문제를 회피한다.)
병합 해제 = dataset_merge 행을 지운다. 덮여 있던 셀의 값은 cells에 그대로 있었으므로 그 자리에 원래 값이 되살아난다. "값을 앵커에만 남기나 전 칸에 복제하나"라는 질문은 소멸한다 — 값은 파괴된 적이 없다.
병합이 표시 전용이므로 수식은 밑의 직사각형 값을 그대로 읽는다. FormulaEvaluator·참조 모델(SAME_ROW/ABSOLUTE/COLUMN_ALL)은 손대지 않는다.
-
병합된 셀을 수식이 참조하면? 덮인 셀도
cells에 값이 실재하므로 그 값을 읽는다. 참조가 병합에 "흡수"돼도 셀은 사라지지 않으니 병합이#REF!를 만들 일이 없다. ("#REF!인가 재바인딩인가"는 둘 다 아님 — 참조는 무변경.) -
SUM이 병합 영역을 지나면? 밑의 각 셀 값을 그대로 센다. 엑셀은 덮인 칸을 빈칸 취급해 한 번만 세지만, 여기선 덮인 값이 보존되므로 그 값을 센다. 이 차이는 문서화한다(사용자가 "병합했으니 합계에서 빠지겠지"를 기대하면 어긋난다). 가로 병합만 있는 v1(§7)에선 세로 집계에 영향이 없어 이 divergence가 드물다. - 열 범위 스냅샷(수식 D7)과 병합 영역: 스냅샷은 정체성 집합이라 병합(표시)과 독립. 상호작용 없음.
병합 영역은 정체성(앵커)으로 저장하지만 본질적으로 위치 개념(인접한 행·열의 직사각형)이라, 구조 변경이 영역을 불연속으로 만들 수 있다. v1 정책은 안전·저비용 우선:
- 병합 영역 안에 행/열 삽입, 영역 구성원 삭제, 순서 변경으로 불연속 → 그 병합을 해제(merge 행 drop, 값은 보존). 엑셀도 병합 범위 편집에 보수적(일부 연산 거부)이라 어긋나지 않는다.
-
열 삭제 시:
col_key가 FK가 아니라 cascade가 없으므로, 서식(styleService.invalidateColumn)·수식(formulaService.invalidateColumn)과 **같은 자리에mergeService.invalidateColumn**을 걸어 그 열에 걸친 병합을 즉시 정리. -
행/열 중간 삽입 시(#838): 삽입 위치를 span이 가로지르는 병합만 해제한다(
mergeService.invalidateOnRowInsert·invalidateOnColumnInsert). 삽입 밖(앞·뒤)의 병합은 함께 밀려 온전하다 — 전부 해제하는 순서 변경보다 정밀하다. -
행·데이터셋 삭제:
anchor_row_id·dataset_idFKON DELETE CASCADE로 함께 사라진다. - 엑셀식 "삽입 시 영역 키우기/밀기"는 후속. v1은 영역이 연속·정합일 때만 유지.
기존 판단(Data-Grid-Block §12: "세로 병합은 행 독립 가상화와 양립 불가")은 가변 높이를 전제한 것이라 과하다. 고정 높이에선 기하가 결정적이다.
-
가로 병합(colspan)은 가상화와 완전히 양립. 열을 넘는 병합은 한 행 div 안에 갇힌다 →
grid-column: span N으로 넓게 그리고 덮인 열만 건너뛰면 끝. 가상화 불변식 무손상. -
세로 병합(rowspan)만 뷰포트 밖 앵커가 걸쳐 드는 문제. 하지만
ROW_HEIGHT가 고정이라, 정상 가상화 행 위에 absolute 오버레이 레이어(top = 앵커translateY, height =row_span × ROW_HEIGHT)로 병합 셀을 겹쳐 그리면 된다. 뷰포트와 교차하는 병합만 렌더. 덮인 칸은 빈 칸으로.
→ 결론: 병합은 가상화가 막는 게 아니라 슬라이스로 나누면 되는 문제.
세로 병합 오버레이는 열 너비를 측정하지 않고 그린다:
- 오버레이 컨테이너를 본문과 같은
gridTemplateColumns를 쓰는 grid로 두고, 각 병합을grid-column: <앵커열> / span colSpan으로 배치하면 x·폭이 본문 열과 정확히 맞는다(유연폭1fr열도 동일하게 해석된다). - 그 안의 실제 박스는
position:absolute; top: rowOffset(앵커행); height: Σ 덮는 행 높이— 세로 기하는 px로 계산한다.-
가변 행 높이(#839):
rowOffset(i) = i×36 + Σ_{j<i, override}(h[j]−36)(override sparse라 저렴). 고정 높이면i×36과 같다. 이 누적 오프셋이 가상화vi.start와 일치함이 테스트로 보장된다(둘 다 같은 estimateSize의 누적).
-
가변 행 높이(#839):
- 브라우저 검증: 유연폭 열 뒤에 놓인 세로 병합 박스도 그 열의
left·width에 픽셀 단위로 일치.
| # | 슬라이스 | 내용 | 가상화 |
|---|---|---|---|
| 1 | ✅ 가로 병합(colspan) (#833) |
dataset_merge + span API(PUT/DELETE) + colspan 렌더 + 분할. 수식·서식 sparse 패턴 재사용 |
무손상(in-grid span) |
| 2 | ✅ 세로 병합(rowspan) (#835) | 2D 검증 + GET /merges(전체 리스트) + 오버레이 레이어 + 아래와 병합 UI |
오버레이로 해결(측정 불필요) |
| — | O3 구조 변경 | "깨지면 해제" + mergeService.invalidateColumn
|
— |
| — | O4 정렬·필터 | 현재 서버 정렬/필터 없음 → 지금 충돌 없음. 도입 시 병합 있으면 거부(엑셀식). 문서화만 | — |
수식·서식과 같은 리소스 스타일:
| 메서드·경로 | 요청 | 응답 | 용도 |
|---|---|---|---|
GET /datasets/{id}/merges |
— | { merges: [{rowIndex,colKey,rowSpan,colSpan}] } |
그 dataset의 병합 전체 |
PUT /datasets/{id}/rows/{rowIndex}/cells/{colKey}/merge |
{ rowSpan, colSpan } |
{ merges: [...] } |
앵커 기준 병합 |
DELETE /datasets/{id}/rows/{rowIndex}/cells/{colKey}/merge |
— | { merges: [...] } |
분할(해제) |
-
병합은 dataset 단위로 내려간다(
GET /merges, 변경 API도 갱신된 전체를 반환). 세로 병합은 앵커 행이 화면 밖이어도 덮인 행을 그려야 해 페이지 단위(RowView)로는 부족하다 — 그래서RowView엔 병합을 싣지 않는다. 병합은 sparse라 전체를 받아도 대개 적다. 앵커는 저장은row_id, 표시는 행 번호(밀리면 FE가 다시 받는다). -
스키마:
dataset_merge(id, dataset_id FK⟶cascade, anchor_row_id FK⟶cascade, anchor_col_key, row_span, col_span), UNIQUE(anchor_row_id, anchor_col_key). (마이그레이션042-create-dataset-merge—row_span을 처음부터 둬 슬라이스 2가 마이그레이션 없이 얹혔다.) -
검증: 앵커 열 존재(404) ·
(1,1)은 병합 아님(400) · 오른쪽/아래 경계 초과 금지(400) · 다른 병합과 직사각형이 겹치면 400. -
FE 렌더: 가로 전용(rowSpan=1)은 그 행 안에서
grid-column: span으로(가상화 무손상), 세로·블록(rowSpan>1)은 §7의 오버레이 레이어로. 덮인 셀은 base에서 자리만 두고 숨긴다. 병합 UI는 셀 팝오버의 "오른쪽과 병합"·"아래와 병합"·"병합 해제". -
정리: 열 삭제 시 그 열에 걸친 병합 해제(
mergeService.invalidateColumn), 열 순서 변경 시 그 dataset 병합 전부 해제(v1 보수적), 행 삽입·삭제 시 FE가 병합을 다시 받는다(행 번호가 밀린다), 앵커 행·데이터셋 삭제는 FK cascade.
- 엑셀식 삽입 시 영역 키우기/밀기(v1은 해제).
- 정렬·필터 도입 시 병합 처리(현재 없음).
- 세로 병합 오버레이의 편집 UX 세부(앵커가 스크롤로 부분만 보일 때).