typescript-express-starter 10.2.1 → 11.0.0

package/README.kr.md

@@ -1,13 +1,13 @@
 <h1 align="center">
 <br>
-  <img src="https://github.com/ljlm0402/typescript-express-starter/raw/images/logo.jpg" alt="프로젝트 로고" />
+  <img src="https://github.com/ljlm0402/typescript-express-starter/raw/images/newLogo.png" alt="프로젝트 로고" />
   <br>
     <br>
-  타입스크립트 익스프레스 스타터
+  TypeScript Express Starter
   <br>
 </h1>
 
-<h4 align="center">🚀 타입스크립트 기반의 익스프레스 보일러 플레이트 스타터 패키지</h4>
+<h4 align="center">🚀 TypeScript 기반 Express RESTful API 보일러플레이트</h4>
 
 <p align ="center">
   <a href="https://nodei.co/npm/typescript-express-starter" target="_blank">
@@ -20,31 +20,16 @@
       <img src="https://img.shields.io/npm/v/typescript-express-starter.svg" alt="npm 버전" />
     </a>
     <a href="http://npm.im/typescript-express-starter" target="_blank">
-      <img src="https://img.shields.io/github/v/release/ljlm0402/typescript-express-starter" alt="npm 릴리즈 버전" />
+      <img src="https://img.shields.io/github/v/release/ljlm0402/typescript-express-starter" alt="GitHub 릴리즈 버전" />
     </a>
     <a href="http://npm.im/typescript-express-starter" target="_blank">
       <img src="https://img.shields.io/npm/dm/typescript-express-starter.svg" alt="npm 다운로드 수" />
     </a>
     <a href="http://npm.im/typescript-express-starter" target="_blank">
-      <img src="https://img.shields.io/npm/l/typescript-express-starter.svg" alt="npm 패키지 라이선스" />
+      <img src="https://img.shields.io/npm/l/typescript-express-starter.svg" alt="라이선스" />
     </a>
 </p>
 
-<p align="center">
-  <a href="https://github.com/ljlm0402/typescript-express-starter/stargazers" target="_blank">
-    <img src="https://img.shields.io/github/stars/ljlm0402/typescript-express-starter" alt="github 스타"/>
-  </a>
-  <a href="https://github.com/ljlm0402/typescript-express-starter/network/members" target="_blank">
-    <img src="https://img.shields.io/github/forks/ljlm0402/typescript-express-starter" alt="github 포크" />
-  </a>
-  <a href="https://github.com/ljlm0402/typescript-express-starter/stargazers" target="_blank">
-    <img src="https://img.shields.io/github/contributors/ljlm0402/typescript-express-starter" alt="github 컨트리뷰터" />
-  </a>
-  <a href="https://github.com/ljlm0402/typescript-express-starter/issues" target="_blank">
-    <img src="https://img.shields.io/github/issues/ljlm0402/typescript-express-starter" alt="github 이슈" />
-  </a>
-</p>
-
 <br />
 
 - [🇰🇷 한국어](https://github.com/ljlm0402/typescript-express-starter/blob/master/README.kr.md)
@@ -52,272 +37,162 @@
 
 <br />
 
-## 😎 프로젝트를 소개합니다.
-
-Express는 유형 정의에 취약한 JavaScript로 구성 되어있습니다.
-
-이것이 바로 TypeScript를 도입하는 스타터 패키지로 수퍼 세트를 피하는 이유입니다.
-
-패키지는 JavaScript 대신 TypeScript를 사용하도록 구성되어 있습니다.
-
-> 참고 : [express-generator-typescript](https://github.com/seanpmaxwell/express-generator-typescript)
-
-### 🤔 Express는 무엇인가요 ?
-
-Node.js를 위한 빠르고 개방적인 간결한 웹 프레임워크입니다.
-
-## 🚀 시작하기
-
-### npm 전역 설치
-
-```bash
-$ npm install -g typescript-express-starter
-```
-
-### npx를 통해 프로젝트를 설치
-
-프로젝트 이름을 입력하지 않으면, 기본값으로 _typescript-express-starter_ 폴더로 설치됩니다.
-
-```bash
-$ npx typescript-express-starter "project name"
-```
-
-### 원하시는 템플릿을 선택
-
-<img src="https://github.com/ljlm0402/typescript-express-starter/raw/images/cli.gif" alt="예시" />
-
-설치가 완료되면 Script 명령어를 통해 프로젝트를 실행합니다.
-
-#### 템플릿 종류
+## 📝 소개
 
-| 이름                                                                    | 설명                                                                                                                                                                            |
-| :---------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Default                                                                 | Express 기본                                                                                                                                                                    |
-| [routing controllers](https://github.com/typestack/routing-controllers) | 데코레이터 사용량이 많은 구조화되고 선언적이며 아름답게 구성된 클래스 기반 컨트롤러 생성                                                                                        |
-| [Sequelize](https://github.com/sequelize/sequelize)                     | PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server를 지원하는 Promise 패턴 기반의 Node.js ORM                                                                             |
-| [Mongoose](https://github.com/Automattic/mongoose)                      | Node.js와 MongoDB를 위한 ODM(Object Data Mapping) 라이브러리                                                                                                                    |
-| [TypeORM](https://github.com/typeorm/typeorm)                           | 자바스크립트, 타입스크립트과 함께 사용되어 Node.js, React Native, Expo에서 실행될 수 있는 ORM                                                                                   |
-| [Prisma](https://github.com/prisma/prisma)                              | 데이터베이스에 데이터를 프로그래밍 언어의 객체와 매핑하여 기존에 SQL로 작성하던 데이터를 수정, 테이블 구조 변경등의 작업을 객체를 통해 프로그래밍적으로 할 수 있도록 해주는 ORM |
-| [Knex](https://github.com/knex/knex)                                    | 쿼리 빌더를 위한 라이브러리                                                                                                                                                     |
-| [GraphQL](https://github.com/graphql/graphql-js)                        | API 용 쿼리 언어이며 기존 데이터로 이러한 쿼리를 수행하기위한 런타임                                                                                                            |
-| [Typegoose](https://github.com/typegoose/typegoose)                     | 타입스크립트 클래스를 사용하여 몽구스 모델 정의                                                                                                                                 |
-| [Mikro ORM](https://github.com/mikro-orm/mikro-orm)                     | 데이터 매퍼, 작업 단위 및 아이덴티티 맵 패턴을 기반으로 하는 Node.js용 TypeScript ORM. MongoDB, MySQL, MariaDB, PostgreSQL 및 SQLite 데이터베이스를 지원                        |
-| [Node Postgres](https://node-postgres.com/)                             | PostgreSQL 데이터베이스와 인터페이스하기 위한 node.js 모듈                                                                                                                      |
-
-#### 추후 개발 할 템플릿
-
-| 이름                                                                            | 설명                                                                |
-| :------------------------------------------------------------------------------ | :------------------------------------------------------------------ |
-| [Sequelize Typescript](https://github.com/RobinBuschmann/sequelize-typescript)  | 데코레이터 및 Sequelize를 위한 몇 가지 기능                         |
-| [TS SQL](https://github.com/codemix/ts-sql)                                     | SQL 데이터베이스는 TypeScript 유형 주석으로 순전히 구현             |
-| [inversify-express-utils](https://github.com/inversify/inversify-express-utils) | InversifyJS를 사용한 Express 애플리케이션 개발을 위한 일부 유틸리티 |
-| [postgress Typescript]()                                                        |                                                                     |
-| [graphql-prisma]()                                                              |                                                                     |
-
-## 🛎 Script 명령어
-
-- 프로덕션 모드 실행 : `npm run start` 아니면 `Start typescript-express-starter` VS Code 로
-- 개발 모드 실행 : `npm run dev` 아니면 `Dev typescript-express-starter` VS Code 로
-- 단위 테스트 : `npm test` 아니면 `Test typescript-express-starter` VS Code 로
-- 코드 포맷터 검사 : `npm run lint` 아니면 `Lint typescript-express-starter` VS Code 로
-- 코드 포맷터 적용 : `npm run lint:fix` 아니면 `Lint:Fix typescript-express-starter` VS Code 로
-
-## 💎 프로젝트 기능
-
-<p>
-  <img src="https://img.shields.io/badge/-TypeScript-007ACC?style=for-the-badge&logo=TypeScript&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-Node.js-339933?style=for-the-badge&logo=Node.js&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-NPM-CB3837?style=for-the-badge&logo=NPM&logoColor=fff" />&nbsp;&nbsp;
-</p>
-<p>
-  <img src="https://img.shields.io/badge/-Docker-2496ED?style=for-the-badge&logo=Docker&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-NGINX-269539?style=for-the-badge&logo=NGINX&logoColor=fff" />
-  <img src="https://img.shields.io/badge/-PM2-2B037A?style=for-the-badge&logo=PM2&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-Nodemon-76D04B?style=for-the-badge&logo=Nodemon&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-ESLint-4B32C3?style=for-the-badge&logo=ESLint&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-Prettier-F7B93E?style=for-the-badge&logo=Prettier&logoColor=000" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-Jest-C21325?style=for-the-badge&logo=Jest&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-Swagger-85EA2D?style=for-the-badge&logo=Swagger&logoColor=000" />
-  <img src="https://img.shields.io/badge/-SWC-FFFFFF?style=for-the-badge&logo=swc&logoColor=FBE1A6" />
-</p>
-<p>
-  <img src="https://img.shields.io/badge/-MySQL-4479A1?style=for-the-badge&logo=MySQL&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-MariaDB-003545?style=for-the-badge&logo=MariaDB&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-PostgreSQL-336791?style=for-the-badge&logo=PostgreSQL&logoColor=fff" />&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/-MongoDB-47A248?style=for-the-badge&logo=MongoDB&logoColor=fff" />
-</p>
+**TypeScript Express Starter**는 원하는 스택 구성으로 프로덕션 준비된 TypeScript Express 프로젝트를 생성하는 대화형 CLI 도구입니다.
 
-### 🐳 Docker :: 컨테이너 플랫폼
+처음부터 시작하는 대신, 이 CLI는 다양한 데이터베이스 연동, 개발 도구, 배포 구성을 포함한 포괄적인 프로젝트 생성기를 제공합니다. 10개 이상의 템플릿 중 선택하고 몇 분 안에 개발 워크플로우를 맞춤 설정할 수 있습니다.
 
-[Docker](https://docs.docker.com/)란, 컨테이너 기반의 오픈소스 가상화 플랫폼이다.
+- **대화형 설정**: 데이터베이스, ORM, 린터, 테스트 프레임워크 등을 선택
+- **프로덕션 준비**: Docker, PM2, NGINX 구성 포함
+- **개발자 경험**: 핫 리로드, 테스트, 린팅, 포맷팅이 미리 구성됨
+- **다양한 스택**: 10개 이상의 데이터베이스/ORM 조합 지원
 
-[설치 홈페이지](https://docs.docker.com/get-docker/)에 접속해서 설치를 해줍니다.
+## 💎 CLI 주요 기능
 
-- 백그라운드에서 컨테이너를 시작하고 실행 : `docker-compose up -d`
-- 컨테이너를 중지하고 컨테이너, 네트워크, 볼륨 및 이미지를 제거 : `docker-compose down`
+- 🎯 **대화형 설정** — 스마트 CLI로 프로젝트 구성을 안내
 
-수정을 원하시면 `docker-compose.yml`과 `Dockerfile`를 수정해주시면 됩니다.
+- 🗄️ **다양한 데이터베이스 옵션** — Prisma, Sequelize, TypeORM, Mongoose, Knex 등
 
-### ♻️ Nginx :: 웹 서버
+- 🛠️ **개발 도구** — ESLint, Biome, Jest, Vitest, Docker, PM2 중 선택
 
-[Nginx](https://www.nginx.com/) 역방향 프록시,로드 밸런서, 메일 프록시 및 HTTP 캐시로도 사용할 수있는 웹 서버입니다.
+- 📱 **템플릿 선택** — 10개 이상의 사전 구성된 프로젝트 템플릿
 
-프록시는 일반적으로 여러 서버에로드를 분산하거나, 다른 웹 사이트의 콘텐츠를 원활하게 표시하거나, HTTP 이외의 프로토콜을 통해 처리 요청을 애플리케이션 서버에 전달하는 데 사용됩니다.
+- ⚡ **자동 구성** — 의존성, 스크립트, 설정이 자동으로 설정됨
 
-Nginx 요청을 프록시하면 지정된 프록시 서버로 요청을 보내고 응답을 가져 와서 클라이언트로 다시 보냅니다.
+- 🔧 **스마트 의존성** — 도구 호환성 및 요구사항 자동 해결
 
-수정을 원하시면 `nginx.conf` 파일을 수정해주시면 됩니다.
+- 📦 **패키지 매니저 지원** — npm, pnpm, yarn 모두 지원
 
-### ✨ ESLint, Prettier :: 정적 코드 분석 및 코드 스타일 변환
+- 🚀 **제로 설정 시작** — 생성된 프로젝트가 즉시 동작
 
-[ESLint](https://eslint.org/)는 JavaScript 코드에서 발견 된 문제 패턴을 식별하기위한 정적 코드 분석 도구입니다.
+- 🎨 **커스터마이징 가능** — 자신만의 템플릿과 개발 도구 추가
 
-[Prettier](https://prettier.io/)는 개발자가 작성한 코드를 정해진 코딩 스타일을 따르도록 변환해주는 도구입니다.
+## ⚡️ 빠른 시작
 
-코드를 구문 분석하고 최대 줄 길이를 고려하여 필요한 경우 코드를 래핑하는 자체 규칙으로 다시 인쇄하여 일관된 스타일을 적용합니다.
-
-1. [VSCode](https://code.visualstudio.com/) Extension에서 [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode), [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) 설치합니다.
-
-2. 설치가 완료되면, 단축키 `CMD` + `Shift` + `P` (Mac Os) 또는 `Ctrl` + `Shift` + `P` (Windows) 입력합니다.
-
-3. Format Selection With 선택합니다.
-
-4. Configure Default Formatter... 선택합니다.
-
-5. Prettier - Code formatter 적용합니다.
-
-<img src="https://user-images.githubusercontent.com/42952358/126604937-4ef50b61-b7e4-4635-b3c9-3c94dd6b06fa.png" alt="Formatter 설정" />
-
-> 2019년, TSLint 지원이 종료 되어 ESLint를 적용하였습니다.
-
-### 📗 Swagger :: API 문서화
-
-[Swagger](https://swagger.io/)는 개발자가 REST 웹 서비스를 설계, 빌드, 문서화, 소비하는 일을 도와주는 대형 도구 생태계의 지원을 받는 오픈 소스 소프트웨어 프레임워크이다.
-
-API를 대규모로 설계하고 문서화하는 데 용이하게 사용합니다.
-
-Swagger URL은 `http://localhost:3000/api-docs` 으로 작성했습니다.
-
-수정을 원하시면 `swagger.yaml` 파일을 수정해주시면 됩니다.
-
-### 🌐 REST Client :: HTTP Client 도구
-
-REST 클라이언트를 사용하면 HTTP 요청을 보내고 Visual Studio Code에서 직접 응답을 볼 수 있습니다.
-
-VSCode Extension에서 [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) 설치합니다.
-
-수정을 원하시면 src/http 폴더 안에 `*.http` 파일을 수정해주시면 됩니다.
-
-### 🔮 PM2 :: 웹 애플리케이션을 운영 및 프로세스 관리자
-
-[PM2](https://pm2.keymetrics.io/)란, 서버에서 웹 애플리케이션을 운영할 때 보통 데몬으로 서버를 띄워야 하고 Node.js의 경우 서버가 크래시나면 재시작을 하기 위해서 워치독(watchdog) 류의 프로세스 관리자이다.
-
-- 프로덕션 모드 :: `npm run deploy:prod` 또는 `pm2 start ecosystem.config.js --only prod`
-- 개발 모드 :: `npm run deploy:dev` 또는 `pm2 start ecosystem.config.js --only dev`
-
-수정을 원하시면 `ecosystem.config.js` 파일을 수정해주시면 됩니다.
-
-### 🏎 SWC :: 강하고 빠른 자바스크립트 / 타입스크립트 컴파일러
-
-[SWC](https://swc.rs/)는 차세대 고속 개발자 도구를 위한 확장 가능한 Rust 기반 플랫폼입니다.
-
-`SWC는 단일 스레드에서 Babel보다 20배, 4개 코어에서 70배 빠릅니다.`
+```bash
+# 전역 설치
+npm install -g typescript-express-starter
 
-- tsc 빌드 :: `npm run build`
-- swc 빌드 :: `npm run build:swc`
+# 대화형 CLI 실행
+typescript-express-starter
 
-수정을 원하시면 `.swcrc` 파일을 수정해주시면 됩니다.
+# 프롬프트에 따라 다음을 선택:
+# 1. 패키지 매니저 선택 (npm/pnpm/yarn)
+# 2. 프로젝트 템플릿 선택 (default/prisma/sequelize/등)
+# 3. 프로젝트 이름 입력
+# 4. 개발 도구 선택 (린팅/테스트/도커/등)
 
-### 💄 Makefile :: Linux에서 반복 적으로 발생하는 컴파일을 쉽게하기위해서 사용하는 make 프로그램의 설정 파일
+# 프로젝트로 이동
+cd your-project-name
 
-- 도움말 :: `make help`
+# 개발 서버 시작
+npm run dev
+```
 
-수정을 원하시면 `Makefile` 파일을 수정해주시면 됩니다.
+**생성된 프로젝트 기능:**
+- 🌐 Express 서버: `http://localhost:3000/`
+- 📚 자동 생성된 API 문서: `http://localhost:3000/api-docs`
+- 🔄 nodemon을 통한 핫 리로드
+- 🧪 테스트 설정 포함
 
-## 🗂 코드 구조 (default)
+## 📂 프로젝트 구조
 
 ```bash
-│
-├──📂 .vscode
-│  ├── launch.json
-│  └── settings.json
-│
-├──📂 src
-│  ├──📂 config
-│  │  └── index.ts
-│  │
-│  ├──📂 controllers
-│  │  ├── auth.controller.ts
-│  │  └── users.controller.ts
-│  │
-│  ├──📂 dtos
-│  │  └── users.dto.ts
-│  │
-│  ├──📂 exceptions
-│  │  └── httpException.ts
-│  │
-│  ├──📂 http
-│  │  ├── auth.http
-│  │  └── users.http
-│  │
-│  ├──📂 interfaces
-│  │  ├── auth.interface.ts
-│  │  ├── routes.interface.ts
-│  │  └── users.interface.ts
-│  │
-│  ├──📂 middlewares
-│  │  ├── auth.middleware.ts
-│  │  ├── error.middleware.ts
-│  │  └── validation.middleware.ts
-│  │
-│  ├──📂 models
-│  │  └── users.model.ts
-│  │
-│  ├──📂 routes
-│  │  ├── auth.route.ts
-│  │  └── users.route.ts
-│  │
-│  ├──📂 services
-│  │  ├── auth.service.ts
-│  │  └── users.service.ts
-│  │
-│  ├──📂 test
-│  │  ├── auth.test.ts
-│  │  └── users.test.ts
-│  │
-│  ├──📂 utils
-│  │  ├── logger.ts
-│  │  └── vaildateEnv.ts
-│  │
-│  ├── app.ts
-│  └── server.ts
-│
-├── .dockerignore
-├── .editorconfig
-├── .env.development.local
-├── .env.production.local
-├── .env.test.local
-├── .eslintignore
-├── .eslintrc
-├── .gitignore
-├── .huskyrc
-├── .lintstagedrc.json
-├── .prettierrc
-├── .swcrc
-├── docker-compose.yml
-├── Dockerfile.dev
-├── Dockerfile.prod
-├── ecosystem.config.js
-├── jest.config.js
-├── Makefile
-├── nginx.conf
-├── nodemon.json
-├── package-lock.json
-├── package.json
-├── swagger.yaml
-└── tsconfig.json
+src/
+ ├── config/           # 환경 변수, 설정 파일
+ ├── controllers/      # 요청 처리 및 응답 반환
+ ├── dtos/             # 요청/응답 데이터 구조 정의
+ ├── exceptions/       # 커스텀 예외 클래스
+ ├── interfaces/       # 타입/인터페이스 정의
+ ├── middlewares/      # 미들웨어 (로그, 인증, 에러 처리 등)
+ ├── repositories/     # 데이터베이스 접근 로직
+ ├── routes/           # 라우팅 정의
+ ├── services/         # 비즈니스 로직
+ ├── utils/            # 유틸리티 함수
+ ├── app.ts            # Express 앱 초기화
+ └── server.ts         # 서버 실행 엔트리 포인트
+
+.env                   # 기본 환경 변수
+.env.development.local # 개발 환경 변수
+.env.production.local  # 운영 환경 변수
+.env.test.local        # 테스트 환경 변수
+nodemon.json           # Nodemon 환경 변수
+swagger.yaml           # Swagger API 문서 정의
+tsconfig.jsnon         # TypeScript 환경 변수
 ```
 
+## 🛠 사용 가능한 개발 도구
+
+프로젝트 설정 중 다음 카테고리에서 선택할 수 있습니다:
+
+| 카테고리   | 사용 가능한 도구        | 설명                                    |
+| ---------- | ------------------------ | ------------------------------------------- |
+| **린터**   | `biome`, `eslint`        | 코드 포맷팅 및 린팅 (Biome은 올인원) |
+| **번들러** | `swc`, `tsup`           | 빠른 TypeScript 컴파일 및 번들링     |
+| **테스트** | `jest`, `vitest`        | 단위 및 통합 테스트 프레임워크        |
+| **프로세스** | `pm2`                   | 프로덕션 프로세스 관리               |
+| **CI/CD**  | `github`                | GitHub Actions 워크플로우               |
+| **Git 훅** | `husky`                 | 품질 관리를 위한 Pre-commit 훅       |
+| **컨테이너** | `docker`                | Docker 및 docker-compose 구성          |
+| **API 문서** | `swagger`               | OpenAPI/Swagger 문서                   |
+
+**스마트 선택**: CLI가 도구 의존성과 호환성을 자동으로 해결합니다.
+
+## 🧩 사용 가능한 템플릿
+
+현재 템플릿 상태 (더 많은 템플릿 추가 예정!):
+
+### ✅ **현재 사용 가능**
+| 템플릿   | 설명                        | 상태 |
+| ---------- | ------------------------------ | ------ |
+| `default`  | Express + TypeScript 스타터   | ✅ 활성 |
+
+### 🚧 **개발 예정**
+
+#### **ORM/데이터베이스 연동**
+| 템플릿           | 설명                    | 우선순위 |
+| ------------------ | ------------------------------ | -------- |
+| `prisma`           | 타입 안전 데이터베이스 클라이언트, 자동 타입 생성         | 🔥 높음  |
+| `drizzle`          | 런타임 오버헤드 없는 TypeScript 우선 ORM              | 🔥 높음  |
+| `mikro-orm`        | TypeScript용 Data Mapper ORM 패턴           | 🔥 높음  |
+| `mongoose`         | Node.js용 우아한 MongoDB ODM         | 🔥 높음  |
+| `node-postgres`    | 고성능 PostgreSQL 원시 드라이버 (pg)      | 🚧 개발 중 |
+| `knex`             | 유연한 SQL 쿼리 빌더 및 마이그레이션      | 🚧 개발 중 |
+| `typeorm`          | 데코레이터 기반 Active Record ORM            | 🚧 개발 중 |
+| `sequelize`        | 성숙한 Promise 기반 SQL ORM                  | 🚧 개발 중 |
+| `typegoose`        | TypeScript 친화적 Mongoose 대안            | 🚧 개발 중 |
+
+#### **아키텍처/컨트롤러 스타일**
+| 템플릿           | 설명                    | 우선순위 |
+| ------------------ | ------------------------------ | -------- |
+| `graphql`          | Apollo Server 기반 GraphQL API 스키마        | 🚧 개발 중 |
+
+> **참고**: 현재 `default` 템플릿에 집중하고 있습니다. 추가 템플릿은 완성 및 테스트가 끝나면 활성화될 예정입니다.
+
+## 🤔 이 CLI를 사용하는 이유?
+
+### vs. 수동 설정
+| 측면           | 수동 설정                      | TypeScript Express Starter CLI        |
+| ---------------- | --------------------------------- | ------------------------------------- |
+| **시간**         | 🔴 수 시간의 구성 작업          | ✅ 2-3분 대화형 설정      |
+| **구성** | 🔴 수동 의존성 관리    | ✅ 자동 해결, 호환 버전  |
+| **모범 사례** | 🔴 연구 필요            | ✅ 사전 구성된 업계 표준  |
+| **일관성**  | 🔴 개발자마다 다름           | ✅ 표준화된 프로젝트 구조     |
+| **업데이트**      | 🔴 수동 유지보수             | ✅ CLI 업데이트로 새 기능 제공     |
+
+### vs. 다른 생성기
+| 기능          | TypeScript Express Starter | 다른 생성기 |
+| ---------------- | -------------------------- | ---------------- |
+| **데이터베이스 선택** | ✅ 10개 이상 옵션 계획       | 제한된 옵션  |
+| **도구 선택**  | ✅ 믹스 앤 매치 개발 도구    | 고정된 스택      |
+| **TypeScript 우선** | ✅ TypeScript를 위해 제작    | 주로 JS 우선   |
+| **프로덕션 준비** | ✅ Docker, PM2 포함    | 기본 설정      |
+
+## 📄 라이선스
+
+MIT(LICENSE) © AGUMON (ljlm0402)
+
 ## ⭐️ 응원해주신 분들
 
 [![Stargazers repo roster for @ljlm0402/typescript-express-starter](https://reporoster.com/stars/ljlm0402/typescript-express-starter)](https://github.com/ljlm0402/typescript-express-starter/stargazers)
@@ -329,29 +204,3 @@ VSCode Extension에서 [REST Client](https://marketplace.visualstudio.com/items?
 ## 🤝 도움주신 분들
 
 [![Contributors repo roster for @ljlm0402/typescript-express-starter](https://contributors-img.web.app/image?repo=ljlm0402/typescript-express-starter)](https://github.com/ljlm0402/typescript-express-starter/graphs/contributors)
-
-## 💳 라이선스
-
-[MIT](LICENSE)
-
-## 📑 커밋 메시지 정의
-
-| 언제               | 메시지                |
-| :----------------- | :-------------------- |
-| 기능 추가          | ✨ 기능 추가          |
-| 버그 수정          | 🐞 버그 수정          |
-| 코드 개선          | 🛠 코드 개선           |
-| 패키지 설치        | 📦 패키지 설치        |
-| 문서 수정          | 📚 문서 수정          |
-| 버전 업데이트      | 🌼 버전 업데이트      |
-| 새로운 템플릿 추가 | 🎉 새로운 템플릿 추가 |
-
-## 📬 이슈를 남겨주세요
-
-건의 사항이나 질문 등을 이슈로 남겨주세요.
-
-최선을 다해 답변하고 반영하겠습니다.
-
-관심을 가져주셔서 감사합니다.
-
-# ദ്ദി*ˊᗜˋ*)