[4팀 김도현] Chapter3-2. 디자인 패턴과 함수형 프로그래밍 그리고 상태 관리 설계

.github/workflows/deploy.yml

@@ -0,0 +1,64 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: latest
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "pnpm"
+
+      - name: Remove pnpm-workspace.yaml
+        run: rm -f pnpm-workspace.yaml
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Build basic
+        run: pnpm run build --config vite.config.basic.ts
+
+      - name: Build advanced
+        run: pnpm run build --config vite.config.advanced.ts
+
+      - name: Rename index files
+        run: |
+          mv dist/basic/index.basic.html dist/basic/index.html
+          mv dist/advanced/index.advanced.html dist/advanced/index.html
+
+      - name: Copy root index.html
+        run: cp index.html dist/index.html
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./dist"
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -1,18 +1,19 @@
-# Chapter3-2. 디자인 패턴과 함수형 프로그래밍 그리고 상태 관리 설계
+# Chapter3-2. 디자인 패턴과 함수형 프로그래밍 그리고 상태 관리 설계 - 4팀 김도현
 
 ## 기본과제: 거대 단일 컴포넌트 리팩토링
 
 이번 과제는 단일책임원칙을 위반한 거대한 컴포넌트를 리팩토링 하는 것입니다. React의 컴포넌트는 단일 책임 원칙(Single Responsibility Principle, SRP)을 따르는 것이 좋습니다. 즉, 각 컴포넌트는 하나의 책임만을 가져야 합니다. 하지만 실제로는 여러 가지 기능을 가진 거대한 컴포넌트를 작성하는 경우가 많습니다.
 
 [목표]
+
 ## 1. 취지
+
 - React의 추구미(!)를 이해해보아요!
 - 단일 책임 원칙(SRP)을 위반한 거대한 컴포넌트가 얼마나 안 좋은지 경험해보아요!
 - 단일 책임이라는 개념을 이해하기 상태, 순수함수, 컴포넌트, 훅 등 다양한 계층을 이해해합니다.
 - 엔티티와 UI를 구분하고 데이터, 상태, 비즈니스 로직 등의 특징이 다르다는 것을 이해해보세요.
 - 이를 통해 적절한 Custom Hook과 유틸리티 함수를 분리하고, 컴포넌트 계층 구조를 정리하는 능력을 갖춥니다!
 
-
 ## 2. 목표
 
 모든 소프트웨어에는 적절한 책임과 계층이 존재합니다. 하나의 계층(Component)만으로 소프트웨어를 구성하게 되면 나중에는 정리정돈이 되지 않은 코드를 만나게 됩니다. 예전에는 이러한 BestPractice에 대해서 혼돈의 시대였지만 FE가 진화를 거듭하는 과정에서 적절한 계측에 대한 합의가 이루어지고 있는 상태입니다.
@@ -22,7 +23,7 @@ React의 주요 책임 계층은 Component, hook, function 등이 있습니다.
 - 엔티티를 다루는 상태와 그렇지 않은 상태 - cart, isCartFull vs isShowPopup
 - 엔티티를 다루는 컴포넌트와 훅 - CartItemView, useCart(), useProduct()
 - 엔티티를 다루지 않는 컴포넌트와 훅 - Button, useRoute, useEvent 등
-- 엔티티를 다루는 함수와 그렇지 않은 함수 - calculateCartTotal(cart)  vs capaitalize(str)
+- 엔티티를 다루는 함수와 그렇지 않은 함수 - calculateCartTotal(cart) vs capaitalize(str)
 
 이번 과제의 목표는 이러한 계층을 이해하고 분리하여 정리정돈을 하는 기준이나 방법등을 습득하는데 있습니다.
 
@@ -35,34 +36,34 @@ React의 주요 책임 계층은 Component, hook, function 등이 있습니다.
 #### 1) 장바구니 페이지 요구사항
 
 - 상품 목록
-    - 상품명, 가격, 재고 수량 등을 표시
-    - 각 상품의 할인 정보 표시
-    - 재고가 없는 경우 품절 표시가 되며 장바구니 추가가 불가능
+  - 상품명, 가격, 재고 수량 등을 표시
+  - 각 상품의 할인 정보 표시
+  - 재고가 없는 경우 품절 표시가 되며 장바구니 추가가 불가능
 - 장바구니
-    - 장바구니 내 상품 수량 조절 가능
-    - 각 상품의 이름, 가격, 수량과 적용된 할인율을 표시
-        - 적용된 할인율 표시 (예: "10% 할인 적용")
-    - 장바구니 내 모든 상품의 총액을 계산해야
+  - 장바구니 내 상품 수량 조절 가능
+  - 각 상품의 이름, 가격, 수량과 적용된 할인율을 표시
+    - 적용된 할인율 표시 (예: "10% 할인 적용")
+  - 장바구니 내 모든 상품의 총액을 계산해야
 - 쿠폰 할인
-    - 할인 쿠폰을 선택하면 적용하면 최종 결제 금액에 할인정보가 반영
+  - 할인 쿠폰을 선택하면 적용하면 최종 결제 금액에 할인정보가 반영
 - 주문요약
-    - 할인 전 총 금액
-    - 총 할인 금액
-    - 최종 결제 금액
+  - 할인 전 총 금액
+  - 총 할인 금액
+  - 최종 결제 금액
 
 #### 2) 관리자 페이지 요구사항
 
 - 상품 관리
-    - 상품 정보 (상품명, 가격, 재고, 할인율) 수정 가능
-    - 새로운 상품 추가 가능
-    - 상품 제거 가능
+  - 상품 정보 (상품명, 가격, 재고, 할인율) 수정 가능
+  - 새로운 상품 추가 가능
+  - 상품 제거 가능
 - 할인 관리
-    - 상품별 할인 정보 추가/수정/삭제 가능
-    - 할인 조건 설정 (구매 수량에 따른 할인율)
+  - 상품별 할인 정보 추가/수정/삭제 가능
+  - 할인 조건 설정 (구매 수량에 따른 할인율)
 - 쿠폰 관리
-    - 전체 상품에 적용 가능한 쿠폰 생성
-    - 쿠폰 정보 입력 (이름, 코드, 할인 유형, 할인 값)
-    - 할인 유형은 금액 또는 비율로 설정 가능
+  - 전체 상품에 적용 가능한 쿠폰 생성
+  - 쿠폰 정보 입력 (이름, 코드, 할인 유형, 할인 값)
+  - 할인 유형은 금액 또는 비율로 설정 가능
 
 ### (2) 코드 개선 요구사항
 
@@ -88,20 +89,18 @@ React의 주요 책임 계층은 Component, hook, function 등이 있습니다.
 
 ### (3) 테스트 코드 통과하기
 
-
-
 ## 심화과제: Props drilling
+
 > **이번 심화과제는 Props drilling을 없애기 입니다.**
 
 # 2. 목표
 
 - basic에서 열심히 컴포넌트를 분리해주었겠죠?
 - 아마 그 과정에서 container - presenter 패턴으로 만들어졌기에 props drilling이 상당히 불편했을거에요.
 - 그래서 심화과제에서는 props drilling을 제거하는 작업을 할거에요.
-    - 전역상태관리가 아직 낯설다. - jotai를 선택해주세요 (참고자료 참고)
-    - 나는 React만으로 해보고 싶다. - context를 선택해서 상태관리를 해보세요.
-    - 나는 지금 대세인 Zustand를 할거에요. - zustand를 선택해주세요.
-
+  - 전역상태관리가 아직 낯설다. - jotai를 선택해주세요 (참고자료 참고)
+  - 나는 React만으로 해보고 싶다. - context를 선택해서 상태관리를 해보세요.
+  - 나는 지금 대세인 Zustand를 할거에요. - zustand를 선택해주세요.
 
 ### (1) 요구사항
 
@@ -112,8 +111,8 @@ React의 주요 책임 계층은 Component, hook, function 등이 있습니다.
 ### (2) 힌트
 
 - UI 컴포넌트와 엔티티 컴포넌트는 각각 props를 다르게 받는게 좋습니다.
-  - UI 컴포넌트는 재사용과 독립성을 위해 상태를 최소화하고, 
+  - UI 컴포넌트는 재사용과 독립성을 위해 상태를 최소화하고,
   - 엔티티 컴포넌트는 가급적 엔티티를 중심으로 전달받는 것이 좋습니다.
 - 특히 콜백의 경우,
   - UI 컴포넌트는 이벤트 핸들러를 props로 받아서 처리하도록 해서 재사용성을 높이지만,
-  - 엔티티 컴포넌트는 props가 아닌 컴포넌트 내부에서 상태를 관리하는 것이 좋습니다.
+  - 엔티티 컴포넌트는 props가 아닌 컴포넌트 내부에서 상태를 관리하는 것이 좋습니다.

index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title>Chapter 3-2</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+</head>
+<body class="bg-gray-100 min-h-screen flex items-center justify-center">
+  <div class="text-center space-y-8">
+    <h1 class="text-3xl font-bold text-gray-800">Chapter 3-2</h1>
+    <p class="text-gray-600">디자인 패턴과 함수형 프로그래밍 그리고 상태 관리 설계</p>
+    <div class="flex gap-4 justify-center">
+      <a href="./basic/" class="px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors">
+        Basic Version
+      </a>
+      <a href="./advanced/" class="px-6 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors">
+        Advanced Version
+      </a>
+    </div>
+  </div>
+</body>
+</html>

package.json

@@ -16,6 +16,7 @@
     "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0"
   },
   "dependencies": {
+    "jotai": "^2.15.2",
     "react": "^19.1.1",
     "react-dom": "^19.1.1"
   },