@fuzionx/framework 0.1.27 → 0.1.29

package/cli/index.js

@@ -93,7 +93,7 @@ const TYPE_SUFFIXES = {
 export async function makeFile(type, name, baseDir = '.', appName) {
     let dir;
     if (APP_TYPE_DIRS[type]) {
-        if (!appName) throw new Error(`--app option required for make:${type} (e.g. fx make:${type} ${name} --app=backend)`);
+        if (!appName) throw new Error(`--app option required for make:${type} (e.g. fx make:${type} ${name} --app=fuzionx)`);
         dir = `app/${appName}/${APP_TYPE_DIRS[type]}`;
     } else if (SHARED_TYPE_DIRS[type]) {
         dir = SHARED_TYPE_DIRS[type];
@@ -127,42 +127,51 @@ const APP_FILES = [
     { tpl: 'app/package.json.tpl', dest: 'package.json' },
     { tpl: 'app/fuzionx.yaml.tpl', dest: 'fuzionx.yaml' },
     { tpl: 'app/app.js.tpl', dest: 'app.js' },
-    { tpl: 'app/routes/web.js.tpl', dest: 'app/backend/routes/web.js' },
-    { tpl: 'app/routes/api.js.tpl', dest: 'app/backend/routes/api.js' },
     { tpl: 'app/.env.example.tpl', dest: '.env.example' },
     { tpl: 'app/.env.example.tpl', dest: '.env' },
     { tpl: 'app/.gitignore.tpl', dest: '.gitignore' },
 ];
 
-/** 스캐폴딩 디렉토리 (multi-app 구조) */
+/** fuzionx 앱 템플릿 (.tpl 파일은 치환, 그 외는 직접 복사) */
+const FUZIONX_TPL_FILES = [
+    { tpl: 'app/fuzionx/routes/web.js.tpl', dest: 'app/fuzionx/routes/web.js' },
+    { tpl: 'app/fuzionx/routes/api.js.tpl', dest: 'app/fuzionx/routes/api.js' },
+];
+
+/** 디렉토리 재귀 복사 (템플릿 → 프로젝트) */
+async function copyDirRecursive(src, dst) {
+    await fs.mkdir(dst, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const dstPath = path.join(dst, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirRecursive(srcPath, dstPath);
+        } else {
+            await fs.copyFile(srcPath, dstPath);
+        }
+    }
+}
+
+/** 스캐폴딩 디렉토리 (빈 디렉토리 + .gitkeep) */
 const APP_DIRS = [
-    // 앱별
-    'app/backend/controllers',
-    'app/backend/routes',
-    'app/backend/services',
-    'app/backend/middleware',
-    'app/backend/views/default/pages',
-    'app/backend/views/default/layouts',
-    'app/backend/views/default/errors',
-    'app/backend/ws',
-    // 공유
-    'database/models',
+    // fuzionx 앱 (개발자 작업 영역)
+    'app/fuzionx/services',
+    'app/fuzionx/middleware',
+    'app/fuzionx/ws',
+    // tester 앱 (빈 폴더가 아닌 것은 copyDirRecursive로 처리)
+    // 인프라
     'database/migrations',
     'database/seeds',
-    'shared/events',
-    'shared/jobs',
-    'shared/workers',
-    // 인프라
     'storage/logs',
     'storage/uploads',
     'public/css',
     'public/js',
-    'locales',
     'tests',
 ];
 
 /**
- * fx new <name> — 앱 스캐폴딩
+ * fx new <name> — 앱 스캐폴딩 (fuzionx + tester 2-app 구조)
  * @param {string} name - 프로젝트 이름
  * @param {string} [targetDir] - 기본: ./<name>
  */
@@ -173,17 +182,17 @@ export async function createApp(name, targetDir) {
         dbName: name.replace(/-/g, '_'),
     };
 
-    // 디렉토리 생성
+    // 빈 디렉토리 생성 (.gitkeep 포함)
     for (const d of APP_DIRS) {
-        await fs.mkdir(path.join(dir, d), { recursive: true });
-        // .gitkeep 는 리프 원래 파일이 없는 디렉토리에만
-        const files = await fs.readdir(path.join(dir, d)).catch(() => []);
+        const fullDir = path.join(dir, d);
+        await fs.mkdir(fullDir, { recursive: true });
+        const files = await fs.readdir(fullDir).catch(() => []);
         if (files.length === 0) {
-            await fs.writeFile(path.join(dir, d, '.gitkeep'), '');
+            await fs.writeFile(path.join(fullDir, '.gitkeep'), '');
         }
     }
 
-    // 템플릿 파일 생성
+    // 루트 템플릿 파일 생성 (.tpl 치환)
     for (const { tpl, dest } of APP_FILES) {
         const content = await loadTemplate(tpl, vars);
         const fullPath = path.join(dir, dest);
@@ -191,36 +200,40 @@ export async function createApp(name, targetDir) {
         await fs.writeFile(fullPath, content);
     }
 
-    // HomeController 복사
-    const hcSrc = path.join(TPL_DIR, 'app/controllers/HomeController.js');
-    const hcDst = path.join(dir, 'app/backend/controllers/HomeController.js');
-    await fs.copyFile(hcSrc, hcDst);
-
-    // Views — app/backend/views/{theme}/ 구조
-    const viewsSrc = path.join(TPL_DIR, 'app/views/default');
-    const viewsDst = path.join(dir, 'app/backend/views/default');
+    // fuzionx 앱 — .tpl 파일 (치환 필요)
+    for (const { tpl, dest } of FUZIONX_TPL_FILES) {
+        const content = await loadTemplate(tpl, vars);
+        const fullPath = path.join(dir, dest);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, content);
+    }
 
-    // layouts/main.html
-    await fs.copyFile(
-        path.join(viewsSrc, 'layouts/main.html'),
-        path.join(viewsDst, 'layouts/main.html'),
+    // fuzionx 앱 — 직접 복사 (controllers, views)
+    const fuzionxSrc = path.join(TPL_DIR, 'app/fuzionx');
+    await copyDirRecursive(
+        path.join(fuzionxSrc, 'controllers'),
+        path.join(dir, 'app/fuzionx/controllers'),
     );
-
-    // pages/home.html
-    await fs.copyFile(
-        path.join(viewsSrc, 'pages/home.html'),
-        path.join(viewsDst, 'pages/home.html'),
+    await copyDirRecursive(
+        path.join(fuzionxSrc, 'views'),
+        path.join(dir, 'app/fuzionx/views'),
     );
 
-    // errors/404.html, 500.html
-    await fs.copyFile(
-        path.join(viewsSrc, 'errors/404.html'),
-        path.join(viewsDst, 'errors/404.html'),
-    );
-    await fs.copyFile(
-        path.join(viewsSrc, 'errors/500.html'),
-        path.join(viewsDst, 'errors/500.html'),
-    );
+    // tester 앱 — 전체 복사
+    const testerSrc = path.join(TPL_DIR, 'app/tester');
+    await copyDirRecursive(testerSrc, path.join(dir, 'app/tester'));
+
+    // shared — 전체 복사
+    const sharedSrc = path.join(TPL_DIR, 'app/shared');
+    await copyDirRecursive(sharedSrc, path.join(dir, 'shared'));
+
+    // database/models — 복사
+    const dbSrc = path.join(TPL_DIR, 'app/database');
+    await copyDirRecursive(dbSrc, path.join(dir, 'database'));
+
+    // locales — 복사
+    const localesSrc = path.join(TPL_DIR, 'app/locales');
+    await copyDirRecursive(localesSrc, path.join(dir, 'locales'));
 
     return dir;
 }

package/cli/templates/app/database/models/User.js

@@ -0,0 +1,9 @@
+import { MariaModel } from '@fuzionx/framework';
+
+export default class User extends MariaModel {
+    static table = 'users';
+    static connection = 'main';
+    static softDelete = true;
+    static hidden = ['password'];
+    static fillable = ['name', 'email', 'password', 'role'];
+}

package/cli/templates/app/fuzionx.yaml.tpl

@@ -196,7 +196,7 @@ app:
   #   prefix: "myapp:queue"
 
 # ── Multi-App (도메인 → 앱 라우팅) ────────────────
+# tester를 실행하려면 fuzionx를 주석 처리하고 tester 주석을 해제하세요.
 apps:
-  "localhost:49080": backend
-  # "admin.example.com": backend
-  # "example.com": frontend
+  "127.0.0.1:49080": fuzionx
+  # "127.0.0.1:49080": tester

package/cli/templates/app/locales/en.json

@@ -0,0 +1,52 @@
+{
+    "app": {
+        "name": "FuzionX Test App",
+        "welcome": "Welcome to FuzionX",
+        "description": "Full-stack framework testing environment"
+    },
+    "nav": {
+        "home": "Home",
+        "dashboard": "Dashboard",
+        "users": "Users",
+        "upload": "Upload",
+        "websocket": "WebSocket",
+        "docs": "API Docs",
+        "settings": "Settings"
+    },
+    "user": {
+        "name": "Name",
+        "email": "Email",
+        "role": "Role",
+        "create": "Create User",
+        "edit": "Edit",
+        "delete": "Delete",
+        "list": "User List",
+        "created": "User has been created",
+        "deleted": "User has been deleted",
+        "not_found": "User not found"
+    },
+    "auth": {
+        "login": "Login",
+        "logout": "Logout",
+        "login_required": "Login required",
+        "invalid_credentials": "Invalid credentials"
+    },
+    "common": {
+        "save": "Save",
+        "cancel": "Cancel",
+        "confirm": "Confirm",
+        "search": "Search",
+        "loading": "Loading...",
+        "error": "An error occurred",
+        "success": "Success",
+        "greeting": "Hello, {name}!",
+        "items_count": "{count} items total"
+    },
+    "upload": {
+        "select_file": "Select a file",
+        "drag_drop": "Drag & drop or click to select",
+        "uploading": "Uploading...",
+        "complete": "Upload complete",
+        "error": "Upload failed"
+    }
+}

package/cli/templates/app/locales/ko.json

@@ -0,0 +1,52 @@
+{
+    "app": {
+        "name": "FuzionX 테스트 앱",
+        "welcome": "FuzionX에 오신 것을 환영합니다",
+        "description": "풀스택 프레임워크 테스트 환경입니다"
+    },
+    "nav": {
+        "home": "홈",
+        "dashboard": "대시보드",
+        "users": "사용자",
+        "upload": "업로드",
+        "websocket": "웹소켓",
+        "docs": "API 문서",
+        "settings": "설정"
+    },
+    "user": {
+        "name": "이름",
+        "email": "이메일",
+        "role": "역할",
+        "create": "사용자 생성",
+        "edit": "수정",
+        "delete": "삭제",
+        "list": "사용자 목록",
+        "created": "사용자가 생성되었습니다",
+        "deleted": "사용자가 삭제되었습니다",
+        "not_found": "사용자를 찾을 수 없습니다"
+    },
+    "auth": {
+        "login": "로그인",
+        "logout": "로그아웃",
+        "login_required": "로그인이 필요합니다",
+        "invalid_credentials": "잘못된 인증 정보입니다"
+    },
+    "common": {
+        "save": "저장",
+        "cancel": "취소",
+        "confirm": "확인",
+        "search": "검색",
+        "loading": "로딩중...",
+        "error": "오류가 발생했습니다",
+        "success": "성공",
+        "greeting": "{name}님, 안녕하세요!",
+        "items_count": "총 {count}개 항목"
+    },
+    "upload": {
+        "select_file": "파일을 선택하세요",
+        "drag_drop": "파일을 드래그하거나 클릭하세요",
+        "uploading": "업로드 중...",
+        "complete": "업로드 완료",
+        "error": "업로드 실패"
+    }
+}

package/cli/templates/app/package.json.tpl

@@ -7,7 +7,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@fuzionx/framework": "^0.1.27"
+    "@fuzionx/framework": "^0.1.29",
+    "joi": "^18.1.1"
   },
   "devDependencies": {
     "vitest": "^3.0.0"

package/cli/templates/app/shared/events/userEvents.js

@@ -0,0 +1,10 @@
+/** 이벤트 리스너 등록 */
+export default (app) => {
+    app.on('user:created', (data) => {
+        console.log(`[Event] user:created → id=${data.id}, name=${data.name}`);
+    });
+
+    app.on('user:deleted', (data) => {
+        console.log(`[Event] user:deleted → id=${data.id}`);
+    });
+};

package/cli/templates/app/shared/jobs/CleanupJob.js

@@ -0,0 +1,18 @@
+import { Job } from '@fuzionx/framework';
+
+/** 매 5분마다 만료 세션 정리 (스케줄러 테스트) */
+export default class CleanupJob extends Job {
+    static schedule = 'every:5m';
+    static timeout = 10000;
+    static enabled = true;
+
+    async handle() {
+        const cleaned = Math.floor(Math.random() * 10);
+        console.log(`[CleanupJob] ${cleaned}개 만료 세션 정리 완료`);
+        return { cleaned };
+    }
+
+    async onError(error) {
+        console.error('[CleanupJob] 실패:', error.message);
+    }
+}

package/cli/templates/app/shared/jobs/EmailTask.js

@@ -0,0 +1,17 @@
+import { Task } from '@fuzionx/framework';
+
+/** 이메일 전송 비동기 Task (큐 테스트) */
+export default class EmailTask extends Task {
+    static queue = 'default';
+    static retries = 3;
+    static retryDelay = 1000;
+
+    async handle(data) {
+        console.log(`[EmailTask] 이메일 전송: to=${data.to}, subject=${data.subject}`);
+        return { sent: true, to: data.to };
+    }
+
+    async failed(data, error) {
+        console.error(`[EmailTask] 최종 실패: to=${data.to}, error=${error.message}`);
+    }
+}

package/cli/templates/app/shared/jobs/VideoPreviewTask.js

@@ -0,0 +1,47 @@
+import { Task } from '@fuzionx/framework';
+import path from 'node:path';
+
+/**
+ * 비디오 미리보기 생성 Task (큐 비동기 처리)
+ *
+ * 다중 썸네일 추출 + 스프라이트 시트 합성을 백그라운드에서 실행.
+ * 대용량 비디오에서 수백 장 추출 시 수 분 소요될 수 있으므로 큐로 위임.
+ */
+export default class VideoPreviewTask extends Task {
+    static queue = 'media';
+    static retries = 1;
+    static retryDelay = 3000;
+    static timeout = 600000; // 10분
+
+    async handle(data) {
+        const { filePath, outputDir, sheetPath, interval, width, cols } = data;
+        const app = this.app;
+
+        console.log(`[VideoPreview] 시작: interval=${interval}s, width=${width}px, file=${path.basename(filePath)}`);
+
+        // 1. 간격 기반 다중 썸네일 추출
+        const thumbs = app.media.videoThumbnails(filePath, outputDir, interval, width);
+        console.log(`[VideoPreview] 썸네일 ${thumbs.length}장 추출 완료`);
+
+        // 2. 스프라이트 시트 합성
+        if (thumbs.length > 0) {
+            app.media.videoPreviewSheet(thumbs, sheetPath, cols, Math.floor(width / 2));
+            console.log(`[VideoPreview] 스프라이트 시트 생성: ${sheetPath}`);
+
+            // 3. 워터마크 적용 (config에 경로가 있으면)
+            const wmPath = app.config.get('bridge.upload.watermark');
+            if (wmPath) {
+                const wmOpacity = app.config.get('bridge.upload.watermark_opacity', 50);
+                app.media.applyWatermark(sheetPath, wmPath, wmOpacity, 'jpeg', 90);
+                console.log(`[VideoPreview] 워터마크 적용 완료`);
+            }
+        }
+
+        console.log(`[VideoPreview] 완료: ${thumbs.length}장, sheet=${sheetPath}`);
+        return { count: thumbs.length, sheetPath };
+    }
+
+    async failed(data, error) {
+        console.error(`[VideoPreview] 최종 실패: ${error.message}`);
+    }
+}

package/cli/templates/app/shared/workers/heavy.js

@@ -0,0 +1,18 @@
+/** CPU-intensive 워커 스크립트 */
+import { parentPort, workerData } from 'worker_threads';
+
+function heavyCompute(n) {
+    let result = 0;
+    for (let i = 0; i < n; i++) {
+        result += Math.sqrt(i) * Math.sin(i);
+    }
+    return result;
+}
+
+const result = heavyCompute(workerData?.iterations || 1_000_000);
+
+parentPort?.postMessage({
+    result,
+    iterations: workerData?.iterations || 1_000_000,
+    pid: process.pid,
+});