mega-framework 0.1.6 → 0.1.8

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 {

package/sample/crud/apps/main/locales/server/en.json

@@ -313,5 +313,16 @@
   "csrf": {
     "invalid_token": "Invalid csrf token",
     "missing_secret": "Missing csrf secret"
-  }
+  },
+  "field_username": "아이디",
+  "field_username_ph": "예: hong123",
+  "field_username_required": "아이디를 입력하세요.",
+  "field_nickname": "별명",
+  "field_nickname_ph": "예: 길동이",
+  "field_nickname_required": "별명을 입력하세요.",
+  "optional": "선택",
+  "field_phone": "전화번호",
+  "field_phone_ph": "예: 010-1234-5678",
+  "col_username": "아이디",
+  "col_nickname": "별명"
 }

package/sample/crud/apps/main/locales/server/ko.json

@@ -313,5 +313,16 @@
   },
   "guide": {
     "not_found": "가이드를 찾을 수 없습니다."
-  }
+  },
+  "field_username": "아이디",
+  "field_username_ph": "예: hong123",
+  "field_username_required": "아이디를 입력하세요.",
+  "field_nickname": "별명",
+  "field_nickname_ph": "예: 길동이",
+  "field_nickname_required": "별명을 입력하세요.",
+  "optional": "선택",
+  "field_phone": "전화번호",
+  "field_phone_ph": "예: 010-1234-5678",
+  "col_username": "아이디",
+  "col_nickname": "별명"
 }

package/sample/crud/apps/main/migrations/20260606000001-create-users.js

@@ -1,27 +1,105 @@
 // @ts-check
 /**
- * 마이그레이션 create-users (20260606000001). up = users 테이블 생성, down = 제거(ADR-149).
- * `mega migrate`(up)·`mega migrate:down`·`mega migrate:status` 로 실행. 적용 이력은 대상 DB 의
- * `mega_migrations` 테이블이 추적하며, 각 마이그레이션은 트랜잭션으로 감싸 적용된다.
+ * 마이그레이션 create-users (20260612092543) — `mega migrate:generate` 자동 생성 (ADR-204).
+ * 기준 스냅샷: .mega/journal/history/20260612092543-create-users.json
+ * 적용 전 SQL 검토 필수 — 파괴적 변경(-- 경고)·캐스트(-- TODO) 주석이 있으면 직접 확정하세요.
+ * 적용은 `mega migrate`(락·checksum 은 러너 관리, ADR-149/190), 롤백은 `mega migrate:down`.
  *
  * @param {{ query: (sql: string, params?: any[]) => Promise<any> }} db - 대상 DB 어댑터(트랜잭션 내 query).
  * @returns {Promise<void>}
  */
 export async function up(db) {
-  await db.query(`
-    CREATE TABLE IF NOT EXISTS users (
-      id         SERIAL PRIMARY KEY,
-      name       TEXT NOT NULL,
-      email      TEXT NOT NULL UNIQUE,
-      created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-    )
-  `)
+  await db.query(`CREATE TABLE user_levels (
+  id SERIAL PRIMARY KEY,
+  code TEXT NOT NULL,
+  type_code TEXT NOT NULL,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  name TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+)`)
+  await db.query(`COMMENT ON TABLE user_levels IS '회원 등급 테이블'`)
+  await db.query(`ALTER TABLE user_levels ADD CONSTRAINT uniq_user_levels_code UNIQUE (code)`)
+  await db.query(`COMMENT ON COLUMN user_levels.code IS '회원 등급 코드'`)
+  await db.query(`COMMENT ON COLUMN user_levels.type_code IS '회원 유형 코드'`)
+  await db.query(`COMMENT ON COLUMN user_levels.sort_order IS '정렬 순서'`)
+  await db.query(`COMMENT ON COLUMN user_levels.name IS '회원 등급명'`)
+  await db.query(`COMMENT ON COLUMN user_levels.created_at IS '생성 시간'`)
+  await db.query(`CREATE TABLE users (
+  id BIGSERIAL PRIMARY KEY,
+  uuid UUID NOT NULL DEFAULT gen_random_uuid(),
+  username TEXT NOT NULL,
+  password_hash TEXT NOT NULL,
+  type_code TEXT NOT NULL DEFAULT 'USER',
+  level_code TEXT NOT NULL DEFAULT 'lv1',
+  name TEXT NOT NULL,
+  nickname TEXT NOT NULL,
+  email TEXT,
+  phone_number TEXT,
+  last_login_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+)`)
+  await db.query(`COMMENT ON TABLE users IS '회원 테이블'`)
+  await db.query(`COMMENT ON COLUMN users.uuid IS '고유값'`)
+  await db.query(`ALTER TABLE users ADD CONSTRAINT uniq_users_username UNIQUE (username)`)
+  await db.query(`COMMENT ON COLUMN users.username IS '로그인 아이디'`)
+  await db.query(`COMMENT ON COLUMN users.password_hash IS '비밀번호 해시'`)
+  await db.query(`COMMENT ON COLUMN users.type_code IS '회원 유형'`)
+  await db.query(`COMMENT ON COLUMN users.level_code IS '회원 등급'`)
+  await db.query(`COMMENT ON COLUMN users.name IS '실명'`)
+  await db.query(`ALTER TABLE users ADD CONSTRAINT uniq_users_nickname UNIQUE (nickname)`)
+  await db.query(`COMMENT ON COLUMN users.nickname IS '별명'`)
+  await db.query(`COMMENT ON COLUMN users.email IS '이메일'`)
+  await db.query(`COMMENT ON COLUMN users.phone_number IS '전화번호'`)
+  await db.query(`COMMENT ON COLUMN users.last_login_at IS '마지막 로그인 시간'`)
+  await db.query(`COMMENT ON COLUMN users.created_at IS '생성 시간'`)
+  await db.query(`CREATE TABLE user_types (
+  id SERIAL PRIMARY KEY,
+  code TEXT NOT NULL,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  name TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+)`)
+  await db.query(`COMMENT ON TABLE user_types IS '회원 유형 테이블'`)
+  await db.query(`ALTER TABLE user_types ADD CONSTRAINT uniq_user_types_code UNIQUE (code)`)
+  await db.query(`COMMENT ON COLUMN user_types.code IS '회원 유형 코드'`)
+  await db.query(`COMMENT ON COLUMN user_types.sort_order IS '정렬 순서'`)
+  await db.query(`COMMENT ON COLUMN user_types.name IS '회원 유형명'`)
+  await db.query(`COMMENT ON COLUMN user_types.created_at IS '생성 시간'`)
+  await db.query(`CREATE TABLE wallets (
+  id SERIAL PRIMARY KEY,
+  user_id BIGINT NOT NULL,
+  balance NUMERIC(20, 4) NOT NULL DEFAULT 0,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+)`)
+  await db.query(`COMMENT ON TABLE wallets IS '회원 지갑 테이블'`)
+  await db.query(`COMMENT ON COLUMN wallets.user_id IS '회원 ID'`)
+  await db.query(`COMMENT ON COLUMN wallets.balance IS '잔액'`)
+  await db.query(`COMMENT ON COLUMN wallets.created_at IS '생성 시간'`)
+  await db.query(`ALTER TABLE user_levels ADD CONSTRAINT fk_user_levels_type_code_user_types FOREIGN KEY (type_code) REFERENCES user_types (code) ON DELETE CASCADE`)
+  await db.query(`ALTER TABLE wallets ADD CONSTRAINT fk_wallets_user_id_users FOREIGN KEY (user_id) REFERENCES users (id) ON DELETE CASCADE`)
+  await db.query(`CREATE INDEX idx_user_levels_type_code ON user_levels (type_code)`)
+  await db.query(`CREATE UNIQUE INDEX idx_users_uuid ON users (uuid)`)
+  await db.query(`CREATE INDEX idx_users_email ON users (email)`)
+  await db.query(`CREATE INDEX idx_users_type_code ON users (type_code)`)
+  await db.query(`CREATE INDEX idx_users_level_code ON users (level_code)`)
+  await db.query(`CREATE INDEX idx_wallets_user_id ON wallets (user_id)`)
 }
 
 /**
- * @param {{ query: (sql: string, params?: any[]) => Promise<any> }} db
+ * @param {{ query: (sql: string, params?: any[]) => Promise<any> }} db - 대상 DB 어댑터(트랜잭션 내 query).
  * @returns {Promise<void>}
  */
 export async function down(db) {
-  await db.query('DROP TABLE IF EXISTS users')
+  await db.query(`DROP INDEX IF EXISTS idx_wallets_user_id`)
+  await db.query(`DROP INDEX IF EXISTS idx_users_level_code`)
+  await db.query(`DROP INDEX IF EXISTS idx_users_type_code`)
+  await db.query(`DROP INDEX IF EXISTS idx_users_email`)
+  await db.query(`DROP INDEX IF EXISTS idx_users_uuid`)
+  await db.query(`DROP INDEX IF EXISTS idx_user_levels_type_code`)
+  await db.query(`ALTER TABLE wallets DROP CONSTRAINT fk_wallets_user_id_users`)
+  await db.query(`ALTER TABLE user_levels DROP CONSTRAINT fk_user_levels_type_code_user_types`)
+  await db.query(`DROP TABLE IF EXISTS wallets`)
+  await db.query(`DROP TABLE IF EXISTS user_types`)
+  await db.query(`DROP TABLE IF EXISTS users`)
+  await db.query(`DROP TABLE IF EXISTS user_levels`)
 }