refactor: 폴더명 및 파일명 패턴 통일 (대괄호 안에 영문키)

패턴을 반대로 변경하여 일관성 향상:
- 폴더: 숫자) 한글명 [영문키] → 영문키 추출
  - 예: 1) 어드민 [Admin] → Admin
  - 예: 7) 어드민 [Admin] → Admin
- 파일: 한글명 [영문키] → 영문키 추출
  - 예: 멘토 목록 조회 [get-mentor-list].bru → get-mentor-list

변경 사항:
- 모든 extractDomain 함수 수정 (3개 파일)
- queryKeyGenerator.ts 파일명 추출 로직 수정
- apiClientGenerator.ts 파일명 추출 로직 수정
- 테스트 fixture 파일명 변경
- 테스트 케이스 업데이트
- 문서 전체 업데이트

장점:
- 대괄호 안이 항상 영문키로 통일되어 일관성 향상
- 폴더명과 파일명 패턴이 동일하여 학습 비용 감소

Author: manNomi

docs/bruno-guide.md

@@ -152,25 +152,26 @@ docs {
 
 #### 지원하는 형식
 
-1. **`[한글명] 숫자 영문키` 형식** (권장)
+1. **`숫자) 한글명 [영문키]` 형식** (권장)
 
    ```
-   [어드민] 7 Admin/          → 생성 폴더: 7 Admin
-   [사용자] 8 Users/          → 생성 폴더: 8 Users
-   [멘토] 9 Mentor/           → 생성 폴더: 9 Mentor
+   1) 어드민 [Admin]/          → 생성 폴더: Admin
+   7) 어드민 [Admin]/          → 생성 폴더: Admin
+   8) 사용자 [Users]/          → 생성 폴더: Users
+   9) 멘토 [Mentor]/           → 생성 폴더: Mentor
    ```
 
-   - 대괄호 뒤의 모든 내용(숫자 + 영문키)이 폴더명이 됩니다
-   - 한글명은 가독성을 위해 사용, 실제 폴더명에는 포함되지 않음
+   - 대괄호 안의 `영문키`만 사용됩니다
+   - 숫자와 한글명은 가독성을 위해 사용, 실제 폴더명에는 포함되지 않음
 
-2. **`한글명 [EnglishKey]` 형식** (기존 방식, 호환)
+2. **`한글명 [영문키]` 형식** (기존 방식, 호환)
 
    ```
    지원서 [applications]/    → 생성 폴더: applications
    사용자 [users]/            → 생성 폴더: users
    ```
 
-   - 대괄호 안의 `EnglishKey`만 사용됩니다
+   - 대괄호 안의 `영문키`만 사용됩니다
    - 기존 프로젝트와 호환됩니다
 
 3. **영문 폴더명** (가장 단순)
@@ -184,7 +185,8 @@ docs {
 
 | Bruno 폴더명            | 생성되는 폴더  | 설명                  |
 | ----------------------- | -------------- | --------------------- |
-| `[어드민] 7 Admin`      | `7 Admin`      | 숫자와 공백 포함 가능 |
+| `1) 어드민 [Admin]`      | `Admin`        | 대괄호 안의 키만 사용 |
+| `7) 어드민 [Admin]`      | `Admin`        | 숫자는 무시됨         |
 | `지원서 [applications]` | `applications` | 대괄호 안의 키만 사용 |
 | `users`                 | `users`        | 그대로 사용           |
 
@@ -194,16 +196,16 @@ docs {
 
 #### 지원하는 형식
 
-1. **`[한국어 키] 영어` 형식** (권장, 폴더명과 동일한 패턴)
+1. **`한글명 [영문키]` 형식** (권장, 폴더명과 동일한 패턴)
 
    ```
-   [멘토 목록 조회] get-mentor-list.bru     → get-mentor-list → getMentorList
-   [사용자 프로필] get-user-profile.bru      → get-user-profile → getUserProfile
-   [지원서 생성] post-create-application.bru → post-create-application → postCreateApplication
+   멘토 목록 조회 [get-mentor-list].bru     → get-mentor-list → getMentorList
+   사용자 프로필 [get-user-profile].bru      → get-user-profile → getUserProfile
+   지원서 생성 [post-create-application].bru → post-create-application → postCreateApplication
    ```
 
-   - 대괄호 뒤의 영문 부분만 사용됩니다
-   - 한글 설명은 가독성을 위해 사용, 실제 코드 생성에는 포함되지 않음
+   - 대괄호 안의 `영문키`만 사용됩니다
+   - 한글명은 가독성을 위해 사용, 실제 코드 생성에는 포함되지 않음
 
 2. **영문 파일명** (기존 방식, 호환)
 
@@ -220,11 +222,11 @@ docs {
 **✅ 올바른 예시:**
 
 ```
-[멘토 목록 조회] get-mentor-list.bru        → QueryKeys.mentors.getMentorList
-[사용자 프로필] get-user-profile.bru         → QueryKeys.users.getUserProfile
-[지원서 생성] post-create-application.bru     → QueryKeys.applications.postCreateApplication
-[프로필 수정] put-update-profile.bru          → QueryKeys.users.putUpdateProfile
-[사용자 삭제] delete-user.bru                → QueryKeys.users.deleteUser
+멘토 목록 조회 [get-mentor-list].bru        → QueryKeys.mentors.getMentorList
+사용자 프로필 [get-user-profile].bru         → QueryKeys.users.getUserProfile
+지원서 생성 [post-create-application].bru     → QueryKeys.applications.postCreateApplication
+프로필 수정 [put-update-profile].bru          → QueryKeys.users.putUpdateProfile
+사용자 삭제 [delete-user].bru                → QueryKeys.users.deleteUser
 ```
 
 #### 네이밍 규칙
@@ -254,41 +256,42 @@ docs {
 
 #### 파일명 예시
 
-| Bruno 파일명                          | 추출된 파일명          | 쿼리 키 이름               | 훅 이름                       |
-| ------------------------------------- | ---------------------- | -------------------------- | ----------------------------- |
-| `[멘토 목록 조회] get-mentor-list.bru` | `get-mentor-list`      | `getMentorList`            | `useGetMentorList`            |
-| `[사용자 프로필] get-user-profile.bru` | `get-user-profile`     | `getUserProfile`           | `useGetUserProfile`           |
-| `[지원서 생성] post-create.bru`        | `post-create`          | `postCreate`               | `usePostCreate`               |
-| `get-competitors.bru`                  | `get-competitors`      | `getCompetitors`           | `useGetCompetitors`           |
+| Bruno 파일명                           | 추출된 파일명             | 쿼리 키 이름               | 훅 이름                       |
+| -------------------------------------- | ------------------------- | -------------------------- | ----------------------------- |
+| `멘토 목록 조회 [get-mentor-list].bru` | `get-mentor-list`         | `getMentorList`            | `useGetMentorList`            |
+| `사용자 프로필 [get-user-profile].bru` | `get-user-profile`        | `getUserProfile`           | `useGetUserProfile`           |
+| `지원서 생성 [post-create].bru`        | `post-create`             | `postCreate`               | `usePostCreate`               |
+| `get-competitors.bru`                  | `get-competitors`         | `getCompetitors`           | `useGetCompetitors`           |
 | `멘토 목록 조회.bru`                   | `멘토 목록 조회` (비권장) | `멘토목록조회` (문제 가능) | `use멘토목록조회` (문제 가능) |
 
-**핵심**: 
-- `[한국어 키] 영어` 형식으로 작성하면 한글 설명과 영문 코드를 모두 활용할 수 있습니다
-- 영문 부분만 kebab-case로 작성하면, 자동으로 일관된 쿼리 키와 훅 이름이 생성됩니다!
+**핵심**:
+
+- `한글명 [영문키]` 형식으로 작성하면 한글 설명과 영문 코드를 모두 활용할 수 있습니다
+- 대괄호 안의 영문키만 kebab-case로 작성하면, 자동으로 일관된 쿼리 키와 훅 이름이 생성됩니다!
 
 ### 전체 구조 예시
 
 ```
 bruno/
-├── [어드민] 7 Admin/                              # 폴더명: 7 Admin
-│   ├── [목록 조회] get-list.bru                   # → QueryKeys["7 Admin"].getList
-│   ├── [생성] post-create.bru                    # → QueryKeys["7 Admin"].postCreate
-│   └── [수정] put-update.bru                     # → QueryKeys["7 Admin"].putUpdate
+├── 7) 어드민 [Admin]/                              # 폴더명: Admin
+│   ├── 목록 조회 [get-list].bru                   # → QueryKeys.Admin.getList
+│   ├── 생성 [post-create].bru                    # → QueryKeys.Admin.postCreate
+│   └── 수정 [put-update].bru                     # → QueryKeys.Admin.putUpdate
 ├── 지원서 [applications]/                        # 폴더명: applications
-│   ├── [경쟁자 조회] get-competitors.bru          # → QueryKeys.applications.getCompetitors
-│   ├── [상세 조회] get-details.bru                # → QueryKeys.applications.getDetails
-│   └── [지원서 생성] post-create.bru              # → QueryKeys.applications.postCreate
+│   ├── 경쟁자 조회 [get-competitors].bru          # → QueryKeys.applications.getCompetitors
+│   ├── 상세 조회 [get-details].bru                # → QueryKeys.applications.getDetails
+│   └── 지원서 생성 [post-create].bru              # → QueryKeys.applications.postCreate
 ├── 사용자 [users]/                                # 폴더명: users
-│   ├── [프로필 조회] get-profile.bru              # → QueryKeys.users.getProfile
-│   └── [프로필 수정] put-update-profile.bru       # → QueryKeys.users.putUpdateProfile
+│   ├── 프로필 조회 [get-profile].bru              # → QueryKeys.users.getProfile
+│   └── 프로필 수정 [put-update-profile].bru       # → QueryKeys.users.putUpdateProfile
 └── bruno.json
 ```
 
 **생성되는 구조:**
 
 ```
 src/apis/
-├── 7 Admin/
+├── Admin/
 │   ├── get-getList.ts
 │   ├── post-postCreate.ts
 │   └── index.ts

src/converter/openapiConverter.ts

@@ -133,18 +133,11 @@ function extractDomain(filePath: string, brunoDir: string): string {
   const parts = rel.split('/');
   const folderName = parts[0] || 'default';
 
-  // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
-  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  // 대괄호 안의 영문키 추출: 1) 어드민 [Admin] → Admin, 사용자 [users] → users
+  const bracketPattern = /\[([^\]]+)\]/;
   const bracketMatch = folderName.match(bracketPattern);
   if (bracketMatch) {
-    return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
-  }
-
-  // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
-  const oldPattern = /\[([^\]]+)\]/;
-  const oldMatch = folderName.match(oldPattern);
-  if (oldMatch) {
-    return oldMatch[1];
+    return bracketMatch[1].trim(); // 대괄호 안의 영문키
   }
 
   return folderName; // 패턴이 없으면 폴더명 그대로 반환

src/diff/changeDetector.ts

@@ -190,18 +190,11 @@ function extractDomain(operation: any): string {
   if (operation.tags && operation.tags.length > 0) {
     const tag = operation.tags[0];
 
-    // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
-    const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+    // 대괄호 안의 영문키 추출: 1) 어드민 [Admin] → Admin, 사용자 [users] → users
+    const bracketPattern = /\[([^\]]+)\]/;
     const bracketMatch = tag.match(bracketPattern);
     if (bracketMatch) {
-      return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
-    }
-
-    // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
-    const oldPattern = /\[([^\]]+)\]/;
-    const oldMatch = tag.match(oldPattern);
-    if (oldMatch) {
-      return oldMatch[1];
+      return bracketMatch[1].trim(); // 대괄호 안의 영문키
     }
 
     return tag;

src/generator/apiClientGenerator.ts

@@ -30,11 +30,11 @@ export function extractApiFunction(parsed: ParsedBrunoFile, filePath: string): A
   // .bru 파일명에서 함수명 생성
   let fileName = filePath.split('/').pop()?.replace('.bru', '') || '';
 
-  // [한국어 키] 영어 패턴 추출: [멘토 목록 조회] get-mentor-list → get-mentor-list
-  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  // 한글명 [영문키] 패턴 추출: 멘토 목록 조회 [get-mentor-list] → get-mentor-list
+  const bracketPattern = /\[([^\]]+)\]/;
   const bracketMatch = fileName.match(bracketPattern);
   if (bracketMatch) {
-    fileName = bracketMatch[1].trim(); // 대괄호 뒤의 영문 부분만 사용
+    fileName = bracketMatch[1].trim(); // 대괄호 안의 영문키만 사용
   }
 
   const functionName = toCamelCase(fileName);

src/generator/index.ts

@@ -45,26 +45,19 @@ function findBrunoFiles(dir: string): string[] {
 
 /**
  * 파일 경로에서 도메인 추출
- * - "[한글명] 숫자 영문키" 형식: [어드민] 7 Admin → 7 Admin
- * - "한글명 [EnglishKey]" 형식: 사용자 [users] → users
+ * - "숫자) 한글명 [영문키]" 형식: 1) 어드민 [Admin] → Admin
+ * - "한글명 [영문키]" 형식: 사용자 [users] → users
  */
 function extractDomain(filePath: string, brunoDir: string): string {
   const relativePath = relative(brunoDir, filePath);
   const parts = relativePath.split('/');
   const folderName = parts[0]; // 첫 번째 폴더가 도메인
 
-  // [한글명] 숫자 영문키 패턴: [어드민] 7 Admin → 7 Admin
-  const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+  // 대괄호 안의 영문키 추출: 1) 어드민 [Admin] → Admin, 사용자 [users] → users
+  const bracketPattern = /\[([^\]]+)\]/;
   const bracketMatch = folderName.match(bracketPattern);
   if (bracketMatch) {
-    return bracketMatch[1].trim(); // 대괄호 뒤의 모든 내용
-  }
-
-  // 기존 패턴: 한글명 [EnglishKey] → EnglishKey
-  const oldPattern = /\[([^\]]+)\]/;
-  const oldMatch = folderName.match(oldPattern);
-  if (oldMatch) {
-    return oldMatch[1];
+    return bracketMatch[1].trim(); // 대괄호 안의 영문키
   }
 
   return folderName; // 패턴이 없으면 폴더명 그대로 반환

src/generator/queryKeyGenerator.ts

@@ -37,11 +37,11 @@ export function generateQueryKeyStructure(
 
     let fileName = path.split('/').pop()?.replace('.bru', '') || '';
 
-    // [한국어 키] 영어 패턴 추출: [멘토 목록 조회] get-mentor-list → get-mentor-list
-    const bracketPattern = /^\[[^\]]+\]\s+(.+)$/;
+    // 한글명 [영문키] 패턴 추출: 멘토 목록 조회 [get-mentor-list] → get-mentor-list
+    const bracketPattern = /\[([^\]]+)\]/;
     const bracketMatch = fileName.match(bracketPattern);
     if (bracketMatch) {
-      fileName = bracketMatch[1].trim(); // 대괄호 뒤의 영문 부분만 사용
+      fileName = bracketMatch[1].trim(); // 대괄호 안의 영문키만 사용
     }
 
     if (!structure[domain]) {

tests/cli.test.js

@@ -214,26 +214,26 @@ describe('변경사항 감지 테스트', () => {
 });
 
 describe('새로운 폴더명 패턴 테스트', () => {
-  test('[한글명] 숫자 영문키 패턴 추출', () => {
+  test('숫자) 한글명 [영문키] 패턴 추출', () => {
     const inputDir = join(FIXTURES_DIR, 'bruno');
     const outputDir = join(TEST_OUTPUT_DIR, 'apis-pattern');
 
     execSync(`node dist/cli/index.js generate-hooks -i ${inputDir} -o ${outputDir}`, {
       cwd: join(__dirname, '..'),
     });
 
-    // [어드민] 7 Admin 폴더가 생성되었는지 확인
-    const adminDir = join(outputDir, '7 Admin');
-    assert.ok(existsSync(adminDir), '[어드민] 7 Admin 폴더가 생성되어야 함');
+    // 7) 어드민 [Admin] → Admin 폴더가 생성되었는지 확인
+    const adminDir = join(outputDir, 'Admin');
+    assert.ok(existsSync(adminDir), '7) 어드민 [Admin] 폴더에서 Admin이 생성되어야 함');
 
     // 훅 파일 생성 확인
     const hookFile = join(adminDir, 'get-getList.ts');
     assert.ok(existsSync(hookFile), 'getList 훅이 생성되어야 함');
 
-    console.log('✅ [한글명] 숫자 영문키 패턴 테스트 통과');
+    console.log('✅ 숫자) 한글명 [영문키] 패턴 테스트 통과');
   });
 
-  test('[한국어 키] 영어 파일명 패턴 추출', () => {
+  test('한글명 [영문키] 파일명 패턴 추출', () => {
     const inputDir = join(FIXTURES_DIR, 'bruno');
     const outputDir = join(TEST_OUTPUT_DIR, 'apis-filename-pattern');
 
@@ -245,19 +245,19 @@ describe('새로운 폴더명 패턴 테스트', () => {
     const queryKeysFile = join(outputDir, 'queryKeys.ts');
     const queryKeysContent = readFileSync(queryKeysFile, 'utf-8');
 
-    // [목록 조회] get-list.bru → getList로 추출되어야 함
+    // 목록 조회 [get-list].bru → getList로 추출되어야 함
     assert.ok(queryKeysContent.includes('getList'), 'getList 쿼리 키가 생성되어야 함');
-    assert.ok(queryKeysContent.includes("'7 Admin.getList'"), '7 Admin.getList 쿼리 키가 생성되어야 함');
+    assert.ok(queryKeysContent.includes("'Admin.getList'"), 'Admin.getList 쿼리 키가 생성되어야 함');
 
     // 훅 파일 확인
-    const hookFile = join(outputDir, '7 Admin', 'get-getList.ts');
-    assert.ok(existsSync(hookFile), '[목록 조회] get-list.bru에서 getList 훅이 생성되어야 함');
+    const hookFile = join(outputDir, 'Admin', 'get-getList.ts');
+    assert.ok(existsSync(hookFile), '목록 조회 [get-list].bru에서 getList 훅이 생성되어야 함');
 
     const hookContent = readFileSync(hookFile, 'utf-8');
     assert.ok(hookContent.includes('getList'), '훅 내용에 getList가 포함되어야 함');
     assert.ok(hookContent.includes('useGetList'), 'useGetList 훅이 생성되어야 함');
 
-    console.log('✅ [한국어 키] 영어 파일명 패턴 테스트 통과');
+    console.log('✅ 한글명 [영문키] 파일명 패턴 테스트 통과');
   });
 });