create-express-esm 1.2.4 → 1.2.5

package/README.md

@@ -1,10 +1,10 @@
 # 🚀 Create Express ESM (CLI)
 
-> **Modern Express Generator with Database & Error Handling**
+> **Modern Express Generator with Multi-Database & Zero-Config**
 >
-> "1초 만에 완성하는 Modern Express(ESM) + Prisma + Docker 환경"
+> "1초 만에 완성하는 Modern Express(ESM) + Prisma + Multi-DB Docker 환경"
 >
-> CommonJS(require)가 아닌, 최신 ES Modules(import/export) 문법을 기반으로 하며, 데이터베이스 연동 및 전문적인 에러 핸들링까지 포함된 Express 프로젝트 구조를 자동으로 생성해주는 CLI 도구입니다.
+> 최신 ES Modules(import/export)를 기반으로, 사용자가 선택한 데이터베이스(PostgreSQL, MySQL, MariaDB, MongoDB) 환경을 즉시 구축해주는 지능형 CLI 도구입니다.
 
 [![npm version](https://img.shields.io/npm/v/create-express-esm.svg)](https://www.npmjs.com/package/create-express-esm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -15,19 +15,19 @@
 
 ## ✨ Key Features (핵심 기능)
 
-기존 `express-generator`의 한계를 분석하고 개선하여 개발했습니다. v1.2.0 업데이트를 통해 실무형 풀스택 베이스를 제공합니다.
+v1.2.4 업데이트를 통해 더욱 강력해진 실무형 풀스택 베이스를 제공합니다.
 
-- **🌐 Multi-Language Support**: JavaScript(ESM)와 **TypeScript** 중 원하는 개발 환경을 선택할 수 있습니다.
-- **🗄️ Database Integration**: **Prisma ORM**과 **PostgreSQL** 환경을 즉시 구축합니다. (Docker Compose 자동 생성)
-- **🚨 Professional Error Handling**: `AppError` 클래스와 **Global Error Middleware**를 통한 중앙 집중식 에러 처리 시스템을 제공합니다.
-- **🧪 Integrated Testing**: 최신 테스트 프레임워크인 **Vitest**와 API 테스트용 **Supertest** 환경을 자동 설정합니다.
+- **🗄️ Multi-Database Support**: **PostgreSQL, MySQL, MariaDB, MongoDB** 중 프로젝트에 필요한 DB를 선택할 수 있습니다.
+- **🐳 Smart Docker Orchestration**: 각 DB 엔진에 최적화된 Docker Compose 설정을 자동 생성합니다. (포트 충돌 방지 설계 적용)
 - **🏗 Layered Architecture**: 실무 표준인 `Controller` - `Service` - `Route` - `Middleware` 계층 구조를 제공합니다.
-- **⚡️ Modern Execution**: `ts-node`의 ESM 호환성 문제를 해결한 **`tsx`**를 채택하여 쾌적한 개발 환경을 제공합니다.
-- **📦 Smart Auto-Installation**: 프로젝트 생성 즉시 의존성 설치 및 환경 변수(`.env`) 세팅을 완료합니다.
+- **🚨 Professional Error Handling**: `AppError` 클래스와 **Global Error Middleware**를 통한 중앙 집중식 에러 관리 시스템을 내장하고 있습니다.
+- **🧪 Integrated Testing**: 최신 테스트 프레임워크인 **Vitest**와 API 테스트용 **Supertest** 환경을 자동 설정합니다.
+- **⚡ Modern Execution**: `ts-node`보다 빠르고 ESM 호환성이 뛰어난 **`tsx`**를 채택했습니다.
+- **📦 Zero-Config Setup**: 프로젝트 생성 즉시 의존성 설치, `.env` 환경 변수 세팅 및 Prisma 스키마 최적화를 완료합니다.
 
 ## 🚀 Quick Start (사용법)
 
-별도의 설치 없이 `npx` 명령어로 즉시 실행할 수 있습니다.
+별도의 설치 없이 `npx` 명령어로 즉시 실행하여 인터렉티브하게 프로젝트를 생성하세요.
 
 ```bash
 npx create-express-esm
@@ -35,37 +35,38 @@ npx create-express-esm
 
 ### 프로젝트 생성 후 DB 시작하기
 
-DB 옵션을 선택했다면, 단 몇 줄의 명령어로 개발 준비가 끝납니다.
-
-```bash
+```
 # 1. 프로젝트 폴더 이동
 cd my-app
 
-# 2. Docker를 통한 PostgreSQL 실행
+# 2. Docker를 통한 데이터베이스 실행
 npm run db:up
 
-# 3. Prisma 스키마를 DB에 반영 (테이블 생성)
+# 3. Prisma 스키마 반영 (테이블/컬렉션 생성)
 npm run db:push
 
-# 4. 서버 실행
+# 4. 개발 서버 실행
 npm run dev
 ```
 
-또는 전역으로 설치하여 사용할 수도 있습니다.
+## 🗄️ Database Options
 
-```bash
-npm install -g create-express-esm
-create-express-esm
-```
+v1.2.4에서는 각 환경별 최적화된 기본 포트를 제공하여 윈도우 시스템(Hyper-V)과의 포트 충돌을 최소화하고, 선택한 DB에 맞는 전용 환경을 구축합니다.
+
+| Database       | Docker Image         | Default Port | Prisma Provider |
+| :------------- | :------------------- | :----------- | :-------------- |
+| **PostgreSQL** | `postgres:15-alpine` | `5433`       | `postgresql`    |
+| **MySQL**      | `mysql:8.0`          | `4306`       | `mysql`         |
+| **MariaDB**    | `mariadb:10.11`      | `5306`       | `mysql`         |
+| **MongoDB**    | `mongo:6.0`          | `27017`      | `mongodb`       |
 
 ## 📂 Project Structure (폴더 구조)
 
-이 도구는 **Layered Architecture (계층형 아키텍처)**를 기반으로 프로젝트를 생성합니다.
-관심사 분리(Separation of Concerns) 원칙을 적용하여 유지보수가 쉬운 구조를 제공합니다.
+이 도구는 **Layered Architecture (계층형 아키텍처)**를 기반으로 프로젝트를 생성하여 높은 유지보수성을 보장합니다.
 
 ```text
 my-app/
-├── prisma/             # 🗄️ Prisma Schema & Migrations
+├── prisma/             # 🗄️ Prisma Schema (선택한 DB 전용 템플릿)
 ├── src/
 │   ├── controllers/    # 🕹️ 요청 처리 및 응답 반환 (Controller Layer)
 │   ├── services/       # 🧠 비즈니스 로직 처리 (Service Layer)
@@ -74,46 +75,26 @@ my-app/
 │   ├── utils/          # 🛠️ AppError 클래스 등 공통 유틸리티
 │   ├── lib/            # 🖇️ Prisma Client 인스턴스 (Singleton)
 │   ├── app.ts          # 🏗️ Express 앱 설정 및 미들웨어
-│   ├── server.ts       # 🚀 서버 진입점 (Entry Point)
-│   └── app.test.ts     # 🧪 Vitest 샘플 테스트 코드
+│   └── server.ts       # 🚀 서버 진입점 (Entry Point)
 ├── .env                # 🔐 환경 변수 (DATABASE_URL 자동 생성)
-├── docker-compose.yml  # 🐳 PostgreSQL 컨테이너 설정
+├── docker-compose.yml  # 🐳 DB 컨테이너 설정 (Port conflict 방지 설계)
 ├── vitest.config.ts    # 🧪 Vitest 설정 파일
-├── tsconfig.json       # ⚙️ TS 컴파일러 설정 (TS 선택 시)
 └── package.json        # 📦 의존성 및 스크립트
 ```
 
-## 🛠 Tech Stack (기술 스택)
-
-- **Runtime**: Node.js (v20+)
-- **Framework**: Express.js
-- **Language**: JavaScript (ESM) / TypeScript 5.x
-- **ORM**: Prisma (PostgreSQL)
-- **Infrastructure**: Docker Compose
-- **Testing**: Vitest, Supertest
-- **Dev Tools**:
-  - `tsx` (TypeScript Execution Engine)
-  - `nodemon` (Hot Reload)
-  - `@clack/prompts` (Interactive CLI UI)
-  - `dotenv` (Environment Variables)
-  - `cors` (Cross-Origin Resource Sharing)
-  - `chalk` (CLI Styling)
-
-## 📝 Retrospective
-
-- **표준화된 환경의 중요성**: CJS에서 ESM으로 넘어가는 과도기적 문제를 해결하며 모던 자바스크립트 모듈 시스템에 대한 깊은 이해를 얻었습니다.
-- **에러 핸들링의 중앙화**: 개별 컨트롤러에서 반복되던 에러 처리 로직을 전역 미들웨어로 위임하여 코드 가독성과 유지보수성을 극대화했습니다.
-- **인프라 환경 이슈 해결**: 로컬 PostgreSQL과의 포트 충돌(5432 vs 5433) 및 도커 볼륨 인증 문제를 해결하며, 사용자에게 가장 안정적인 DB 연결 가이드를 제공하는 데 성공했습니다.
-- **UX 기반 설계**: 사용자가 프로젝트를 생성하자마자 `npm run dev`와 `npm test`를 즉시 실행할 수 있는 "Zero-Config" 환경을 제공하는 데 집중했습니다.
-
 ## 🗺️ Roadmap (Future Plans)
 
-- [x] **TypeScript Support**: `.ts` 템플릿 및 `tsx` 환경 최적화
-- [x] **Test Environment**: Vitest 및 Supertest 설정 자동화
-- [x] **Interactive UI Upgrade**: `Clack` 라이브러리를 통한 시각적 CLI UI 개선
-- [x] **Database Integration**: Prisma/PostgreSQL 및 Docker 선택 옵션 추가
-- [ ] **Authentication Template**: JWT/Passport를 이용한 기본 인증 로직 추가
-- [ ] **Deployment Guide**: AWS/Render 등 주요 플랫폼 배포 가이드라인 추가
+- [x] TypeScript & tsx: 최신 TS 환경 완벽 지원
+
+- [x] Testing Setup: Vitest/Supertest 자동화
+
+- [x] Multi-DB Support: 4종 DB(Postgres, MySQL, MariaDB, Mongo) 지원
+
+- [ ] Authentication Template: JWT/Passport 기반 인증 로직 추가
+
+- [ ] Validation Layer: Zod를 이용한 요청 값 검증 미들웨어 추가
+
+- [ ] API Documentation: Swagger(OpenAPI) 자동 생성 지원
 
 ## 📝 License
 

package/bin/cli.js

@@ -14,8 +14,8 @@ const __dirname = path.dirname(__filename);
 async function run() {
   console.clear();
   
-  // 1. 시작 인사 (v1.2.2 버전 반영)
-  p.intro(`${chalk.bgBlue.white(' create-express-esm ')} ${chalk.dim('v1.2.2')}`);
+  // 1. 시작 인사 (v1.2.4 버전 반영)
+  p.intro(`${chalk.bgBlue.white(' create-express-esm ')} ${chalk.dim('v1.2.4')}`);
 
   try {
     // 2. 사용자 질문 그룹
@@ -45,10 +45,9 @@ async function run() {
           }),
         useDb: () =>
           p.confirm({
-            message: 'Prisma ORM 및 전역 에러 핸들링을 추가하시겠습니까?',
+            message: 'Prisma ORM 및 데이터베이스 환경을 추가하시겠습니까?',
             initialValue: false,
           }),
-        // [New] DB 타입 선택 (useDb가 true일 때만 실행)
         dbType: ({ results }) => {
           if (!results.useDb) return;
           return p.select({
@@ -56,6 +55,8 @@ async function run() {
             options: [
               { value: 'postgresql', label: 'PostgreSQL' },
               { value: 'mysql', label: 'MySQL' },
+              { value: 'mariadb', label: 'MariaDB' },
+              { value: 'mongodb', label: 'MongoDB (NoSQL)' },
             ],
           });
         },
@@ -75,91 +76,82 @@ async function run() {
 
     // 3. 파일 구성 시작
     const s = p.spinner();
-    s.start('프로젝트 템플릿을 복사하는 중...');
+    s.start('프로젝트 템플릿을 생성하는 중...');
 
-    // 기본 언어 템플릿 복사
+    // (1) 기본 언어 템플릿 복사 (js 또는 ts)
     await fs.copy(templatePath, targetPath);
 
-    // 도트 파일 변환 (_env -> .env 등)
-    const renameMap = {
-      'gitignore': '.gitignore',
-      '_gitignore': '.gitignore',
-      '_env': '.env'
-    };
-
-    for (const [oldName, newName] of Object.entries(renameMap)) {
-      const oldFilePath = path.join(targetPath, oldName);
-      if (await fs.pathExists(oldFilePath)) {
-        await fs.move(oldFilePath, path.join(targetPath, newName), { overwrite: true });
+    // (2) 도트 파일 변환 (_env -> .env 등)
+    const dotFiles = ['gitignore', '_gitignore', '_env'];
+    for (const f of dotFiles) {
+      const oldPath = path.join(targetPath, f);
+      if (await fs.pathExists(oldPath)) {
+        const newName = f.startsWith('_') ? f.replace('_', '.') : `.${f}`;
+        await fs.move(oldPath, path.join(targetPath, newName), { overwrite: true });
+        // .env 파일 생성 시 .env.example도 같이 생성
         if (newName === '.env') {
           await fs.copy(path.join(targetPath, '.env'), path.join(targetPath, '.env.example'));
         }
       }
     }
 
-    // 4. DB 및 에러 핸들링 선택 시 추가 파일 복사 및 코드 주입
+    // 4. DB 선택 시 기능 병합 (Common 소스 복사)
     if (useDb) {
-      // (1) Prisma 설정 및 Docker Compose 복사 (선택한 DB 타입에 맞춤)
+      // (1) Prisma & Docker 설정 복사
       await fs.ensureDir(path.join(targetPath, 'prisma'));
-      
-      const prismaTemplate = `schema.prisma.${dbType}`;
-      const dockerTemplate = `docker-compose.yml.${dbType}`;
-
       await fs.copy(
-        path.join(commonPath, 'prisma', prismaTemplate), 
+        path.join(commonPath, 'prisma', `schema.prisma.${dbType}`),
         path.join(targetPath, 'prisma', 'schema.prisma')
       );
-      
       await fs.copy(
-        path.join(commonPath, dockerTemplate), 
+        path.join(commonPath, `docker-compose.yml.${dbType}`),
         path.join(targetPath, 'docker-compose.yml')
       );
 
-      // (2) 소스 코드 복사 (기존 로직 유지)
-      const sourceFolders = ['lib', 'services', 'controllers', 'routes', 'utils', 'middlewares'];
-      for (const folder of sourceFolders) {
-        const srcFolderPath = path.join(commonPath, 'src', folder);
-        const destFolderPath = path.join(targetPath, 'src', folder);
-        
-        if (await fs.pathExists(srcFolderPath)) {
-          await fs.ensureDir(destFolderPath);
-          const files = await fs.readdir(srcFolderPath);
-          for (const file of files) {
-            if (file.endsWith(`.${language}`)) {
-              await fs.copy(path.join(srcFolderPath, file), path.join(destFolderPath, file));
-            }
-          }
-        }
+      // (2) ⭐ [핵심 수정] 언어별 Common 소스 코드 병합
+      // template/common/src/js (또는 ts) 폴더 내부를 target/src로 병합 복사
+      const commonSrcPath = path.join(commonPath, 'src', language);
+      if (await fs.pathExists(commonSrcPath)) {
+        await fs.copy(commonSrcPath, path.join(targetPath, 'src'), { 
+          overwrite: true,
+          errorOnExist: false 
+        });
       }
 
       // (3) app.ts / app.js 에 코드 주입
       const mainFilePath = path.join(targetPath, `src/app.${language}`);
       if (await fs.pathExists(mainFilePath)) {
         let content = await fs.readFile(mainFilePath, 'utf-8');
-        const imports = [
-          `import userRoutes from './routes/userRoutes.js';`,
-          `import { errorHandler } from './middlewares/errorMiddleware.js';`
-        ].join('\n');
-        content = imports + '\n' + content;
-        content = content.replace('app.use(express.json());', `app.use(express.json());\napp.use('/users', userRoutes);`);
-        const errorMiddlewareCode = `\n// 전역 에러 핸들러\napp.use(errorHandler);\n`;
-        content = content.includes('export default app;') 
-          ? content.replace('export default app;', `${errorMiddlewareCode}\nexport default app;`)
-          : content + `\n${errorMiddlewareCode}`;
-        await fs.writeFile(mainFilePath, content);
+        
+        // 중복 주입 방지 체크
+        if (!content.includes('userRoutes')) {
+          const imports = [
+            `import userRoutes from './routes/userRoutes.js';`,
+            `import { errorHandler } from './middlewares/errorMiddleware.js';`
+          ].join('\n');
+          
+          content = imports + '\n' + content;
+          // express.json() 다음에 라우터 연결
+          content = content.replace(/app\.use\(express\.json\(\)\);?/g, (match) => {
+            return `${match}\napp.use('/api/users', userRoutes);`;
+          });
+          // export default 앞에 에러 핸들러 연결
+          const errorMiddlewareCode = `\n// 전역 에러 핸들러\napp.use(errorHandler);\n`;
+          content = content.replace(/export default app;?/g, `${errorMiddlewareCode}\nexport default app;`);
+          
+          await fs.writeFile(mainFilePath, content);
+        }
       }
 
       // (4) .env 파일에 DB 타입별 DATABASE_URL 추가
       const envPath = path.join(targetPath, '.env');
-      let dbUrlContent = '';
-      
-      if (dbType === 'postgresql') {
-        dbUrlContent = `\n# PostgreSQL Connection\nDATABASE_URL="postgresql://myuser:mypassword@localhost:5433/mydb?schema=public"\n`;
-      } else if (dbType === 'mysql') {
-        dbUrlContent = `\n# MySQL Connection\nDATABASE_URL="mysql://root:mypassword@localhost:3307/mydb"\n`;
-      }
-      
-      await fs.appendFile(envPath, dbUrlContent);
+      const dbUrls = {
+        postgresql: 'postgresql://myuser:mypassword@localhost:5433/mydb?schema=public',
+        mysql: 'mysql://root:mypassword@localhost:4306/mydb',
+        mariadb: 'mysql://root:mypassword@localhost:5306/mydb',
+        mongodb: 'mongodb://root:mypassword@localhost:27017/mydb?authSource=admin'
+      };
+      await fs.appendFile(envPath, `\n# Database Connection\nDATABASE_URL="${dbUrls[dbType]}"\n`);
     }
 
     // 5. package.json 동적 최적화
@@ -177,8 +169,6 @@ async function run() {
       await fs.remove(path.join(targetPath, `vitest.config.${configExt}`));
       await fs.remove(path.join(targetPath, `src/app.test.${configExt}`));
       delete pkg.scripts.test;
-      delete pkg.scripts["test:ui"];
-      delete pkg.scripts["test:run"];
       delete pkg.devDependencies.vitest;
       delete pkg.devDependencies.supertest;
     }
@@ -186,14 +176,12 @@ async function run() {
     if (useDb) {
       pkg.scripts["db:up"] = "docker-compose up -d";
       pkg.scripts["db:push"] = "prisma db push";
-      pkg.scripts["prisma:generate"] = "prisma generate";
-      pkg.scripts["prisma:studio"] = "prisma studio";
       pkg.dependencies["@prisma/client"] = "^5.0.0";
       pkg.devDependencies["prisma"] = "^5.0.0";
     }
 
     await fs.writeJson(pkgPath, pkg, { spaces: 2 });
-    s.stop('파일 구성 완료!');
+    s.stop('프로젝트 파일 구성 완료!');
 
     // 6. 의존성 설치
     const installSpinner = p.spinner();
@@ -202,14 +190,14 @@ async function run() {
       execSync('npm install', { cwd: targetPath, stdio: 'ignore' });
       installSpinner.stop('설치 완료!');
     } catch (e) {
-      installSpinner.stop(chalk.red('설치 실패 (수동 설치가 필요할 수 있습니다)'));
+      installSpinner.stop(chalk.red('설치 실패 (수동으로 npm install을 실행해 주세요)'));
     }
 
-    // 7. 마무리
+    // 7. 마무리 안내
     let nextSteps = `cd ${projectName}\n`;
     if (useDb) {
-      nextSteps += `${chalk.bold('npm run db:up')} (DB 실행)\n`;
-      nextSteps += `${chalk.bold('npm run db:push')} (테이블 생성)\n`;
+      nextSteps += `${chalk.bold('npm run db:up')} (Docker 실행)\n`;
+      nextSteps += `${chalk.bold('npm run db:push')} (DB 스키마 반영)\n`;
     }
     nextSteps += `npm run dev`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-express-esm",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "A modern CLI tool to bootstrap Express.js applications with ES Modules and Layered Architecture.",
   "main": "index.js",
   "type": "module",

package/template/common/docker-compose.yml.mariadb

@@ -0,0 +1,14 @@
+services:
+  db:
+    image: mariadb:10.11
+    restart: always
+    ports:
+      - "5306:3306"
+    environment:
+      MARIADB_ROOT_PASSWORD: ${DB_PASSWORD:-mypassword}
+      MARIADB_DATABASE: ${DB_NAME:-mydb}
+    volumes:
+      - mariadb_data:/var/lib/mysql
+
+volumes:
+  mariadb_data:

package/template/common/docker-compose.yml.mongodb

@@ -0,0 +1,15 @@
+services:
+  db:
+    image: mongo:6.0
+    restart: always
+    ports:
+      - "27017:27017"
+    environment:
+      MONGO_INITDB_ROOT_USERNAME: ${DB_USER:-root}
+      MONGO_INITDB_ROOT_PASSWORD: ${DB_PASSWORD:-mypassword}
+      MONGO_INITDB_DATABASE: ${DB_NAME:-mydb}
+    volumes:
+      - mongo_data:/data/db
+
+volumes:
+  mongo_data:

package/template/common/{docker-compose.yml → docker-compose.yml.postgresql}

@@ -8,7 +8,7 @@ services:
       - POSTGRES_PASSWORD=mypassword
       - POSTGRES_DB=mydb
     ports:
-      - '5432:5432'
+      - '5433:5432'
     volumes:
       - db-data:/var/lib/postgresql/data
 

package/template/common/prisma/schema.prisma.mariadb

@@ -0,0 +1,14 @@
+datasource db {
+  provider = "mysql"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+model User {
+  id    Int     @id @default(autoincrement())
+  email String  @unique
+  name  String?
+}

package/template/common/prisma/schema.prisma.mongodb

@@ -0,0 +1,14 @@
+datasource db {
+  provider = "mongodb"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+model User {
+  id    String  @id @default(auto()) @map("_id") @db.ObjectId
+  email String  @unique
+  name  String?
+}

package/template/common/src/js/controllers/userController.js

@@ -0,0 +1,10 @@
+import * as userService from '../services/userService.js';
+
+export const getUsers = async (req, res, next) => {
+  try {
+    const users = await userService.findAllUsers();
+    res.status(200).json(users);
+  } catch (error) {
+    next(error); // 에러 미들웨어로 전달
+  }
+};

package/template/common/src/js/lib/prisma.js

@@ -0,0 +1 @@
+import { PrismaClient } from '@prisma/client'; export const prisma = new PrismaClient();

package/template/common/src/js/middlewares/errorMiddleware.js

@@ -0,0 +1,9 @@
+export const errorHandler = (err, req, res, next) => {
+  err.statusCode = err.statusCode || 500;
+  err.status = err.status || 'error';
+
+  res.status(err.statusCode).json({
+    status: err.status,
+    message: err.message,
+  });
+};

package/template/common/src/js/services/userService.js

@@ -0,0 +1,7 @@
+export const findAllUsers = async () => {
+  // 실제 DB 연동 전 샘플 데이터
+  return [
+    { id: 1, name: "Developer", role: "Fullstack" },
+    { id: 2, name: "Gemius AI", role: "Assistant" }
+  ];
+};

package/template/common/src/js/utils/appError.js

@@ -0,0 +1,10 @@
+export class AppError extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+    this.status = `${statusCode}`.startsWith('4') ? 'fail' : 'error';
+    this.isOperational = true;
+
+    Error.captureStackTrace(this, this.constructor);
+  }
+}

package/template/common/src/ts/controllers/userController.ts

@@ -0,0 +1,11 @@
+import { Request, Response, NextFunction } from 'express';
+import * as userService from '../services/userService.js';
+
+export const getUsers = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const users = await userService.findAllUsers();
+    res.status(200).json(users);
+  } catch (error) {
+    next(error);
+  }
+};

package/template/common/src/ts/lib/prisma.ts

@@ -0,0 +1 @@
+import { PrismaClient } from '@prisma/client'; export const prisma: PrismaClient = new PrismaClient();

package/template/common/src/ts/middlewares/errorMiddleware.ts

@@ -0,0 +1,11 @@
+import { Request, Response, NextFunction } from 'express';
+
+export const errorHandler = (err: any, req: Request, res: Response, next: NextFunction) => {
+  const statusCode = err.statusCode || 500;
+  const status = err.status || 'error';
+
+  res.status(statusCode).json({
+    status,
+    message: err.message,
+  });
+};

package/template/{ts/src → common/src/ts}/routes/userRoutes.ts

@@ -1,7 +1,7 @@
-import { Router } from 'express';
+import express from 'express';
 import * as userController from '../controllers/userController.js';
 
-const router = Router();
+const router = express.Router();
 
 router.get('/', userController.getUsers);
 

package/template/common/src/ts/services/userService.ts

@@ -0,0 +1,12 @@
+interface User {
+  id: number;
+  name: string;
+  role: string;
+}
+
+export const findAllUsers = async (): Promise<User[]> => {
+  return [
+    { id: 1, name: "Developer", role: "Fullstack" },
+    { id: 2, name: "Genius AI", role: "Assistant" }
+  ];
+};

package/template/common/src/{utils → ts/utils}/appError.ts

@@ -1,11 +1,13 @@
 export class AppError extends Error {
   public statusCode: number;
+  public status: string;
   public isOperational: boolean;
 
   constructor(message: string, statusCode: number) {
     super(message);
     this.statusCode = statusCode;
-    this.isOperational = true; // 예측 가능한 에러임을 표시
+    this.status = `${statusCode}`.startsWith('4') ? 'fail' : 'error';
+    this.isOperational = true;
 
     Error.captureStackTrace(this, this.constructor);
   }

package/template/js/_env

@@ -1,3 +0,0 @@
-# PostgreSQL Connection String
-# 형식: postgresql://사용자:비밀번호@호스트:포트/데이터베이스명?schema=public
-DATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/myapp?schema=public"

package/template/js/src/app.js

@@ -3,17 +3,13 @@ import cors from 'cors';
 import morgan from 'morgan';
 import dotenv from 'dotenv';
 
-import userRoutes from './routes/userRoutes.js';
-
+dotenv.config();
 const app = express();
 
 app.use(cors());
 app.use(morgan('dev'));
-app.use(express.json());
-
-// 라우터 연결 (Layered Arch 시작점)
-app.use('/api/users', userRoutes);
+app.use(express.json()); // cli.js가 이 줄 바로 아래에 라우터를 꽂습니다.
 
 app.get('/', (req, res) => res.send('Welcome to Modern Express!'));
 
-export default app;
+export default app; // cli.js가 이 줄 바로 위에 에러 핸들러를 꽂습니다.

package/template/js/src/server.js

@@ -2,7 +2,7 @@ import app from './app.js';
 import dotenv from 'dotenv';
 
 dotenv.config();
-const PORT = process.env.PORT || 3000;
+const PORT = process.env.PORT || 8080;
 
 app.listen(PORT, () => {
   console.log(`🚀 Server running on http://localhost:${PORT}`);

package/template/ts/_env

@@ -1,3 +0,0 @@
-# PostgreSQL Connection String
-# 형식: postgresql://사용자:비밀번호@호스트:포트/데이터베이스명?schema=public
-DATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/myapp?schema=public"

package/template/ts/src/server.ts

@@ -1,7 +1,7 @@
 import 'dotenv/config';
 import app from './app.js';
 
-const PORT = process.env.PORT || 3000;
+const PORT = process.env.PORT || 8080;
 
 app.listen(PORT, () => {
   console.log(`🚀 Server is running on http://localhost:${PORT}`);