Skip to content

[5팀 허정석] Chapter 1-1. 프레임워크 없이 SPA 만들기 - #19

Open
heojungseok wants to merge 79 commits into
hanghae-plus:mainfrom
heojungseok:main
Open

[5팀 허정석] Chapter 1-1. 프레임워크 없이 SPA 만들기#19
heojungseok wants to merge 79 commits into
hanghae-plus:mainfrom
heojungseok:main

Conversation

@heojungseok

@heojungseok heojungseok commented Jul 5, 2025

Copy link
Copy Markdown

과제 체크포인트

배포 링크

허정석_1주차_과제_배포_링크와젤다

기본과제

상품목록

상품 목록 로딩

  • 페이지 접속 시 로딩 상태가 표시된다
  • 데이터 로드 완료 후 상품 목록이 렌더링된다
  • 로딩 실패 시 에러 상태가 표시된다
  • 에러 발생 시 재시도 버튼이 제공된다

상품 목록 조회

  • 각 상품의 기본 정보(이미지, 상품명, 가격)가 카드 형태로 표시된다

한 페이지에 보여질 상품 수 선택

  • 드롭다운에서 10, 20, 50, 100개 중 선택할 수 있으며 기본 값은 20개 이다.
  • 선택 변경 시 즉시 목록에 반영된다

상품 정렬 기능

  • 상품을 가격순/인기순으로 오름차순/내림차순 정렬을 할 수 있다.
  • 드롭다운을 통해 정렬 기준을 선택할 수 있다
  • 정렬 변경 시 즉시 목록에 반영된다

무한 스크롤 페이지네이션

  • 페이지 하단 근처 도달 시 다음 페이지 데이터가 자동 로드된다
  • 스크롤에 따라 계속해서 새로운 상품들이 목록에 추가된다
  • 새 데이터 로드 중일 때 로딩 인디케이터와 스켈레톤 UI가 표시된다
  • 홈 페이지에서만 무한 스크롤이 활성화된다

상품을 장바구니에 담기

  • 각 상품에 장바구니 추가 버튼이 있다
  • 버튼 클릭 시 해당 상품이 장바구니에 추가된다
  • 추가 완료 시 사용자에게 알림이 표시된다

상품 검색

  • 상품명 기반 검색을 위한 텍스트 입력 필드가 있다
  • 검색 버튼 클릭으로 검색이 수행된다
  • Enter 키로 검색이 수행된다
  • 검색어와 일치하는 상품들만 목록에 표시된다

카테고리 선택

  • 사용 가능한 카테고리들을 선택할 수 있는 UI가 제공된다
  • 선택된 카테고리에 해당하는 상품들만 표시된다
  • 전체 상품 보기로 돌아갈 수 있다
  • 2단계 카테고리 구조를 지원한다 (1depth, 2depth)

카테고리 네비게이션

  • 현재 선택된 카테고리 경로가 브레드크럼으로 표시된다
  • 브레드크럼의 각 단계를 클릭하여 상위 카테고리로 이동할 수 있다
  • "전체" > "1depth 카테고리" > "2depth 카테고리" 형태로 표시된다

현재 상품 수 표시

  • 현재 조건에서 조회된 총 상품 수가 화면에 표시된다
  • 검색이나 필터 적용 시 상품 수가 실시간으로 업데이트된다

장바구니

장바구니 모달

  • 장바구니 아이콘 클릭 시 모달 형태로 장바구니가 열린다
  • X 버튼이나 배경 클릭으로 모달을 닫을 수 있다
  • ESC 키로 모달을 닫을 수 있다
  • 모달에서 장바구니의 모든 기능을 사용할 수 있다

장바구니 수량 조절

  • 각 장바구니 상품의 수량을 증가할 수 있다
  • 각 장바구니 상품의 수량을 감소할 수 있다
  • 수량 변경 시 총 금액이 실시간으로 업데이트된다

장바구니 삭제

  • 각 상품에 삭제 버튼이 배치되어 있다
  • 삭제 버튼 클릭 시 해당 상품이 장바구니에서 제거된다

장바구니 선택 삭제

  • 각 상품에 선택을 위한 체크박스가 제공된다
  • 선택 삭제 버튼이 있다
  • 체크된 상품들만 일괄 삭제된다

장바구니 전체 선택

  • 모든 상품을 한 번에 선택할 수 있는 마스터 체크박스가 있다
  • 전체 선택 시 모든 상품의 체크박스가 선택된다
  • 전체 해제 시 모든 상품의 체크박스가 해제된다

장바구니 비우기

  • 장바구니에 있는 모든 상품을 한 번에 삭제할 수 있다

상품 상세

상품 클릭시 상세 페이지 이동

  • 상품 목록에서 상품 이미지나 상품 정보 클릭 시 상세 페이지로 이동한다
  • URL이 /product/{productId} 형태로 변경된다
  • 상품의 자세한 정보가 전용 페이지에서 표시된다

상품 상세 페이지 기능

  • 상품 이미지, 설명, 가격 등의 상세 정보가 표시된다
  • 전체 화면을 활용한 상세 정보 레이아웃이 제공된다

상품 상세 - 장바구니 담기

  • 상품 상세 페이지에서 해당 상품을 장바구니에 추가할 수 있다
  • 페이지 내에서 수량을 선택하여 장바구니에 추가할 수 있다
  • 수량 증가/감소 버튼이 제공된다

관련 상품 기능

  • 상품 상세 페이지에서 관련 상품들이 표시된다
  • 같은 카테고리(category2)의 다른 상품들이 관련 상품으로 표시된다
  • 관련 상품 클릭 시 해당 상품의 상세 페이지로 이동한다
  • 현재 보고 있는 상품은 관련 상품에서 제외된다

상품 상세 페이지 내 네비게이션

  • 상품 상세에서 상품 목록으로 돌아가는 버튼이 제공된다
  • 브레드크럼을 통해 카테고리별 상품 목록으로 이동할 수 있다
  • SPA 방식으로 페이지 간 이동이 부드럽게 처리된다

사용자 피드백 시스템

토스트 메시지

  • 장바구니 추가 시 성공 메시지가 토스트로 표시된다
  • 장바구니 삭제, 선택 삭제, 전체 삭제 시 알림 메시지가 표시된다
  • 토스트는 3초 후 자동으로 사라진다
  • 토스트에 닫기 버튼이 제공된다
  • 토스트 타입별로 다른 스타일이 적용된다 (success, info, error)

심화과제

SPA 네비게이션 및 URL 관리

페이지 이동

  • 어플리케이션 내의 모든 페이지 이동(뒤로가기/앞으로가기를 포함)은 하여 새로고침이 발생하지 않아야 한다.

상품 목록 - URL 쿼리 반영

  • 검색어가 URL 쿼리 파라미터에 저장된다
  • 카테고리 선택이 URL 쿼리 파라미터에 저장된다
  • 상품 옵션이 URL 쿼리 파라미터에 저장된다
  • 정렬 조건이 URL 쿼리 파라미터에 저장된다
  • 조건 변경 시 URL이 자동으로 업데이트된다
  • URL을 통해 현재 검색/필터 상태를 공유할 수 있다

상품 목록 - 새로고침 시 상태 유지

  • 새로고침 후 URL 쿼리에서 검색어가 복원된다
  • 새로고침 후 URL 쿼리에서 카테고리가 복원된다
  • 새로고침 후 URL 쿼리에서 옵션 설정이 복원된다
  • 새로고침 후 URL 쿼리에서 정렬 조건이 복원된다
  • 복원된 조건에 맞는 상품 데이터가 다시 로드된다

장바구니 - 새로고침 시 데이터 유지

  • 장바구니 내용이 브라우저에 저장된다
  • 새로고침 후에도 이전 장바구니 내용이 유지된다
  • 장바구니의 선택 상태도 함께 유지된다

상품 상세 - URL에 ID 반영

  • 상품 상세 페이지 이동 시 상품 ID가 URL 경로에 포함된다 (/product/{productId})
  • URL로 직접 접근 시 해당 상품의 상세 페이지가 자동으로 로드된다

상품 상세 - 새로고침시 유지

  • 새로고침 후에도 URL의 상품 ID를 읽어서 해당 상품 상세 페이지가 유지된다

404 페이지

  • 존재하지 않는 경로 접근 시 404 에러 페이지가 표시된다
  • 홈으로 돌아가기 버튼이 제공된다

AI로 한 번 더 구현하기

  • 기존에 구현한 기능을 AI로 다시 구현한다.
  • 이 과정에서 직접 가공하는 것은 최대한 지양한다.

과제 셀프회고

혼자 했다면 못 했을 과제. 팀원과 AI의 합작품.

(AI도 미쳤다고 했다.....)

image

과제 시작 부터 막막했으나, 어찌저찌 배포 했다...그치만...통과를 못 하고 있는 상황 (08:59 준일님이 와서 팁을 알려줬다..!)
로컬과 TB는 확실히 다르다는 걸 또 깨닫는다..... 이번 과제로 많은걸 느꼈다.
우선 내 실력에 대한 깊은 좌절감이 ....
그래도 1주동안 정말 열과 성을 다해서 몰입했어서 후회는 없다.
그리고 제일 값진 건

팀원분들과의 첫 협업
이라는 사실!!! 진짜 혼자 였다면 안했을 것도 팀원들이 있어줘서 해냈다고 생각한다.

정석호, 양성진, 여찬규, 윤영서, 이지훈, 김유현 최고
5팀 고백 박을게요 라뷰

기술적 성장

  • 라우터에 대한 기본적인 개념 확립
    • 클래스로 구현한 라우터
    • 동적 라우팅

자랑하고 싶은 코드

개선이 필요하다고 생각하는 코드

학습 효과 분석

  • 가장 큰 배움이 있었던 부분
    • 라우터, 기본 JS 활용
  • 추가 학습이 필요한 영역
    • 라우터, 이벤트 핸들링

과제 피드백

  • 과제가 상세하게 테스트 코드가 있어서 좋았으나, 해당 페이지가 랜더링 됐을 때의 스냅샷을 비교 하는거여서 숨은 그림 찾기 같은 느낌이 강했다. 그리고 테스트 코드를 처음 접해봐서 감을 잡는데 시간이 오래 걸렸다. 발제 시간에 테스트 설명을 좀 더 진행했으면 좋겠다.
  • 중간 중간 과제의 변동 사항이 많아서 어떤 기준으로 과제가 평가가 되는지 후반부에 정해진 점은 아쉽다.
  • 그렇지만 수강생의 의견을 받아들이고 최대한 과제를 디벨롭하는 코치의 빠른 피드백은 굉장히 좋았다.
  • 과제 난이도에 있어서는 어렵다고 느껴졌으며 혼자 하기에는 질적으로나 양적으로 버거웠다. 시간 투자 비중을 정하는 것은 수강생 자유겠으나 과제에 얽메이는 난이도는 좋지 않다고 생각한다. 그치만 난이도 만큼의 성취감은 확실하다.

AI 활용 경험 공유하기

Gemini CLI

이 친구가 없었다면 전 이 글을 쓰지 못 했겠죠?
프로젝트를 하면서 AI 툴에 기대어 거의(?) 바이브 코딩 급으로 진행했습니다. 그냥 기댔단 말입니다.
처음에는 문장 단위로만 얘기를 했었는데 이게 점점 3줄,4줄,.... 계속 줄줄이 소세지처럼 엮고 엮어서 질문하는 저를 발견했습니다.
개발자는 이제 글도 잘 써야 합니다.. 그치만 여전히 전 글을 못 쓰고 있죠...ㅎ
나를 모르는 사람에게 나만 쓸 수 있는 물건을 설명하고 사용하라고 하게 만들어야 하는게 쉽지 않듯이
이 친구와 얘기하는게 쉽지 않았습니다. 물론 지금도 쉽지 않습니다. 7살 애한테 얘기하는 기분이랄까요?
(눈높이를 맞추고 싶은데.. 얘 눈이 너무 높아요.)
하지만 확실한건 이젠 없어서는 안되고 질문만 잘 던지면 상당히 기특한 친구이기에 제가 무던히 노력해야죠.
덕분에 새로운 경험도 해보고 화도 많이난 째미나이와 함께한 1주였습니다.

째미나이야.앞으로 9주 동안 잘 부탁해. 가끔씩 퍼지던데 그러지마 나 힘드니까.

정보 전달은 없고 너무 느낀점 위주로만 작성이 됐네요... 담엔 정보 전달도 노력해보겠습니다...
아 팁 있다. ( \ + Enter ) 줄 바꿈.
아래는 과제를 진행하면서 째미나이한테 요청한 내역들이예요!!!


  • 쨰미나이 요청 리스트 업 (07.08)

    1. 라우터 적용
    2. searchNcategoriesComp.js 파일의 forEach 로직 개선 방안 질문 및 리팩토링 요청 ⇒ 선언적 UI 적용
    3. 리팩토링 요약본을 Markdown 파일로 생성 요청
    4. input 이벤트와 엔터 키 감지 방법에 대한 설명 요청
  • 째미나이 요청 리스트업 (07.09)

    무한 스크롤링 요청

    1. ProductList.js 부분에 무한 스크롤 적용 원리 및 방법 설명 요청.
    2. 무한 스크롤이 한 번만 동작하는 문제에 대한 원인 분석 및 해결 요청.
    3. 수정된 무한 스크롤 코드 검토 요청.
    4. ProductList.js의 observerTargetHtml 조건문 문제에 대한 분석 및 해결 요청.
    5. scroll 이벤트 방식 무한 스크롤의 성능 개선(쓰로틀링) 가능성 및 방법 설명 요청.
    6. 쓰로틀링된 scroll 이벤트 방식 무한 스크롤 구현 요청 (유틸리티 함수 확인 포함).
    7. 스크롤 이벤트 핸들러 함수를 setupEventListeners에 포함할 수 있는지 여부 및 방법 문의.
    8. handleScroll 함수에 대한 설명 요청.
    9. 이벤트 핸들러를 별도 파일로 분리하는 코드 조직화 방식 문의.
    10. 이벤트 핸들러 분리 작업 진행 요청 (새 디렉토리 생성 및 파일 이동).
    11. 무한 스크롤 초기 로딩 상품 개수 문제(테스트 환경에서 10개로 보이는 현상) 원인 분석 요청.

    상세 페이지 요청

    1. url 필드 객체에서 쿼리스트링 포함 여부 확인 방법 문의.
    2. urlObj에서 /products/:id 패턴 일치 여부 확인 방법 문의.
    3. URL 생성자 Invalid URL 오류 원인 분석 및 해결 요청.
    4. ProductCard.js에서 이미지 클릭 시 라우터로 페이지 이동 구현 방법 요청.
    5. router.js에서 동적 경로(products/:id) 감지 문제 해결 요청.

리뷰 받고 싶은 내용

  • 이벤트 핸들링에 대해서 고민을 하지 않았었는데, 이번 과제를 통해 핸들링에 대해 관심이 생겼습니다. 개발하면서 거의 처음으로 핸들링을 구현 했어서 보완할 부분을 듣고싶습니다. 또 코치님이라면 어떤 기준과 방식으로 이벤트 핸들링을 했을지 궁금합니다.

@heojungseok heojungseok changed the title 커밋 [5팀 허정석] Chapter 1-1. 프레임워크 없이 SPA 만들기 Jul 5, 2025
페이지가 그려지기 전 함수 호출 문제
테스트 시 screen.logTestingPlaygroundURL() 활용
* 이벤트 리스너 연결
* DOM 재 랜더링
* 리스너 손실
해결을 위해 이벤트 위임 강화 (기존 객체 보다 상위로 변경)
선언적 UI 렌더링
* 필터를 직접 순회하여 속성을 동적으로 추가/삭제 방식 > 컴포넌트 상위에서 전달 받은 값으로 랜더링 시점에 결정
* 원본 데이터 불변성 유지
* Promise.all 을 사용해 병렬로 호출 개선
* UI 랜더링에만 사용되는 특정 필드 값 제거하고 데이터의 영향을 주는 상태만 관리
* 초반 로딩 화면 플래그 설정
heojungseok and others added 11 commits July 9, 2025 09:07
카테고리 적용 전 상태, 추후 컴포넌트 분리 표시
카테고리와 검색 필터를 합치는 방향 고려
페이지가 그려지기 전 함수 호출 문제
테스트 시 screen.logTestingPlaygroundURL() 활용
createRouter() 개념 이해
* 이벤트 리스너 연결
* DOM 재 랜더링
* 리스너 손실
해결을 위해 이벤트 위임 강화 (기존 객체 보다 상위로 변경)
# Conflicts:
#	.github/workflows/ci.yml
선언적 UI 렌더링
* 필터를 직접 순회하여 속성을 동적으로 추가/삭제 방식 > 컴포넌트 상위에서 전달 받은 값으로 랜더링 시점에 결정
* 원본 데이터 불변성 유지
@heojungseok

Copy link
Copy Markdown
Author

ㅇㅇㅇ

@creco-hanghae

Copy link
Copy Markdown

ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ ㅇㅇㅇ뭔가요

Comment on lines +77 to +83
if (decreaseQuantyBtn && quantityInput) {
const currentValue = parseInt(quantityInput.value, 10);
if (currentValue > 1) {
quantityInput.value = currentValue - 1;
}
return;
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 부분에 어떤 부분이 잘 작성했는지 확신이 없는데 어떻게 생각하시는지 궁금합니다 (예시)

Comment thread src/utils/throttle.js
Comment on lines +1 to +10
export const throttle = (callback, delay = 200) => {
let timeId;
return (...args) => {
if (timeId) return;
timeId = setTimeout(() => {
callback(...args);
timeId = null;
}, delay);
};
};

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

처음으로 쓰로틀링을 적용해봤는데 이렇게 적용하는게 맞는지 확신이 안듭니다. 동작은 하나 더 좋은 방식이 있을까요?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

잘 구현하신 것 같아요!
추가 기능으로 callback 이 실행되기 전에 수동으로 취소할 수 있는 기능이 있다면 좋을 것 같아요!

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

잘 구현하신 것 같아요! 추가 기능으로 callback 이 실행되기 전에 수동으로 취소할 수 있는 기능이 있다면 좋을 것 같아요!

수동 취소는 생각도 못했습니다. 감사합니다. 어떤 경우에 수동 취소가 필요한지 알 수 있을까요?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

잘 구현하신 것 같아요! 추가 기능으로 callback 이 실행되기 전에 수동으로 취소할 수 있는 기능이 있다면 좋을 것 같아요!

수동 취소는 생각도 못했습니다. 감사합니다. 어떤 경우에 수동 취소가 필요한지 알 수 있을까요?

쓰로틀이 걸린 상태에서 페이지 이동이나 컴포넌트 변경이 발생했을 때 쓰로틀에서 예약된 내용이 실행되지 않아야 하는 상황이 있을 것 같아요!

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

쓰로틀링으로 성능 최적화 하신 부분 인상깊게 봤습니다!

잘 작성해 주셔서 충분해 보이는데
옵션을 매개변수로(e.g. options = { leading: true, trailing: false })
leading: 최초 이벤트 발생 시 즉시 콜백 실행
trailing: 마지막 이벤트 발생 후 일정 시간 지난 뒤 콜백 실행

이런식으로 함수 내부에서 분기되는 추가 로직들을 작성하면 필요에 따라 유요할 것 같아요!

Comment thread src/router.js
Comment on lines +179 to +191
updateStateAndRender(newMainStatus) {
this.mainStatus = structuredClone(newMainStatus);
this.render();
}

getCurrentState() {
return this.mainStatus;
}

setCurrentState(newMainStatus) {
this.mainStatus = structuredClone(newMainStatus);
}
}

@creco-hanghae creco-hanghae Jul 12, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

router 가 제공하는 동작을 기준으로 생각해보면 updateStateAndRender 는 조금 이상한 것 같아요.
router 는 router.push / router.navigate 처럼 이동하는 로직만 있어야할 것 같아서요
updateStateAndRender 함수이름을 생각했을 때 차라리 Renderer.updateStateAndRender 처럼 렌더러로 분리해서 사용할 수 있게 하는 것도 방법일 것 같습니다.

별개로 궁금하셨던 겹치는 감에 대해서는 updateState 함수로 이름을 통합하고, callback 함수나 onSuccess 함수를 인자로 넘기게 해서 구현쪽에서는 state update만 하고 쓰는 쪽에서 render 를 쓸 수 있게하는 것도 방법일 것 같습니다.

router.updateState(newState, { onSuccess: () => render() });

그래서 setCurrentState 로직은 router.updateState(newState) 로 쓰고 updateStateAndRender는 router.updateState(newState, { onSuccess: () => render() }); 로 쓰면 함수 하나로 통합할 수 있습니다.

Comment thread src/router.js
{ path: "/", component: home, isDetail: false },
{ path: "/product/:id", component: ProductDetail, isDetail: true },
];
class Router {

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

라우터를 처음 클래스 형식으로 만들어봤습니다. 저 혼자 만든게 아니라 재미니와 같이 만들어봤는데요.
제가 아예 처음이다 보니 형식이나 구조가 맞는건지 전혀 모르겠습니다. 눈치 껏 쓰긴 썼는데 좋은 방법이 있다면 남겨주세요 감사합니다!

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

render 부분을 라우터 외부로 분리하면 더 좋을 것 같아요!

@JunilHwang JunilHwang closed this Jul 13, 2025
@JunilHwang JunilHwang reopened this Jul 13, 2025
Comment thread src/components/header.js
<div class="max-w-md mx-auto px-4 py-4">
<div class="flex items-center justify-between">
<h1 class="text-xl font-bold text-gray-900">
<a href="${router.getAppPath("/")}" data-link="">쇼핑몰</a>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

오 이거 좋네유

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

칭찬 받았다... 좋다고 해줬다...

Comment thread src/utils/cart.js
Comment on lines +5 to +6
const cart = localStorage.getItem(CART_KEY);
return cart ? JSON.parse(cart) : [];

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

소소한 리뷰

Suggested change
const cart = localStorage.getItem(CART_KEY);
return cart ? JSON.parse(cart) : [];
return JSON.parse(localStorage.getItem(CART_KEY) ?? '[]');

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

아 맞네... 널병합... 감삼다 ㅎㅎㅎ

Comment thread src/utils/commonFunc.js
@@ -0,0 +1,11 @@
export const formatPrice = (price) => {
if (price === undefined || price === null) {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

소소)

널리쉬 한 비교는 이렇게 해도 가능해유

Suggested change
if (price === undefined || price === null) {
if (price == null) {

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

너무 요란하게 비교를 해버렸네요 감사합니다!

@JunilHwang
JunilHwang force-pushed the main branch 2 times, most recently from a90ad7b to d5eb31b Compare September 26, 2025 01:13
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.

6 participants