4.4 KiB
4.4 KiB
POP 개발 계획
현재 상태 (2026-02-06)
v5.2 그리드 시스템 완성 (브레이크포인트 재설계 + 세로 자동 확장)
작업 순서
[Phase 1~3] [Phase 5] [Phase 4]
v4 Flexbox → v5 CSS Grid → 실제 컴포넌트 구현
완료 완료 (v5.2) 다음
완료된 Phase
Phase 1~3: v4 Flexbox 시스템 (완료, 레거시 삭제됨)
v4 Flexbox 기반 시스템은 v5 CSS Grid로 완전히 대체되었습니다. v4 관련 파일은 모두 삭제되었습니다.
- v4 기본 구조, 렌더러, 디자이너 통합
- Undo/Redo, 드래그 리사이즈, Flexbox 가로 배치
- 비율 스케일링 시스템
- 오버라이드 기능 (모드별 배치 고정)
- 컴포넌트 표시/숨김, 줄바꿈
Phase 5: v5 CSS Grid 시스템 (완료)
Phase 5.1: 타입 정의 (완료)
PopLayoutDataV5인터페이스PopGridConfig,PopGridPosition타입GridMode,GRID_BREAKPOINTS상수createEmptyPopLayoutV5(),isV5Layout(),detectGridMode()
Phase 5.2: 그리드 렌더러 (완료)
PopRenderer.tsx- CSS Grid 기반 렌더링- 격자 셀 렌더링 (CSS Grid 동일 좌표계)
- 위치 변환 (12칸 -> 4/6/8칸)
Phase 5.3: 디자이너 UI (완료)
PopCanvas.tsx- 그리드 캔버스 + 행/열 라벨- 드래그 스냅 (칸에 맞춤)
ComponentEditorPanel.tsx- 위치 편집
Phase 5.4: 반응형 자동화 (완료)
- 자동 변환 알고리즘 (12칸 -> 4칸)
- 겹침 감지 및 재배치
- 모드별 오버라이드 저장
v5.1 추가 기능 (완료)
- 자동 줄바꿈 (col > maxCol -> 맨 아래 배치)
- "검토 필요" 알림 시스템
- Gap 프리셋 (좁게/보통/넓게)
- 숨김 기능 (모드별)
v5.2 브레이크포인트 재설계 + 세로 자동 확장 (완료)
- 기기 기반 브레이크포인트 (479/767/1023px)
- 세로 자동 확장 (dynamicCanvasHeight)
- 뷰어 반응형 일관성 (detectGridMode 사용)
- VIEWPORT_PRESETS에서 height 제거
다음 작업
Phase 4: 실제 컴포넌트 구현
현재 모든 컴포넌트는 pop-sample (샘플 박스)로 렌더링됩니다.
실제 컴포넌트를 구현하여 데이터 바인딩까지 연결해야 합니다.
컴포넌트 구현 목록:
- pop-field: 입력/표시 필드
- pop-button: 액션 버튼
- pop-list: 데이터 리스트 (카드 템플릿)
- pop-indicator: KPI/상태 표시
- pop-scanner: 바코드/QR 스캔
- pop-numpad: 숫자 입력 패드
참고 문서: components-spec.md
후속 작업
- 워크플로우 연동 (버튼 액션, 화면 전환)
- 데이터 바인딩 연결
- 실기기 테스트 (아이폰 SE, iPad Mini 등)
현재 구현 계획
용도: 이 섹션은 "지금 바로 실행할 구체적 계획"입니다. 새 세션에서 이 섹션만 읽으면 코딩을 시작할 수 있어야 합니다. 완료되면 다음 기능의 계획으로 교체합니다.
대상: (계획 수립 전)
현재 구현 계획이 없습니다. 계획 수립 세션에서 다음 형식으로 작성해주세요:
### 대상: [기능명]
#### 구현 순서 (의존성 기반)
1. [ ] 파일명 - 변경 내용 요약
2. [ ] 파일명 - 변경 내용 요약
#### 파일별 변경 사항
| # | 파일 (경로) | 작업 | 핵심 변경 | 주의사항 |
|---|------------|------|----------|---------|
#### 함정 경고
- (빠뜨리면 에러나는 것들)
#### 참조
- 관련 문서/파일 경로
브레이크포인트 (v5.2 현재)
| 모드 | 화면 너비 | 칸 수 | 대상 기기 |
|---|---|---|---|
| mobile_portrait | ~479px | 4칸 | 아이폰 SE ~ 갤럭시 S |
| mobile_landscape | 480~767px | 6칸 | 스마트폰 가로 |
| tablet_portrait | 768~1023px | 8칸 | 8~10인치 태블릿 세로 |
| tablet_landscape | 1024px~ | 12칸 | 10~14인치 태블릿 가로 |
관련 문서
| 문서 | 내용 |
|---|---|
| STATUS.md | 현재 진행 상태 |
| SPEC.md | 기술 스펙 |
| ARCHITECTURE.md | 코드 구조 |
| components-spec.md | 컴포넌트 상세 설계 |
| decisions/005 | 브레이크포인트 재설계 ADR |
최종 업데이트: 2026-02-06 (v5.2 완료, Phase 4 대기)