annkimm 님의 상세페이지[8팀 김민지] Chapter 1-1. 프레임워크 없이 SPA 만들기

과제 체크포인트

배포 링크

https://annkimm.github.io/front_6th_chapter1-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로 다시 구현한다.
  • 이 과정에서 직접 가공하는 것은 최대한 지양한다.

과제 셀프회고

처음에 project.list.test는 무한 스크롤 빼면 대부분 무난하게 잘 코딩이 됐는데, 가장 문제가 되고 뒤에 진도를 나가지 못했던 건 단위 테스트에서 라우터 이동해서 상세 페이지에 데이터가 나오는 부분이었다. 분명 실제 화면에서는 잘 나오는데 뭐 잘못된건지 알 수가 없었다. 처음에는 테스트 코드에서 라우터 이동을 잘 감지 못해서 안되는지 알았다. 그래서 라우터와 관련된 코딩만 주구장창 건드렸다. 근데 알고 보니 클릭하는 함수의 바인딩 문제가 해결되지 않는 이슈 때문에 잘되지 않았다. 근데 change 함수나 이런건 잘 됐는데 클릭 이벤트 함수가 명확하게 선택되지 않는 선택자 문제때문에 바인딩 이슈가 됐던걸까... 너무 늦게 해결해서 마지막에 리팩토링 없이 끝낸게 좀 아쉽다.

기술적 성장

있을까...

자랑하고 싶은 코드

없습니다.

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

모든 게 다...?

학습 효과 분석

과제 피드백

과제의 양이 너무 많았습니다... 많았어요...

AI 활용 경험 공유하기

리뷰 받고 싶은 내용

셀프 회고를 보시면 아시다시피 버튼 클릭해서 상세 페이지로 이동하는 부분에서 애먹어서 다 시간을 뺐겼습니다. 사아실 다른 검색이벤트나 select 이벤트는 잘됐는데 위의 부분이 안됐는지 잘 이해가 안되기도 하고... 이게 리액트의 전체 렌더링 과정에 대한 이해도의 부족이라서 그랬던 건지 잘 모르겠습니다. 만약에 렌더링 과정에 대한 이해 부족이라면 어떤걸 더 공부해야하나요? 아니라면 어떤 부분을 더 공부해야 할지 추천해주시면 감사하겠습니다.

과제 피드백

민지님 첫 과제 고생많이 하셨습니다. 회고 남겨주신걸 보니 약간 힘들어보이시는데요 ㅎㅎㅎ 너무 자신감을 잃지 않으셨으면 좋겠네요. 과제 자체가 양이 많기도 했고 정신이 없는 상황이 많기도 했구요. 결국 중요한건 굉장히 많은 비즈니스 로직을 구현하는 것 보다는 민지님이 남겨주신 회고처럼 어느 부분에서 어려움을 겪었는지 다시 정확히 정리해보고 내가 사용하는 프레임워크에서는 또는 기술에서는 이걸 어떻게 해결하는지 찾아보는 것 같아요. 문제 겪으신 부분을 리액트나 뷰에서는 이런 과정을 명확하게 하기위해 어떻게 관리하는지, 라이프 사이클은 어떻게 제어할지 그런 고민들을 해보면 좋을 것 같아요. 말씀해주신 렌더링 과정에 대한 이해도 포함이 되겠죠. 그리고 그 내용을 다시 본인의 코드로 옮기는 연습을 하는거죠. 사실 저건 해당 문제를 해결하기 위한 각 프레임워크의 해결책이고 정답은 아니니 제것에 맞게 옮기는 연습을 하는게 중요한 것 같아요. 여담으로 저도 늘 어렵지만, 테스트 코드에서 라우터 이동을 감지 못해서 그런줄 알고 많은 시간을 쏟으셨지만 알고 보니 바인딩 이슈였던 것 처럼 문제를 명확하게 정의하는 연습도 함께 하면 더 시간을 아낄 수 있지 않을까 싶어요. 추측은 그 과정에서 배우는 것은 많겠지만 실패했을 때 낭비되는 시간이 너무 많은 것 같아서요. 문제를 명확하게 하고 움직이는 걸로 ㅎㅎ

고생하셨고 충분히 잘하셨으니까 다음주도 화이팅하시구요! 이번주에 부족하다고 느끼셨던 부분들도 그냥 넘기지 말고 잘 모아둔다음 시간 여유가 생길때 꼭 해결해보는 습관 만드시면 좋겠습니다~