@hamjimin/xplat-back 0.5.0 → 0.6.0

package/dist/cli/index.js

@@ -28,6 +28,10 @@ async function main() {
                 case '--router-path':
                     config.routerBasePath = args[++i];
                     break;
+                case '--with-next':
+                case '--next':
+                    config.withNext = true;
+                    break;
                 case '--help':
                 case '-h':
                     showHelp();
@@ -64,6 +68,7 @@ Options:
   -c, --cors <origins>           CORS 허용 origins (쉼표로 구분, 기본값: http://localhost:3000)
   -r, --router-dir <directory>   라우터 디렉토리 (기본값: src/restapi)
       --router-path <path>       라우터 base path (기본값: /restapi)
+      --with-next                Next.js 프론트엔드(web) 템플릿 추가
   -h, --help                     도움말 출력
 
 Examples:

package/dist/cli/init.d.ts

@@ -7,6 +7,7 @@ export interface InitConfig {
     corsOrigins?: string;
     routerDirectory?: string;
     routerBasePath?: string;
+    withNext?: boolean;
 }
 /**
  * 프로젝트 초기화 로직

package/dist/cli/init.js

@@ -48,6 +48,7 @@ async function initializeProject(config = {}) {
     const corsOrigins = config.corsOrigins || 'http://localhost:3000';
     const routerDirectory = config.routerDirectory || 'src/restapi';
     const routerBasePath = config.routerBasePath || '/restapi';
+    const withNext = config.withNext || false;
     console.log('\n🚀 xplat-back 프로젝트 초기화를 시작합니다...\n');
     // src 디렉토리 생성
     const srcDir = path.join(projectRoot, 'src');
@@ -75,6 +76,12 @@ async function initializeProject(config = {}) {
     await createExampleRouteFile(restapiDir);
     // 상수 파일 생성 (src/const 디렉토리)
     await createConstantsFiles(srcDir);
+    // DB 설정 파일 생성 (src/util/dbconfig)
+    await createDbConfigFiles(srcDir);
+    // Next.js 앱 생성 (옵션)
+    if (withNext) {
+        await createNextApp(projectRoot);
+    }
     console.log('\n✅ 프로젝트 초기화가 완료되었습니다!');
     console.log(`\n생성된 파일:`);
     console.log(`  - src/app.ts`);
@@ -85,6 +92,12 @@ async function initializeProject(config = {}) {
     console.log(`  - ${routerDirectory}/health.ts`);
     console.log(`  - src/const/api_code.ts`);
     console.log(`  - src/const/constants.ts`);
+    console.log(`  - src/util/dbconfig/dbConnections.ts`);
+    if (withNext) {
+        console.log(`  - web/next.config.js`);
+        console.log(`  - web/app/page.tsx`);
+        console.log(`  - web/package.json`);
+    }
     console.log(`\n다음 단계:`);
     console.log(`  1. npm install (또는 yarn install)`);
     console.log(`  2. npm run dev (또는 yarn dev)로 서버 실행`);
@@ -101,8 +114,11 @@ async function createAppFile(projectRoot, port, corsOrigins, routerDirectory, ro
     }
     const appContent = `import express, { Application } from 'express';
 import * as path from 'path';
+import dotenv from 'dotenv';
 import { createApp } from 'xplat-back';
 
+dotenv.config();
+
 const app: Application = createApp({
   cors: {
     origin: process.env.CORS_ALLOW_ORIGINS
@@ -218,7 +234,10 @@ async function createPackageJsonFile(projectRoot, projectName) {
         },
         dependencies: {
             express: '^4.18.2',
-            'xplat-back': '^0.1.0',
+            dotenv: '^16.4.5',
+            typeorm: '^0.3.20',
+            mysql2: '^3.9.7',
+            'xplat-back': '^0.5.1',
         },
         devDependencies: {
             '@types/express': '^4.17.21',
@@ -247,7 +266,14 @@ PORT=${port}
 # CORS Configuration
 CORS_ALLOW_ORIGINS=${corsOrigins}
 
-# Add your environment variables below
+# Database Configuration
+DB_HOST=localhost
+DB_PORT=3306
+DB_USER=root
+DB_PASSWORD=
+DB_DATABASE=my_database
+DB_MYSQL_PORT=3306
+DB_SYNC=false
 `;
     fs.writeFileSync(envPath, envContent, 'utf-8');
     console.log(`✅ .env 파일이 생성되었습니다.`);
@@ -298,3 +324,68 @@ async function createConstantsFiles(srcDir) {
         console.log(`⚠️  src/const/constants.ts 파일이 이미 존재합니다. 건너뜁니다.`);
     }
 }
+/**
+ * DB 설정 파일 생성 (src/util/dbconfig/dbConnections.ts)
+ */
+async function createDbConfigFiles(srcDir) {
+    const dbConfigDir = path.join(srcDir, 'util', 'dbconfig');
+    if (!fs.existsSync(dbConfigDir)) {
+        fs.mkdirSync(dbConfigDir, { recursive: true });
+    }
+    const dbConnectionsPath = path.join(dbConfigDir, 'dbConnections.ts');
+    if (fs.existsSync(dbConnectionsPath)) {
+        console.log(`⚠️  src/util/dbconfig/dbConnections.ts 파일이 이미 존재합니다. 건너뜁니다.`);
+        return;
+    }
+    const templatePath = path.join(__dirname, 'templates', 'util', 'dbconfig', 'dbConnections.ts.example');
+    const templateContent = fs.readFileSync(templatePath, 'utf-8');
+    fs.writeFileSync(dbConnectionsPath, templateContent, 'utf-8');
+    console.log(`✅ src/util/dbconfig/dbConnections.ts 파일이 생성되었습니다.`);
+}
+/**
+ * Next.js 프로젝트 생성 (web 디렉토리)
+ */
+async function createNextApp(projectRoot) {
+    const webDir = path.join(projectRoot, 'web');
+    if (!fs.existsSync(webDir)) {
+        fs.mkdirSync(webDir, { recursive: true });
+    }
+    const templateBase = path.join(__dirname, 'templates', 'next');
+    const filesToCopy = [
+        { template: 'package.json.example', target: 'package.json' },
+        { template: 'tsconfig.json.example', target: 'tsconfig.json' },
+        { template: 'next.config.js.example', target: 'next.config.js' },
+    ];
+    filesToCopy.forEach(({ template, target }) => {
+        const targetPath = path.join(webDir, target);
+        if (fs.existsSync(targetPath)) {
+            console.log(`⚠️  web/${target} 파일이 이미 존재합니다. 건너뜁니다.`);
+            return;
+        }
+        const templatePath = path.join(templateBase, template);
+        const content = fs.readFileSync(templatePath, 'utf-8');
+        fs.writeFileSync(targetPath, content, 'utf-8');
+        console.log(`✅ web/${target} 파일이 생성되었습니다.`);
+    });
+    const appDir = path.join(webDir, 'app');
+    if (!fs.existsSync(appDir)) {
+        fs.mkdirSync(appDir, { recursive: true });
+        console.log(`✅ web/app 디렉토리가 생성되었습니다.`);
+    }
+    const appFiles = [
+        { template: path.join('app', 'page.tsx.example'), target: path.join(appDir, 'page.tsx') },
+        { template: path.join('app', 'layout.tsx.example'), target: path.join(appDir, 'layout.tsx') },
+        { template: path.join('app', 'globals.css.example'), target: path.join(appDir, 'globals.css') },
+        { template: 'next-env.d.ts.example', target: path.join(webDir, 'next-env.d.ts') },
+    ];
+    appFiles.forEach(({ template, target }) => {
+        if (fs.existsSync(target)) {
+            console.log(`⚠️  ${path.relative(projectRoot, target)} 파일이 이미 존재합니다. 건너뜁니다.`);
+            return;
+        }
+        const templatePath = path.join(templateBase, template);
+        const content = fs.readFileSync(templatePath, 'utf-8');
+        fs.writeFileSync(target, content, 'utf-8');
+        console.log(`✅ ${path.relative(projectRoot, target)} 파일이 생성되었습니다.`);
+    });
+}

package/dist/cli/templates/app.ts.example

@@ -1,7 +1,10 @@
 import express, { Application } from 'express';
 import * as path from 'path';
+import dotenv from 'dotenv';
 import { createApp } from 'xplat-back';
 
+dotenv.config();
+
 const app: Application = createApp({
   cors: {
     origin: process.env.CORS_ALLOW_ORIGINS

package/dist/cli/templates/next/app/globals.css.example

@@ -0,0 +1,15 @@
+:root {
+  color-scheme: light;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif;
+  background: #fafafa;
+  color: #111;
+}

package/dist/cli/templates/next/app/layout.tsx.example

@@ -0,0 +1,16 @@
+import './globals.css';
+import type { Metadata } from 'next';
+import { ReactNode } from 'react';
+
+export const metadata: Metadata = {
+  title: 'xplat-web',
+  description: 'Next.js + xplat-back starter',
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/dist/cli/templates/next/app/page.tsx.example

@@ -0,0 +1,12 @@
+export default function Home() {
+  return (
+    <main style={{ padding: '24px', fontFamily: 'sans-serif' }}>
+      <h1>Next.js + xplat-back</h1>
+      <p>프론트(Next.js)와 백엔드(xplat-back)를 한 프로젝트에서 시작합니다.</p>
+      <ul>
+        <li>백엔드: <code>npm run dev</code> (루트)</li>
+        <li>프론트: <code>cd web && npm run dev</code></li>
+      </ul>
+    </main>
+  );
+}

package/dist/cli/templates/next/next-env.d.ts.example

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

package/dist/cli/templates/next/next.config.js.example

@@ -0,0 +1,9 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  experimental: {
+    typedRoutes: true,
+  },
+};
+
+module.exports = nextConfig;

package/dist/cli/templates/next/package.json.example

@@ -0,0 +1,24 @@
+{
+  "name": "xplat-web",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "14.2.5",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.64",
+    "@types/react-dom": "^18.2.21",
+    "typescript": "^5.3.3",
+    "eslint": "^8.57.0",
+    "eslint-config-next": "14.2.5"
+  }
+}

package/dist/cli/templates/next/tsconfig.json.example

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/dist/cli/templates/package.json.example

@@ -11,7 +11,10 @@
   },
   "dependencies": {
     "express": "^4.18.2",
-    "xplat-back": "^0.1.0"
+    "dotenv": "^16.4.5",
+    "typeorm": "^0.3.20",
+    "mysql2": "^3.9.7",
+    "xplat-back": "^0.5.1"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",

package/dist/cli/templates/util/dbconfig/dbConnections.ts.example

@@ -0,0 +1,92 @@
+import { DataSource, DataSourceOptions } from 'typeorm';
+import * as path from 'path';
+import * as fs from 'fs';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+/**
+ * 프로젝트 엔티티를 동적으로 로딩합니다.
+ * 필요에 따라 경로를 조정하거나 직접 배열로 지정해 주세요.
+ */
+const loadEntities = (dir: string) => {
+  const entities: Function[] = [];
+  if (!fs.existsSync(dir)) return entities;
+
+  const files = fs.readdirSync(dir);
+  for (const file of files) {
+    if (file.endsWith('.ts') || file.endsWith('.js')) {
+      const entity = require(path.join(dir, file));
+      for (const key in entity) {
+        entities.push(entity[key]);
+      }
+    }
+  }
+  return entities;
+};
+
+const connectionInfo = (target: string): DataSourceOptions => {
+  const port =
+    Number(process.env[`${target}_MYSQL_PORT`]) ||
+    Number(process.env[`${target}_PORT`]) ||
+    3306;
+
+  return {
+    type: 'mysql',
+    // 개발용 스키마 자동 동기화 (운영에서는 DB_SYNC=false 권장)
+    synchronize: process.env.DB_SYNC === 'true',
+    logging: process.env.NODE_ENV === 'production' ? ['error'] : ['query', 'error'],
+    host: process.env[`${target}_HOST`] || 'localhost',
+    port,
+    username: process.env[`${target}_USER`] || 'root',
+    password: process.env[`${target}_PASSWORD`] || '',
+    database: process.env[`${target}_DATABASE`] || 'database',
+    charset: 'utf8mb4',
+    timezone: '+09:00',
+    extra: {
+      connectionLimit: 50,
+      connectTimeout: 60000,
+      waitForConnections: true,
+      idleTimeout: 300000,
+      acquireTimeout: 60000,
+      reconnect: true,
+      dateStrings: true,
+    },
+  };
+};
+
+export const mainDB = new DataSource({
+  ...connectionInfo('DB'),
+  // 필요 시 엔티티 경로를 변경하거나 직접 배열로 설정하세요.
+  entities: loadEntities(path.join(__dirname, '..', '..', 'entities')),
+});
+
+/**
+ * 데이터베이스 연결을 초기화합니다.
+ */
+export const initializeDatabase = async () => {
+  if (!mainDB.isInitialized) {
+    await mainDB.initialize();
+    console.log('✅ Database connection initialized');
+    return;
+  }
+
+  try {
+    await mainDB.query('SELECT 1');
+  } catch (error) {
+    console.error('Connection lost. Reconnecting...', error);
+    await mainDB.destroy();
+    await mainDB.initialize();
+  }
+};
+
+/**
+ * 엔티티 기준 스키마 동기화 (DB_SYNC=true 일 때만 실행 권장)
+ */
+export const syncSchema = async () => {
+  if (!mainDB.isInitialized) {
+    await mainDB.initialize();
+  }
+  await mainDB.synchronize();
+  console.log('✅ Database schema synchronized from entities');
+};

package/dist/commerce/commerce.module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CommerceModule
+ * - Store/Admin API 분리 구조를 제공하는 최상위 모듈
+ * - 도메인 모듈은 하위 todos에서 점진적으로 추가됩니다.
+ */
+export declare class CommerceModule {
+}

package/dist/commerce/commerce.module.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommerceModule = void 0;
+const common_1 = require("@nestjs/common");
+const admin_api_module_1 = require("./modules/admin/admin-api.module");
+const store_api_module_1 = require("./modules/store/store-api.module");
+/**
+ * CommerceModule
+ * - Store/Admin API 분리 구조를 제공하는 최상위 모듈
+ * - 도메인 모듈은 하위 todos에서 점진적으로 추가됩니다.
+ */
+let CommerceModule = class CommerceModule {
+};
+exports.CommerceModule = CommerceModule;
+exports.CommerceModule = CommerceModule = __decorate([
+    (0, common_1.Module)({
+        imports: [store_api_module_1.StoreApiModule, admin_api_module_1.AdminApiModule],
+    })
+], CommerceModule);

package/dist/commerce/modules/admin/admin-api.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Admin API (v1)
+ * - 운영/머천트용 엔드포인트를 제공합니다.
+ * - prefix는 generated template에서 /admin/v1 로 고정될 예정이며,
+ *   컨트롤러는 이후 도메인별로 확장합니다.
+ */
+export declare class AdminApiModule {
+}

package/dist/commerce/modules/admin/admin-api.module.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminApiModule = void 0;
+const common_1 = require("@nestjs/common");
+const admin_health_controller_1 = require("./controllers/admin-health.controller");
+/**
+ * Admin API (v1)
+ * - 운영/머천트용 엔드포인트를 제공합니다.
+ * - prefix는 generated template에서 /admin/v1 로 고정될 예정이며,
+ *   컨트롤러는 이후 도메인별로 확장합니다.
+ */
+let AdminApiModule = class AdminApiModule {
+};
+exports.AdminApiModule = AdminApiModule;
+exports.AdminApiModule = AdminApiModule = __decorate([
+    (0, common_1.Module)({
+        controllers: [admin_health_controller_1.AdminHealthController],
+    })
+], AdminApiModule);

package/dist/commerce/modules/admin/controllers/admin-health.controller.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Admin Health
+ * - 스캐폴딩/연결 확인용 최소 엔드포인트
+ */
+export declare class AdminHealthController {
+    health(): {
+        ok: boolean;
+        scope: string;
+        timestamp: string;
+    };
+}

package/dist/commerce/modules/admin/controllers/admin-health.controller.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminHealthController = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Admin Health
+ * - 스캐폴딩/연결 확인용 최소 엔드포인트
+ */
+let AdminHealthController = class AdminHealthController {
+    health() {
+        return {
+            ok: true,
+            scope: 'admin',
+            timestamp: new Date().toISOString(),
+        };
+    }
+};
+exports.AdminHealthController = AdminHealthController;
+__decorate([
+    (0, common_1.Get)('health'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AdminHealthController.prototype, "health", null);
+exports.AdminHealthController = AdminHealthController = __decorate([
+    (0, common_1.Controller)()
+], AdminHealthController);

package/dist/commerce/modules/store/controllers/store-health.controller.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Store Health
+ * - 스캐폴딩/연결 확인용 최소 엔드포인트
+ */
+export declare class StoreHealthController {
+    health(): {
+        ok: boolean;
+        scope: string;
+        timestamp: string;
+    };
+}

package/dist/commerce/modules/store/controllers/store-health.controller.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreHealthController = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Store Health
+ * - 스캐폴딩/연결 확인용 최소 엔드포인트
+ */
+let StoreHealthController = class StoreHealthController {
+    health() {
+        return {
+            ok: true,
+            scope: 'store',
+            timestamp: new Date().toISOString(),
+        };
+    }
+};
+exports.StoreHealthController = StoreHealthController;
+__decorate([
+    (0, common_1.Get)('health'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], StoreHealthController.prototype, "health", null);
+exports.StoreHealthController = StoreHealthController = __decorate([
+    (0, common_1.Controller)()
+], StoreHealthController);

package/dist/commerce/modules/store/store-api.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Store API (v1)
+ * - 공개/고객용 엔드포인트를 제공합니다.
+ * - prefix는 generated template에서 /store/v1 로 고정될 예정이며,
+ *   컨트롤러는 이후 도메인별로 확장합니다.
+ */
+export declare class StoreApiModule {
+}

package/dist/commerce/modules/store/store-api.module.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreApiModule = void 0;
+const common_1 = require("@nestjs/common");
+const store_health_controller_1 = require("./controllers/store-health.controller");
+/**
+ * Store API (v1)
+ * - 공개/고객용 엔드포인트를 제공합니다.
+ * - prefix는 generated template에서 /store/v1 로 고정될 예정이며,
+ *   컨트롤러는 이후 도메인별로 확장합니다.
+ */
+let StoreApiModule = class StoreApiModule {
+};
+exports.StoreApiModule = StoreApiModule;
+exports.StoreApiModule = StoreApiModule = __decorate([
+    (0, common_1.Module)({
+        controllers: [store_health_controller_1.StoreHealthController],
+    })
+], StoreApiModule);

package/dist/commerce/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 커머스 플랫폼 공통 타입/계약 (Medusa 스타일 참고)
+ */
+export type ApiScope = 'store' | 'admin';
+export interface ApiVersioning {
+    storePrefix: string;
+    adminPrefix: string;
+}
+export interface CommerceCoreConfig {
+    versioning?: Partial<ApiVersioning>;
+}
+/**
+ * 확장 포인트: 이벤트 버스
+ * - 초기 구현은 간단한 in-memory pub/sub로 시작하고,
+ *   이후 Kafka/SQS/Redis 등으로 교체 가능하도록 포트만 정의합니다.
+ */
+export interface EventBus {
+    publish<TPayload>(eventName: string, payload: TPayload): Promise<void>;
+    subscribe<TPayload>(eventName: string, handler: (payload: TPayload) => Promise<void> | void): () => void;
+}
+/**
+ * 확장 포인트: Job/Queue
+ */
+export interface JobQueue {
+    enqueue<TPayload>(jobName: string, payload: TPayload, opts?: Record<string, any>): Promise<string>;
+}
+/**
+ * 확장 포인트: Hook
+ * - 특정 도메인 흐름(예: cart.updated, order.placed) 전/후 처리 훅
+ */
+export interface HookRunner {
+    run<TContext>(hookName: string, ctx: TContext): Promise<TContext>;
+}

package/dist/commerce/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * 커머스 플랫폼 공통 타입/계약 (Medusa 스타일 참고)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/XplatSystem.d.ts

@@ -8,6 +8,7 @@ import { StorageModule } from '../modules/storage';
 import { ORMModule } from '../modules/orm';
 import { PaymentModule } from '../modules/payment';
 import { ShippingModule } from '../modules/shipping';
+import { CommerceModule } from '../modules/commerce';
 /**
  * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
  *
@@ -25,6 +26,7 @@ export declare class XplatSystem {
     readonly orm: ORMModule;
     readonly payment: PaymentModule;
     readonly shipping: ShippingModule;
+    readonly commerce: CommerceModule;
     /**
      * Private constructor (Singleton 패턴)
      */

package/dist/core/XplatSystem.js

@@ -11,6 +11,7 @@ const storage_1 = require("../modules/storage");
 const orm_1 = require("../modules/orm");
 const payment_1 = require("../modules/payment");
 const shipping_1 = require("../modules/shipping");
+const commerce_1 = require("../modules/commerce");
 /**
  * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
  *
@@ -31,6 +32,7 @@ class XplatSystem {
         this.orm = new orm_1.ORMModule();
         this.payment = new payment_1.PaymentModule();
         this.shipping = new shipping_1.ShippingModule();
+        this.commerce = new commerce_1.CommerceModule();
     }
     /**
      * Singleton 인스턴스 반환

package/dist/modules/commerce/index.d.ts

@@ -0,0 +1,15 @@
+import { CommerceCoreConfig } from '../../commerce/types';
+/**
+ * CommerceModule (xplatSystem용 래퍼)
+ * - Nest 모듈(CommerceModule)을 직접 노출하기 전에,
+ *   싱글턴 접근 패턴(`xplatSystem.commerce`)을 유지하기 위한 최소 래퍼입니다.
+ * - 실제 동작 구현(이벤트/잡/도메인 서비스)은 후속 todo에서 확장합니다.
+ */
+export declare class CommerceModule {
+    private config;
+    constructor(config?: CommerceCoreConfig);
+    getVersioning(): {
+        storePrefix: string;
+        adminPrefix: string;
+    };
+}

package/dist/modules/commerce/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommerceModule = void 0;
+/**
+ * CommerceModule (xplatSystem용 래퍼)
+ * - Nest 모듈(CommerceModule)을 직접 노출하기 전에,
+ *   싱글턴 접근 패턴(`xplatSystem.commerce`)을 유지하기 위한 최소 래퍼입니다.
+ * - 실제 동작 구현(이벤트/잡/도메인 서비스)은 후속 todo에서 확장합니다.
+ */
+class CommerceModule {
+    constructor(config = {}) {
+        this.config = config;
+    }
+    getVersioning() {
+        return {
+            storePrefix: this.config.versioning?.storePrefix ?? '/store/v1',
+            adminPrefix: this.config.versioning?.adminPrefix ?? '/admin/v1',
+        };
+    }
+}
+exports.CommerceModule = CommerceModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamjimin/xplat-back",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Express + TypeScript 백엔드 스캐폴딩 도구 (zium-backend 기반)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,6 @@
   "bin": {
     "xplat-back": "./bin/xplat-back"
   },
-  
   "files": [
     "dist",
     "bin",
@@ -36,13 +35,20 @@
   "author": "xplat",
   "license": "ISC",
   "dependencies": {
-    "express": "^4.18.2",
+    "@nestjs/common": "^10.4.15",
+    "@nestjs/core": "^10.4.15",
+    "@nestjs/platform-express": "^10.4.15",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
     "cookie-parser": "^1.4.6",
     "cors": "^2.8.5",
+    "express": "^4.18.2",
     "jsonwebtoken": "^9.0.2",
     "bcrypt": "^5.1.1",
     "crypto-js": "^4.2.0",
     "lodash": "^4.17.21",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
     "uuid": "^9.0.1",
     "@aws-sdk/client-s3": "^3.922.0",
     "@aws-sdk/s3-request-presigner": "^3.922.0"