Skip to content

[8팀 김민지] Chapter 1-1. 프레임워크 없이 SPA 만들기 - #35

Open
annkimm wants to merge 15 commits into
hanghae-plus:mainfrom
annkimm:main
Open

[8팀 김민지] Chapter 1-1. 프레임워크 없이 SPA 만들기 #35
annkimm wants to merge 15 commits into
hanghae-plus:mainfrom
annkimm:main

Conversation

@annkimm

@annkimm annkimm commented Jul 6, 2025

Copy link
Copy Markdown

과제 체크포인트

배포 링크

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 이벤트는 잘됐는데 위의 부분이 안됐는지 잘 이해가 안되기도 하고...
이게 리액트의 전체 렌더링 과정에 대한 이해도의 부족이라서 그랬던 건지 잘 모르겠습니다.
만약에 렌더링 과정에 대한 이해 부족이라면 어떤걸 더 공부해야하나요?
아니라면 어떤 부분을 더 공부해야 할지 추천해주시면 감사하겠습니다.

@annkimm annkimm changed the title init: install playwright [8팀 김민지] Chapter 1-1. 프레임워크 없이 SPA 만들기 Jul 6, 2025
@annkimm
annkimm force-pushed the main branch 2 times, most recently from edbf180 to c4caad2 Compare July 9, 2025 13:22
@annkimm
annkimm marked this pull request as ready for review July 12, 2025 04:44
@annkimm
annkimm force-pushed the main branch 3 times, most recently from 011d832 to 00550b0 Compare July 12, 2025 12:46

@unseoJang unseoJang left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

민지님~첫 과제 너무 고생 많으셧어요!
과제 통과 못할줄 알앗는데 통과해서 너무 다행이에요 흑흑 ㅜㅜ
다음과제는 통과하고 나서 전체적으로 공부한다는 생각으로 “유지보수성”, “확장성”, “성능”, “역할 분리” 등등을 고민해보면서 코드를 짜면 더 좋을 것같아요
멘토링 시간에 꼭 이러한 부분들 적극적으로 질문 하면 너무 좋을것 같아요

수고하셨습니다 민지님~👍👍👍👍

p.s : 민지님 깃 커밋 컨벤션도 한번 공부하면 좋을것같아요, 컨벤션이 제대로 갖춰지면 코치님들, 더 나아가 협업하는데 있어서 훨씬 더 나은 협업을, 리뷰를 받을수 있어요!

https://velog.io/@shin6403/Git-git-%EC%BB%A4%EB%B0%8B-%EC%BB%A8%EB%B2%A4%EC%85%98-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

다음 과제는 꼭 완성을 목표로 합시다!!!아자아자!
저도 몰랐는데 CI에서 걸리면 리뷰가 제대로 안달리네요

// 상품을 장바구니에 추가하고 수량을 2개로 증가
await addProductToCart("pvc 투명 젤리 쇼핑백");

// 모달이 열리는 타이밍

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

주석 잘 달앗네요!

import { screen } from "@testing-library/dom";
import { userEvent } from "@testing-library/user-event";
import { afterEach, beforeAll, describe, expect, test } from "vitest";
import { afterEach, beforeAll, describe, expect, test, beforeEach } from "vitest";

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

beforeEach는 테스트 코드 개별 함수에 셋팅하는 메서드에요 테스트코드 챕터 있으니 미리미리 알아두면 좋아요!

Comment thread src/components/detail.js

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

컴포넌트 UI 규모에 비해 하나의 함수에 너무 많은 역할을 넣어놨네요, 코드 가독성과 유지보수성, 테스트 편의성을 생각하면 적절히 컴포넌트 단위로 분리를 먼저 했으면 더 빨리 과제를 진행했을 것 같아요!
그룹화 -> 구조화 -> 절차적으로 코드 진행 이런식으로 과제 진행 하면 점차 속도가 붙을거에요

Comment thread src/pages/HomePage.js
import { router } from "../main";
import { Main } from "./Main";

let state = {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

state로 선언하고 전역에서 쓰이다보니 중복된 렌더링 코드가 여기저기 있을수 밖에 없네요

// 상태와 렌더 함수를 이 모듈에서 관리
export const state = {
  products: [],
  pagination: {},
  filters: {},
  category: {},
  isLoading: false,
};

export function updateState(partialState) {
  Object.assign(state, partialState);
}

이런식으로 추상화 시켜서 state를 관리하면 좋을것 같아요

Comment thread src/pages/HomePage.js

state.isLoading = false;

document.body.querySelector("#root").innerHTML = Main(state);

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

최상단부터 최하단 까지 7번 나오네요, render() 함수 따로 선언하면 좋을 것 같아요

Comment thread src/pages/HomePage.js

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

민지님 코드 잘 짜주셨어요, 로컬스토리지로 장바구니 구현하는 부분도 잘 해주셨고, 무한 스크롤, URL 파라미터 기반 상태 초기화 흐름이 명확하게 잘 들어나는 것 같아요,
아직 확장성, 코드 응집도, 상수화 등 고민해야될 부분이 많은데 2챕터에서 그런부분들은 배울 수 있으니까 너무 고민하지 말고 일단은 흐름대로 코드 짜는걸 추천 드려요

import { getProduct, getProducts } from "../api/productApi";
import { _404_ } from "./NotFoundPage";

let projectDetailState = {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

이부분도 마찬가지로 전역함수로 선언되서 추상화가 안되고 여기저기서 쓰게되면 키값 자체가 바뀔 위험성이 있어요.
const 로 선언해도 키에대한 value 값은 바꿀수 있잖아요.

} else {
projectDetailState.loading = true;

document.body.querySelector("#root").innerHTML = ProjectDetail(projectDetailState);

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

→ loading spinner 등 UX 표현이 아니라면, 첫 번째 렌더는 생략해도 괜찮습니다
아니면

if (projectDetailState.loading) {
  return `<p>로딩 중입니다...</p>`;
}

이런식으로 구분해서 UI로 구현해도 좋아요

document.body.querySelector("#root").innerHTML = ProjectDetail(projectDetailState);
}

function onMiusClick() {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

혹시 장바구니 갯수가 0이하가 되도 괜찮나요??그거에 대한 방어코드가 빠졋네요

@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.

3 participants