From ffc2b4a24a50312c2ca5e1bb90857bf9e8f2491e Mon Sep 17 00:00:00 2001
From: sohot8653 <kmbin92@stam.kr>
Date: Thu, 25 Sep 2025 15:56:20 +0900
Subject: [PATCH] =?UTF-8?q?[README.md=20=EC=97=85=EB=8D=B0=EC=9D=B4?=
 =?UTF-8?q?=ED=8A=B8]=20=EC=BB=B4=ED=8F=AC=EB=84=8C=ED=8A=B8=20=ED=8F=B4?=
 =?UTF-8?q?=EB=8D=94=20=EA=B5=AC=EC=A1=B0=20=EB=B0=8F=20=EC=82=AC=EC=9A=A9?=
 =?UTF-8?q?=EB=B2=95=20=EC=B6=94=EA=B0=80,=20=EC=9E=90=EB=8F=99=20?=
 =?UTF-8?q?=EC=9E=84=ED=8F=AC=ED=8A=B8=20=EC=84=A4=EC=A0=95=20=EC=84=A4?=
 =?UTF-8?q?=EB=AA=85=20=EB=B3=B4=EA=B0=95,=20=ED=8E=98=EC=9D=B4=EC=A7=80?=
 =?UTF-8?q?=20=EA=B5=AC=EC=84=B1=20=EB=B0=8F=20=ED=8C=9D=EC=97=85=20?=
 =?UTF-8?q?=EC=83=9D=EC=84=B1=20=EB=B0=A9=EB=B2=95=EC=97=90=20=EB=8C=80?=
 =?UTF-8?q?=ED=95=9C=20=EC=84=B8=EB=B6=80=20=EC=A0=95=EB=B3=B4=20=EC=97=85?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 105 ++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 82 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 5435984..45c6632 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,76 @@
 # bio_frontend
 
 ## NUXT 3 (VUE 3) 환경
- - data-list 와 dataList는 동일 변수명으로 인식
- - compnenets 아래의 .vue는 자동 인식(template 내부에서만, 별도 script에서 필요시 선언 필요)
 
+- data-list 와 dataList는 동일 변수명으로 인식
+- compnenets 아래의 .vue는 자동 인식(template 내부에서만, 별도 script에서 필요시 선언 필요)
 
 # 구성 요소
+
 ## components 구성
+
+### 폴더 구조
+
 ```
-components
- |- base      // 기본 요소(button, input, grid, popup)
- |- layout    // 레이아웃 요소(header, footer, sidebar, wrapper)
- |- module    // 특정 기능 단위(card, form, list)
- |- pages     // 특정 페이지 전용
+components/
+├── base/                    // 기본 UI 요소 (접두사 없이 사용)
+│   ├── button/
+│   │   ├── CommonButton.vue
+│   │   └── PermissionButton.vue
+│   ├── grid/
+│   │   └── ToastGrid.vue
+│   ├── info/
+│   │   └── PageDescription.vue
+│   ├── loading/
+│   │   └── GlobalLoading.vue
+│   └── popup/
+│       └── CommonPopup.vue
+├── layout/                  // 레이아웃 요소 (접두사 없이 사용)
+│   ├── navigation/
+│   │   ├── AppHeader.vue
+│   │   ├── SubMenuBar.vue
+│   │   └── TabBar.vue
+│   └── wrapper/
+│       ├── ContentsWrapper.vue
+│       └── PopupWrapper.vue
+└── domain/                  // 도메인별 기능 컴포넌트 (@domain/ 접두사 사용)
+    └── culture-graph/
+        ├── BatchGraph.vue
+        ├── BatchTabs.vue
+        └── CustomContextMenu.vue
 ```
 
+### 자동 임포트 설정 (nuxt.config.ts)
+
+```typescript
+components: [
+  { path: "~/components/base", pathPrefix: false },    // @base/ 접두사 제거
+  { path: "~/components/layout", pathPrefix: false },  // @layout/ 접두사 제거
+  { path: "~/components/domain", pathPrefix: true },   // @domain/ 접두사 유지
+],
+```
+
+### 컴포넌트 사용법
+
+- **base/**, **layout/** 폴더의 컴포넌트\*\*: 접두사 없이 직접 사용
+
+  ```vue
+  <template>
+    <CommonButton />
+    <ToastGrid />
+    <ContentsWrapper />
+  </template>
+  ```
+
+- **domain/** 폴더의 컴포넌트: `@domain/` 접두사 사용
+  ```vue
+  <template>
+    <DomainCultureGraphBatchGraph />
+  </template>
+  ```
+
 ## page 구성
+
 ```
 pages         // 단일 화면(비 탭 요소)
 |- popup      // 팝업 요소
@@ -25,7 +80,9 @@ pages         // 단일 화면(비 탭 요소)
 ```
 
 # page(페이지) 생성 요소
+
 ## 공통 페이지 구성
+
 ```
 <template>
     <ContentsWrapper> <!-- wrapper(title) 추가 -->
@@ -46,25 +103,25 @@ pages         // 단일 화면(비 탭 요소)
 </script>
 ```
 
-
 ## Toast(Tui) Grid 사용법
+
 한글 설명: https://github.com/nhn/tui.grid/blob/master/packages/toast-ui.grid/docs/v4.0-migration-guide-kor.md
 
-
 ### 기본 설정
+
 ```
 <template>
     <button @click="onAddClick">추가</button>
     <button @click="onUpdateClick">저장</button>
 
     <!-- toast Grid 필수값 ref, data, columns(header) -->
-    <ToastGrid  
+    <ToastGrid
         ref="grid1Ref"
         :data="data"
         :columns="colDefs"
-    />        
+    />
 </template>
-  
+
 <script setup lang="ts">
 // 컬럼 항목 리스트
 // composables폴더 아래에 생성
@@ -87,7 +144,7 @@ let no = 1;
 
 // 항목 추가 버튼
 function onAddClick() {
-  grid1Ref.value?.api()?.appendRow({'no': no}); // ref api를 통해서 항목 추가  
+  grid1Ref.value?.api()?.appendRow({'no': no}); // ref api를 통해서 항목 추가
   ++no;
 }
 
@@ -95,20 +152,21 @@ function onAddClick() {
 function onUpdateClick() {
    //grid1Ref.value?.clearGrid();
   const chageList = grid1Ref.value?.api()?.getModifiedRows(); // ref api를 통해서 변경점 읽어오기
-  console.log(changeList);  
+  console.log(changeList);
 }
 </script>
-```  
+```
 
 ## tree data
+
 ```
 <template>
-  <ToastGrid  
+  <ToastGrid
     ref="grid1Ref"
     :data="data"
     :columns="columns"
     :treeColumnOptions="treeColumnOptions"
-  />  
+  />
 </template>
 
 <script setup lang="ts">
@@ -227,8 +285,8 @@ poupWrapper.vue - top, middle, bottom으로 구성된 팝업 구조
 2. 사용할 페이지에서 생성한 팝업 추가
 ```
 
-
 ### 팝업 생성
+
 ```
 // examplePopup.vue
 <template>
@@ -238,11 +296,11 @@ poupWrapper.vue - top, middle, bottom으로 구성된 팝업 구조
       <template #top>
         <h2>팝업 제목</h2>
       </template>
-  
+
       <template #middle>
         <!-- 팝업 본문 -->
       </template>
-  
+
       <template #bottom>
         <button>추가 버튼</button>
         <!-- 닫기 버튼은 자동 생성 -->
@@ -250,7 +308,7 @@ poupWrapper.vue - top, middle, bottom으로 구성된 팝업 구조
     </PopupWrapper>
   </div>
 </template>
-  
+
 <script setup lang="ts">
   // 숨김 여부 지정
   const show = defineModel('show', {type: Boolean, default:false});
@@ -258,6 +316,7 @@ poupWrapper.vue - top, middle, bottom으로 구성된 팝업 구조
 ```
 
 ### 팝업 사용
+
 ```
 <template>
   <button @click="popupShow = true">팝업 실행</button>
@@ -269,8 +328,8 @@ poupWrapper.vue - top, middle, bottom으로 구성된 팝업 구조
 </script>
 ```
 
-
 ## 탭 구성
+
 ```
 // layouts/default.vue
 // stores/tab.ts
@@ -298,4 +357,4 @@ tabsStore.setActiveTab(key);
   {{ tab.label }}
   <span v-show="tabsStore.activeTab !== tab.key" class="close-btn" @click.stop="tabsStore.removeTab(tab.key)"> × </span>
 </div>
-```
\ No newline at end of file
+```