Feat/setting/folder structure/DEVING-27

package.json

@@ -29,6 +29,7 @@
     "@types/react-dom": "^18",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
+    "autoprefixer": "^10.4.20",
     "eslint": "^8.56.0",
     "eslint-config-next": "14.1.0",
     "eslint-config-prettier": "^9.1.0",

src/app/layout.tsx

@@ -1,5 +1,5 @@
 import type { Metadata } from 'next';
-import './globals.css';
+import '../styles/globals.css';
 
 export const metadata: Metadata = {
   title: 'Create Next App',

src/app/test/components/TestComponent.tsx

@@ -0,0 +1,5 @@
+const TestComponent = () => {
+  return <div>test 페이지에서만 종속되는 컴포넌트들이 포함되어야 합니다.</div>;
+};
+
+export default TestComponent;

src/app/test/page.tsx

@@ -0,0 +1,10 @@
+function TestPage() {
+  return (
+    <div>
+      테스트 페이지 입니다. 페이지임을 식별하기 위해 접미사로 Page를 붙입니다.
+      페이지 컴포넌트는 함수 선언문을 사용합니다.
+    </div>
+  );
+}
+
+export default TestPage;

src/assets/README.md

@@ -0,0 +1,3 @@
+## assets 폴더
+
+### 프로젝트에서 사용되는 정적 자산을 포함하는 폴더입니다.

src/components/README.md

@@ -0,0 +1,9 @@
+## components 폴더
+
+### 공통으로 사용되는 컴포넌트를 정의하는 폴더입니다.
+
+common 폴더에는 공통으로 사용되는 조합 컴포넌트를 정의합니다.
+ex) ProfileCard
+
+ui 폴더에는 공통으로 사용되는 상태나 비즈니스 로직이 없는 순수 컴포넌트를 정의합니다.
+ex) Card

src/hooks/README.md

@@ -0,0 +1,7 @@
+## hooks 폴더
+
+### 커스텀 훅을 정의하는 폴더입니다.
+
+common 폴더에는 전역에서 사용할 커스텀 훅들을 정의합니다.<br/>
+queries 폴더에는 tanstack-query의 useQuries를 사용한 커스텀 훅들을 정의합니다.<br/>
+mutations 폴더에는 tanstack-query의 useMutations를 사용한 커스텀 훅들을 정의합니다.

src/lib/README.md

@@ -0,0 +1,5 @@
+## lib 폴더
+
+### 외부 라이브러리 연동 코드 및 로직을 모아두는 폴더입니다.
+
+axios, react-query 같은 서드파티 라이브러리 초기화 등을 정의합니다. <br/>

src/service/README.md

@@ -0,0 +1,5 @@
+## service 폴더
+
+### 핵심 비즈니스 로직과 API 호출을 관리하는 폴더입니다.
+
+api > endpoints 폴더에는 API 엔드포인트를 상수로 관리합니다.

src/service/api/endpoints.ts

@@ -0,0 +1,5 @@
+export const API_BASE_URL = 'http://3.34.218.217:8080/';
+
+export const ENDPOINTS = {
+  TEST: `${API_BASE_URL}/test`,
+} as const;

src/store/README.md

@@ -0,0 +1,3 @@
+## store 폴더
+
+### 전역으로 사용될 스토어를 정의하는 폴더입니다.

src/styles/README.md

@@ -0,0 +1,3 @@
+## styles 폴더
+
+### 전역으로 사용될 css 파일을 모아두는 폴더입니다.

src/types/README.md

@@ -0,0 +1,3 @@
+## types 폴더
+
+### 전역으로 사용될 타입을 모아두는 폴더입니다.

src/util/README.md

@@ -0,0 +1,5 @@
+## util 폴더
+
+### 프로젝트에서 재사용되는 유틸리티 함수들을 모아두는 폴더입니다.
+
+문자열 포맷팅, 날짜처리, 공통 헬퍼 함수 등을 정의합니다.

tsconfig.json

@@ -19,9 +19,9 @@
         "name": "next"
       }
     ],
-    "baseUrl": "src",
+    "baseUrl": "./src",
     "paths": {
-      "@/*": ["src/*"],
+      "@/*": ["/*"],
       "@/app/*": ["app/*"],
       "@/components/*": ["components/*"],
       "@/hooks/*": ["hooks/*"],