mega-framework 0.1.5 → 0.1.7

package/sample/crud/.mega/journal/history/20260612092543-create-users.json

@@ -0,0 +1,261 @@
+{
+  "version": 1,
+  "generatedAt": "2026-06-12T09:25:43.484Z",
+  "adapters": {
+    "primary": {
+      "driver": "postgres",
+      "models": [
+        {
+          "name": "UserLevelModel",
+          "table": "user_levels",
+          "record": {
+            "table": "user_levels",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 등급 코드"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "references": {
+                  "model": "UserTypeModel",
+                  "column": "code",
+                  "onDelete": "cascade",
+                  "table": "user_types"
+                },
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 등급명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_user_levels_type_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserModel",
+          "table": "users",
+          "record": {
+            "table": "users",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "bigSerial",
+                "primary": true
+              },
+              "uuid": {
+                "type": "uuid",
+                "notNull": true,
+                "default": {
+                  "raw": "gen_random_uuid()"
+                },
+                "comment": "고유값"
+              },
+              "username": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "로그인 아이디"
+              },
+              "password_hash": {
+                "type": "text",
+                "notNull": true,
+                "comment": "비밀번호 해시"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "USER",
+                "comment": "회원 유형"
+              },
+              "level_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "lv1",
+                "comment": "회원 등급"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "실명"
+              },
+              "nickname": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "별명"
+              },
+              "email": {
+                "type": "text",
+                "comment": "이메일"
+              },
+              "phone_number": {
+                "type": "text",
+                "comment": "전화번호"
+              },
+              "last_login_at": {
+                "type": "timestamptz",
+                "comment": "마지막 로그인 시간"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "uuid"
+                ],
+                "name": "idx_users_uuid",
+                "unique": true
+              },
+              {
+                "columns": [
+                  "email"
+                ],
+                "name": "idx_users_email"
+              },
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_users_type_code"
+              },
+              {
+                "columns": [
+                  "level_code"
+                ],
+                "name": "idx_users_level_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserTypeModel",
+          "table": "user_types",
+          "record": {
+            "table": "user_types",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 유형명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": []
+          }
+        },
+        {
+          "name": "WalletModel",
+          "table": "wallets",
+          "record": {
+            "table": "wallets",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "user_id": {
+                "type": "bigInteger",
+                "notNull": true,
+                "references": {
+                  "model": "UserModel",
+                  "column": "id",
+                  "onDelete": "cascade",
+                  "table": "users"
+                },
+                "comment": "회원 ID"
+              },
+              "balance": {
+                "type": "decimal",
+                "precision": 20,
+                "scale": 4,
+                "notNull": true,
+                "default": 0,
+                "comment": "잔액"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "user_id"
+                ],
+                "name": "idx_wallets_user_id"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}

package/sample/crud/.mega/journal/snapshot.json

@@ -0,0 +1,261 @@
+{
+  "version": 1,
+  "generatedAt": "2026-06-12T09:25:43.485Z",
+  "adapters": {
+    "primary": {
+      "driver": "postgres",
+      "models": [
+        {
+          "name": "UserLevelModel",
+          "table": "user_levels",
+          "record": {
+            "table": "user_levels",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 등급 코드"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "references": {
+                  "model": "UserTypeModel",
+                  "column": "code",
+                  "onDelete": "cascade",
+                  "table": "user_types"
+                },
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 등급명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_user_levels_type_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserModel",
+          "table": "users",
+          "record": {
+            "table": "users",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "bigSerial",
+                "primary": true
+              },
+              "uuid": {
+                "type": "uuid",
+                "notNull": true,
+                "default": {
+                  "raw": "gen_random_uuid()"
+                },
+                "comment": "고유값"
+              },
+              "username": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "로그인 아이디"
+              },
+              "password_hash": {
+                "type": "text",
+                "notNull": true,
+                "comment": "비밀번호 해시"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "USER",
+                "comment": "회원 유형"
+              },
+              "level_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "lv1",
+                "comment": "회원 등급"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "실명"
+              },
+              "nickname": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "별명"
+              },
+              "email": {
+                "type": "text",
+                "comment": "이메일"
+              },
+              "phone_number": {
+                "type": "text",
+                "comment": "전화번호"
+              },
+              "last_login_at": {
+                "type": "timestamptz",
+                "comment": "마지막 로그인 시간"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "uuid"
+                ],
+                "name": "idx_users_uuid",
+                "unique": true
+              },
+              {
+                "columns": [
+                  "email"
+                ],
+                "name": "idx_users_email"
+              },
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_users_type_code"
+              },
+              {
+                "columns": [
+                  "level_code"
+                ],
+                "name": "idx_users_level_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserTypeModel",
+          "table": "user_types",
+          "record": {
+            "table": "user_types",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 유형명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": []
+          }
+        },
+        {
+          "name": "WalletModel",
+          "table": "wallets",
+          "record": {
+            "table": "wallets",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "user_id": {
+                "type": "bigInteger",
+                "notNull": true,
+                "references": {
+                  "model": "UserModel",
+                  "column": "id",
+                  "onDelete": "cascade",
+                  "table": "users"
+                },
+                "comment": "회원 ID"
+              },
+              "balance": {
+                "type": "decimal",
+                "precision": 20,
+                "scale": 4,
+                "notNull": true,
+                "default": 0,
+                "comment": "잔액"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "user_id"
+                ],
+                "name": "idx_wallets_user_id"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}

package/sample/crud/apps/main/controllers/auth-controller.js

@@ -45,22 +45,22 @@ export class AuthController {
 
   /** POST /auth/login — 인증 → 세션 생성 → 관리 UI. 잠김/실패 시 폼 재렌더. @param {any} req @param {any} reply @param {any} ctx */
   static async login(req, reply, ctx) {
-    const email = typeof req.body?.email === 'string' ? req.body.email.trim().toLowerCase() : ''
+    const username = typeof req.body?.username === 'string' ? req.body.username.trim() : ''
     const password = typeof req.body?.password === 'string' ? req.body.password : ''
-    // subject = IP:email — email 단독 잠금은 피해자 계정을 공격자가 잠그는 DoS 가 가능(I-1).
-    const subject = `${req.ip}:${email}`
+    // subject = IP:username — username 단독 잠금은 피해자 계정을 공격자가 잠그는 DoS 가 가능(I-1).
+    const subject = `${req.ip}:${username}`
     const bf = ctx.bruteForce
 
     const status = await bf.check(subject)
     if (status.isLocked) {
-      return AuthController.#renderLogin(reply, ctx, { email }, ctx.t('login_locked', '로그인 시도가 너무 많습니다. 잠시 후 다시 시도하세요.'), 423)
+      return AuthController.#renderLogin(reply, ctx, { username }, ctx.t('login_locked', '로그인 시도가 너무 많습니다. 잠시 후 다시 시도하세요.'), 423)
     }
 
-    const user = await ctx.services.auth.authenticate({ email, password })
+    const user = await ctx.services.auth.authenticate({ username, password })
     if (!user) {
       const after = await bf.fail(subject)
-      const msg = after.isLocked ? ctx.t('login_locked', '로그인 시도가 너무 많습니다. 잠시 후 다시 시도하세요.') : ctx.t('login_failed', '이메일 또는 비밀번호가 올바르지 않습니다.')
-      return AuthController.#renderLogin(reply, ctx, { email }, msg, after.isLocked ? 423 : 401)
+      const msg = after.isLocked ? ctx.t('login_locked', '로그인 시도가 너무 많습니다. 잠시 후 다시 시도하세요.') : ctx.t('login_failed', '아이디 또는 비밀번호가 올바르지 않습니다.')
+      return AuthController.#renderLogin(reply, ctx, { username }, msg, after.isLocked ? 423 : 401)
     }
 
     await bf.reset(subject)
@@ -99,7 +99,13 @@ export class AuthController {
         reply.code(err instanceof MegaConflictError ? 409 : 400)
         return ctx.render('auth/register', {
           title: ctx.t('register_title', '회원가입'),
-          values: { name: req.body?.name ?? '', email: req.body?.email ?? '' },
+          values: {
+            username: req.body?.username ?? '',
+            name: req.body?.name ?? '',
+            nickname: req.body?.nickname ?? '',
+            email: req.body?.email ?? '',
+            phone_number: req.body?.phone_number ?? '',
+          },
           invalid: AuthController.#invalidFields(err),
           error: err.message,
           currentUser: null,
@@ -112,7 +118,7 @@ export class AuthController {
 
   /**
    * 로그인 폼 재렌더 헬퍼(상태코드 + 에러 메시지 + 입력 보존 + 새 CSRF 토큰).
-   * @param {any} reply @param {any} ctx @param {{ email: string }} values @param {string} error @param {number} code
+   * @param {any} reply @param {any} ctx @param {{ username: string }} values @param {string} error @param {number} code
    */
   static #renderLogin(reply, ctx, values, error, code) {
     reply.code(code)
@@ -128,17 +134,19 @@ export class AuthController {
 
   /**
    * 회원가입 검증/충돌 에러 → 폼 is-invalid 표시용 필드 맵.
-   * @param {unknown} err @returns {{ name: boolean, email: boolean, password: boolean }}
+   * @param {unknown} err @returns {{ username: boolean, name: boolean, nickname: boolean, password: boolean }}
    */
   static #invalidFields(err) {
     if (err instanceof MegaValidationError) {
       const d = /** @type {any} */ (err).details ?? {}
-      // auth-service 는 details.{name,email,password} = "값이 유효한가"(true=정상) 로 준다 → 없으면 invalid.
-      return { name: !d.name, email: !d.email, password: !d.password }
+      // auth-service 는 details.{username,name,nickname,password} = "값이 유효한가"(true=정상) → 없으면 invalid.
+      return { username: !d.username, name: !d.name, nickname: !d.nickname, password: !d.password }
     }
     if (err instanceof MegaConflictError) {
-      return { name: false, email: true, password: false } // 이메일 중복.
+      // username/nickname 중복 — code 로 구분(user.nickname_taken vs user.username_taken).
+      const isNick = /** @type {any} */ (err).code === 'user.nickname_taken'
+      return { username: !isNick, name: false, nickname: isNick, password: false }
     }
-    return { name: false, email: false, password: false }
+    return { username: false, name: false, nickname: false, password: false }
   }
 }

package/sample/crud/apps/main/controllers/web-controller.js

@@ -19,18 +19,20 @@ const NOTICE_KEYS = new Set(['created', 'updated', 'deleted'])
 /**
  * 검증/충돌 에러에서 어떤 필드가 잘못됐는지 계산한다(폼 is-invalid 표시용).
  * @param {unknown} err
- * @returns {{ name: boolean, email: boolean }}
+ * @returns {{ username: boolean, name: boolean, nickname: boolean, password: boolean }}
  */
 function invalidFields(err) {
   if (err instanceof MegaValidationError) {
     const d = /** @type {any} */ (err).details ?? {}
-    // user-service 는 details.{name,email} = "값이 있는가"(true=정상) 로 준다 → 없으면 invalid.
-    return { name: !d.name, email: !d.email }
+    // user-service 는 details.{username,name,nickname,password} = "값이 유효한가"(true=정상) → 없으면 invalid.
+    return { username: !d.username, name: !d.name, nickname: !d.nickname, password: !d.password }
   }
   if (err instanceof MegaConflictError) {
-    return { name: false, email: true } // 이메일 중복.
+    // username/nickname 중복 — code 로 구분.
+    const isNick = /** @type {any} */ (err).code === 'user.nickname_taken'
+    return { username: !isNick, name: false, nickname: isNick, password: false }
   }
-  return { name: false, email: false }
+  return { username: false, name: false, nickname: false, password: false }
 }
 
 export class WebController {