Skip to content

feat (#20) :: 공통 퍼블리싱 컴포넌트 구축 - #21

Merged
hxm2n merged 4 commits into
mainfrom
feature/#20-common-component-publishing
Aug 19, 2026
Merged

feat (#20) :: 공통 퍼블리싱 컴포넌트 구축#21
hxm2n merged 4 commits into
mainfrom
feature/#20-common-component-publishing

Conversation

@hxm2n

@hxm2n hxm2n commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator

작업 내용

  • 공통 디자인 기준을 DESIGN.md로 정리하고 row/header/input 사이즈 토큰을 추가했습니다.
  • 학생/선생님 퍼블리싱에 필요한 AppHeader, AppFooter, LinkRow, ClassCard, SearchField, MajorInputGroup, MajorList, TextSlot을 추가했습니다.
  • 도서관/포트폴리오 흐름에 필요한 OptionList, LibraryBook, PortfolioUrlModal을 추가했습니다.
  • /component-showcase에서 캡처 기반 컴포넌트 상태를 한 번에 확인할 수 있게 연결했습니다.

검증

  • pnpm exec tsc --noEmit
  • pnpm run lint
  • pnpm run build

참고

  • 크기 과대 문제는 캡처 픽셀을 CSS px처럼 옮긴 영향이라, row/input/header 기본 높이를 앱 스케일로 낮췄습니다.
  • 크기 축소 후 브라우저 재캡처는 로컬 서버 실행 승인 타임아웃으로 수행하지 못했습니다.
  • Pixel-perfect QA는 요청대로 마지막 QA 단계에서 별도로 맞추는 전제로 두었습니다.

Closes #20

hxm2n added 4 commits August 19, 2026 23:32
Constraint: 8월 31일 전 퍼블리싱 속도를 위해 캡처 기반 컴포넌트를 한 이슈에서 빠르게 확장해야 함

Rejected: 개별 컴포넌트마다 임의 px를 흩뿌리는 방식 | 후속 student/teacher 화면에서 스케일 drift가 커짐

Confidence: high

Scope-risk: narrow

Directive: 새 공통 UI 크기와 색상은 DESIGN.md 토큰을 먼저 갱신한 뒤 사용한다

Tested: pnpm exec tsc --noEmit; pnpm run lint; pnpm run build

Not-tested: 크기 축소 후 브라우저 캡처는 로컬 서버 실행 승인 타임아웃으로 미수행
Constraint: student/teacher 퍼블리싱을 동시에 진행해야 해서 header, row, class, major form 계열을 재사용 가능해야 함

Rejected: 화면별로 같은 row와 input을 복붙하는 방식 | API 연동 단계에서 상태/접근성 수정 비용이 커짐

Confidence: high

Scope-risk: moderate

Directive: 실제 화면에서는 이 primitive props로 데이터만 주입하고, 화면별 스타일 override는 최소화한다

Tested: pnpm exec tsc --noEmit; pnpm run lint; pnpm run build

Not-tested: 크기 축소 후 브라우저 캡처는 로컬 서버 실행 승인 타임아웃으로 미수행
Constraint: 퍼블리싱 QA 전에 캡처된 컴포넌트 상태를 한 화면에서 빠르게 확인해야 함

Rejected: 컴포넌트를 만들고 노출 경로 없이 두는 방식 | 실제 화면 조립 전 발견할 수 있는 시각/접근성 문제가 늦게 드러남

Confidence: high

Scope-risk: moderate

Directive: /component-showcase는 API 연동 전까지 공통 컴포넌트 회귀 확인 화면으로 유지한다

Tested: pnpm exec tsc --noEmit; pnpm run lint; pnpm run build

Not-tested: 크기 축소 후 브라우저 캡처는 로컬 서버 실행 승인 타임아웃으로 미수행
Constraint: 디자이너가 제공한 SVG 에셋을 기준으로 로그인 배경과 도서관 책 표지를 실제 화면에 반영해야 함

Rejected: CSS 그라데이션과 책갈피를 계속 수작업으로 재현하는 방식 | 제공 에셋과 시각 차이가 반복됨

Confidence: high

Scope-risk: narrow

Directive: SVG 기반 화면 자산은 Next 정적 서빙을 위해 public/assets 아래에서 참조한다

Tested: pnpm exec tsc --noEmit; pnpm run lint; pnpm run build; Chrome Playwright capture confirmed /login uses auth-bg.svg and /component-showcase uses library-book-cover.svg with 160x220 card

Not-tested: independent visual QA reviewers did not return before timeout; manual browser capture was used as current evidence
@hxm2n
hxm2n merged commit 81c2450 into main Aug 19, 2026
1 check passed
@hxm2n
hxm2n deleted the feature/#20-common-component-publishing branch August 19, 2026 14:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Publishing]: 공통 컴포넌트 묶음 구축

1 participant