create-entity-app-server 0.0.3

package/src/app/routes/password-reset/routes.ts

@@ -0,0 +1,84 @@
+/**
+ * 비밀번호 재설정 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/password-reset/routes.ts`를 탐색하여
+ * prefix `/api/v1/password-reset` 으로 등록한다.
+ *
+ * 엔드포인트:
+ *   POST /request           — 비밀번호 재설정 요청 (회원)
+ *   GET  /validate/:token   — 토큰 유효성 확인 (link 모드 전용)
+ *   POST /verify            — 토큰 검증 + 새 비밀번호 설정 (link 모드 전용)
+ */
+
+import type { FastifyInstance } from "fastify";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger } from "@gateway/api";
+import { ensurePluginEntities } from "@gateway/api";
+import type { PasswordResetConfig } from "./types/index.ts";
+import {
+    createRequestHandler,
+    createValidateHandler,
+    createVerifyHandler,
+} from "./handlers.ts";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export const suppressRouteRegisterLog = true;
+
+/** config.json 로드 + 기본값 보정 */
+function loadConfig(): PasswordResetConfig {
+    const configPath = resolve(__dirname, "config.json");
+    let raw: Record<string, unknown> = {};
+    if (existsSync(configPath)) {
+        const text = readFileSync(configPath, "utf-8").replace(
+            /\$\{([^}]+)\}/g,
+            (_m, name) => process.env[name] ?? "",
+        );
+        raw = JSON.parse(text) as Record<string, unknown>;
+    }
+
+    const rl = (raw.rate_limit ?? {}) as Record<string, unknown>;
+
+    return {
+        enabled: raw.enabled !== false,
+        mode: (raw.mode as PasswordResetConfig["mode"]) ?? "temp_password",
+        temp_password_ttl_sec: Number(raw.temp_password_ttl_sec) || 300,
+        temp_password_length: Number(raw.temp_password_length) || 12,
+        link_base_url: String(raw.link_base_url ?? ""),
+        link_token_ttl_sec: Number(raw.link_token_ttl_sec) || 300,
+        rate_limit: {
+            per_email_per_hour: Number(rl.per_email_per_hour) || 5,
+            per_ip_per_minute: Number(rl.per_ip_per_minute) || 10,
+        },
+        email_subject: String(raw.email_subject ?? "비밀번호 재설정"),
+    };
+}
+
+export default async function passwordResetRoutes(
+    app: FastifyInstance,
+): Promise<void> {
+    const cfg = loadConfig();
+
+    if (!cfg.enabled) {
+        return;
+    }
+
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "password-reset: ensureEntities failed"),
+    );
+
+    const handleRequest = createRequestHandler(cfg);
+    const handleValidate = createValidateHandler(cfg);
+    const handleVerify = createVerifyHandler(cfg);
+
+    // POST /request — 비밀번호 재설정 요청
+    app.post("/request", handleRequest);
+
+    // GET /validate/:token — 토큰 유효성 확인 (link 모드 전용)
+    app.get("/validate/:token", handleValidate);
+
+    // POST /verify — 토큰 검증 + 새 비밀번호 설정 (link 모드 전용)
+    app.post("/verify", handleVerify);
+}

package/src/app/routes/password-reset/templates/password_reset.html

@@ -0,0 +1,21 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">임시 비밀번호 안내</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    비밀번호 재설정이 요청되었습니다. 아래 임시 비밀번호로 로그인 후 즉시 비밀번호를 변경하세요.
+</p>
+<div style="text-align: center; margin: 0 0 28px;">
+    <div style="display: inline-block; padding: 14px 32px; background-color: #f4f4f7; border-radius: 8px; border: 1px solid #e0e0e0;">
+        <span style="font-size: 22px; font-weight: 700; letter-spacing: 4px; color: #1a1a2e; font-family: 'Courier New', Courier, monospace;">${temp_password|}</span>
+    </div>
+</div>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 임시 비밀번호는 <strong>${expires_in|5분}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이메일: <strong>${email|}</strong>
+</p>
+<p style="margin: 0 0 16px; font-size: 14px; color: #d9534f; font-weight: 600; line-height: 1.6;">
+    ⚠ 보안을 위해 로그인 즉시 비밀번호를 변경하시기 바랍니다.
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 이 이메일을 무시하세요. 기존 비밀번호는 변경되지 않습니다.
+</p>

package/src/app/routes/password-reset/templates/password_reset_link.html

@@ -0,0 +1,19 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">비밀번호 재설정</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    비밀번호 재설정이 요청되었습니다. 아래 버튼을 클릭하여 새 비밀번호를 설정하세요.
+</p>
+<div style="text-align: center; margin: 0 0 24px;">
+    <a href="${reset_url|#}" style="display: inline-block; padding: 14px 36px; background-color: #1a1a2e; color: #ffffff; text-decoration: none; border-radius: 6px; font-size: 15px; font-weight: 600;">비밀번호 재설정</a>
+</div>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    버튼이 작동하지 않으면 아래 링크를 브라우저에 붙여넣으세요:
+</p>
+<p style="margin: 0 0 16px; font-size: 13px; color: #4a90d9; word-break: break-all; line-height: 1.6;">
+    ${reset_url|#}
+</p>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 링크는 <strong>${expires_in|5분}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 이 이메일을 무시하세요. 비밀번호는 변경되지 않습니다.
+</p>

package/src/app/routes/password-reset/types/index.ts

@@ -0,0 +1,95 @@
+/**
+ * 비밀번호 재설정 — 요청/응답 타입 정의
+ */
+
+/* ──────────── 설정 ──────────── */
+
+export interface PasswordResetRateLimitConfig {
+    /** 동일 이메일 시간당 최대 요청 수 (기본 5) */
+    per_email_per_hour: number;
+    /** 동일 IP 분당 최대 요청 수 (기본 10) */
+    per_ip_per_minute: number;
+}
+
+export interface PasswordResetConfig {
+    /** 기능 활성화 여부 */
+    enabled: boolean;
+    /**
+     * 재설정 모드
+     * - `"temp_password"`: 임시 비밀번호 발급 → 이메일 발송 (기본값, Go 호환)
+     * - `"link"`: 토큰 기반 리셋 링크 → 이메일 발송 → 새 비밀번호 설정
+     */
+    mode: "temp_password" | "link";
+    /** 임시 비밀번호 유효 시간(초), 기본 300 (5분) — temp_password 모드 전용 */
+    temp_password_ttl_sec: number;
+    /** 임시 비밀번호 길이, 기본 12 — temp_password 모드 전용 */
+    temp_password_length: number;
+    /** 리셋 링크 기본 URL (예: https://myapp.com/reset-password) — link 모드 전용 */
+    link_base_url: string;
+    /** 토큰 유효 시간(초), 기본 300 (5분) — link 모드 전용 */
+    link_token_ttl_sec: number;
+    /** Rate limit 설정 */
+    rate_limit: PasswordResetRateLimitConfig;
+    /** 이메일 제목 */
+    email_subject: string;
+    /** 빌드 시 dist에 포함 여부 (기본: true, false면 배포에서 제외) */
+    deploy?: boolean;
+    /** 빌드 시 난독화 여부 */
+    minify?: boolean;
+}
+
+/* ──────────── 요청 ──────────── */
+
+export interface PasswordResetRequestBody {
+    email: string;
+}
+
+export interface PasswordResetVerifyBody {
+    token: string;
+    new_password: string;
+}
+
+export interface PasswordResetValidateParams {
+    token: string;
+}
+
+/* ──────────── 응답 ──────────── */
+
+export interface PasswordResetSuccessResponse {
+    ok: boolean;
+    message: string;
+}
+
+export interface PasswordResetValidateResponse {
+    ok: boolean;
+    valid: boolean;
+    expires_in_sec?: number;
+}
+
+/* ──────────── Account 엔티티 필드 ──────────── */
+
+export interface AccountResetFields {
+    seq: number;
+    email?: string;
+    /** SHA-256+salt 해시 (Go 호환: "hex_hash.hex_salt") — temp_password 모드 */
+    temp_password_hash?: string | null;
+    /** 임시 비밀번호 발급 시각 (ISO 8601) — temp_password 모드 */
+    temp_password_issued_time?: string | null;
+    /** SHA-256(token) 해시 — link 모드 */
+    password_reset_token?: string | null;
+    /** 토큰 만료 시각 (ISO 8601) — link 모드 */
+    password_reset_expires?: string | null;
+    /** 비밀번호 해시 */
+    passwd?: string;
+    /** 비밀번호 변경 시각 */
+    passwd_changed_time?: string;
+    /** 비밀번호 강제 변경 플래그 */
+    force_password_change?: boolean;
+}
+
+/* ──────────── Rate Limit 내부 ──────────── */
+
+export interface RateLimitEntry {
+    count: number;
+    resetAt: number;
+}

package/src/app/routes/privilege/config.json

@@ -0,0 +1,5 @@
+{
+    "enabled": true,
+    "deploy": true,
+    "minify": false
+}

package/src/app/routes/privilege/entities/pv_group.json

@@ -0,0 +1,29 @@
+{
+    "name": "pv_group",
+    "description": "권한그룹. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "fields": {
+        "name": {
+            "index": true,
+            "comment": "그룹명",
+            "unique": true
+        },
+        "description": {
+            "comment": "설명"
+        }
+    },
+    "reset_defaults": [
+        {
+            "name": "관리자",
+            "description": "전체 관리 권한"
+        },
+        {
+            "name": "인사담당자",
+            "description": "인사 관리 권한"
+        },
+        {
+            "name": "일반사용자",
+            "description": "기본 사용자 권한"
+        }
+    ]
+}

package/src/app/routes/privilege/entities/pv_group_item.json

@@ -0,0 +1,31 @@
+{
+    "name": "pv_group_item",
+    "description": "pv_group_item 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "group_seq": {
+            "index": true,
+            "comment": "그룹seq"
+        },
+        "item_seq": {
+            "index": true,
+            "comment": "권한seq"
+        }
+    },
+    "unique": [
+        [
+            "group_seq",
+            "item_seq"
+        ]
+    ],
+    "reset_defaults": [
+        {
+            "group_name": "관리자",
+            "item_name": "모든 권한"
+        },
+        {
+            "group_name": "인사담당자",
+            "item_name": "인사관리"
+        }
+    ],
+    "license_scope": false
+}

package/src/app/routes/privilege/entities/pv_item.json

@@ -0,0 +1,176 @@
+{
+    "name": "pv_item",
+    "description": "권한항목. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "parent_seq": {
+            "index": true,
+            "comment": "부모seq"
+        },
+        "name": {
+            "index": true,
+            "comment": "권한명",
+            "unique": true
+        },
+        "remark": {
+            "comment": "설명"
+        }
+    },
+    "reset_defaults": [
+        {
+            "name": "모든 권한",
+            "readonly": true,
+            "remark": "최상위 권한"
+        },
+        {
+            "parent_name": "모든 권한",
+            "name": "시스템 설정",
+            "readonly": true
+        },
+        {
+            "parent_name": "모든 권한",
+            "name": "계정관리",
+            "readonly": true
+        },
+        {
+            "parent_name": "계정관리",
+            "name": "계정목록조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "계정관리",
+            "name": "계정정보조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "계정관리",
+            "name": "계정권한관리",
+            "readonly": true
+        },
+        {
+            "parent_name": "계정관리",
+            "name": "계정등록수정",
+            "readonly": true
+        },
+        {
+            "parent_name": "모든 권한",
+            "name": "인사관리",
+            "readonly": true
+        },
+        {
+            "parent_name": "인사관리",
+            "name": "직원목록조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "인사관리",
+            "name": "직원정보조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원기본정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원개인정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원학력경력정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원가족정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원근로계약정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원차량정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "직원정보조회",
+            "name": "직원보험세금정보",
+            "readonly": true
+        },
+        {
+            "parent_name": "인사관리",
+            "name": "직원등록수정",
+            "readonly": true
+        },
+        {
+            "parent_name": "인사관리",
+            "name": "경력관리",
+            "readonly": true
+        },
+        {
+            "parent_name": "경력관리",
+            "name": "경력목록조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "경력관리",
+            "name": "경력정보조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "경력관리",
+            "name": "경력등록수정",
+            "readonly": true
+        },
+        {
+            "parent_name": "인사관리",
+            "name": "교육관리",
+            "readonly": true
+        },
+        {
+            "parent_name": "교육관리",
+            "name": "교육목록조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "교육관리",
+            "name": "교육정보조회",
+            "readonly": true
+        },
+        {
+            "parent_name": "교육관리",
+            "name": "교육등록수정",
+            "readonly": true
+        },
+        {
+            "parent_name": "모든 권한",
+            "name": "엑셀다운로드",
+            "readonly": true
+        },
+        {
+            "parent_name": "엑셀다운로드",
+            "name": "직원목록엑셀다운",
+            "readonly": true
+        },
+        {
+            "parent_name": "엑셀다운로드",
+            "name": "경력목록엑셀다운",
+            "readonly": true
+        },
+        {
+            "parent_name": "엑셀다운로드",
+            "name": "교육목록엑셀다운",
+            "readonly": true
+        },
+        {
+            "parent_name": "엑셀다운로드",
+            "name": "로그인기록엑셀다운",
+            "readonly": true
+        }
+    ],
+    "license_scope": false
+}

package/src/app/routes/privilege/entities/user_pv_group.json

@@ -0,0 +1,20 @@
+{
+    "name": "user_pv_group",
+    "description": "user_pv_group 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "user_seq": {
+            "index": true,
+            "comment": "사용자seq"
+        },
+        "pv_group_seq": {
+            "index": true,
+            "comment": "권한그룹seq"
+        }
+    },
+    "unique": [
+        [
+            "user_seq",
+            "pv_group_seq"
+        ]
+    ]
+}

package/src/app/routes/privilege/entities/user_pv_item.json

@@ -0,0 +1,20 @@
+{
+    "name": "user_pv_item",
+    "description": "user_pv_item 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "user_seq": {
+            "index": true,
+            "comment": "사용자seq"
+        },
+        "pv_item_seq": {
+            "index": true,
+            "comment": "권한seq"
+        }
+    },
+    "unique": [
+        [
+            "user_seq",
+            "pv_item_seq"
+        ]
+    ]
+}

package/src/app/routes/privilege/routes.ts

@@ -0,0 +1,33 @@
+/**
+ * Privilege 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/privilege/routes.ts`를 탐색하여
+ * prefix `/api/v1/privilege` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - pv_group       — 권한 그룹
+ *   - pv_group_item  — 권한 그룹 항목
+ *   - pv_item        — 권한 항목
+ *   - user_pv_group  — 사용자-권한그룹 매핑
+ *   - user_pv_item   — 사용자-권한항목 매핑
+ *
+ * 비고: go 서버는 rbac_roles(RBAC) 만 담당하며, 비즈니스 권한(Privilege)은 앱서버에서 관리합니다.
+ */
+
+import type { FastifyInstance } from "fastify";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger, ensurePluginEntities } from "@gateway/api";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default async function privilegeRoutes(
+    app: FastifyInstance,
+): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "privilege: ensureEntities failed"),
+    );
+
+    // TODO: 권한 조회·할당 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/user/config.json

@@ -0,0 +1,5 @@
+{
+    "enabled": true,
+    "deploy": true,
+    "minify": false
+}

package/src/app/routes/user/entities/user.json

@@ -0,0 +1,64 @@
+{
+    "name": "user",
+    "description": "사용자 프로필 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "email": {
+            "index": true,
+            "hash": true,
+            "comment": "사용자 이메일",
+            "type": "email",
+            "required": true,
+            "unique": true
+        },
+        "name": {
+            "index": true,
+            "comment": "이름"
+        },
+        "nickname": {
+            "index": true,
+            "comment": "닉네임"
+        },
+        "phone": {
+            "index": true,
+            "comment": "전화번호",
+            "type": "phone",
+            "hash": true
+        },
+        "department": {
+            "index": true,
+            "comment": "부서"
+        },
+        "position": {
+            "index": true,
+            "comment": "직책"
+        },
+        "status": {
+            "index": true,
+            "comment": "사용자 상태",
+            "type": [
+                "active",
+                "inactive",
+                "retired"
+            ],
+            "default": "active"
+        },
+        "profile_image": {
+            "comment": "프로필 이미지 URL (소셜 로그인 초기 동기화)"
+        }
+    },
+    "hooks": {
+        "after_insert": [
+            {
+                "type": "submit",
+                "entity": "account",
+                "match": {
+                    "email": "${new.email}"
+                },
+                "data": {
+                    "email": "${new.email}",
+                    "user_seq": "${new.seq}"
+                }
+            }
+        ]
+    }
+}

package/src/app/routes/user/entities/user_biometric.json

@@ -0,0 +1,28 @@
+{
+    "name": "user_biometric",
+    "description": "user_biometric 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "bio_id": {
+            "index": true,
+            "comment": "생체인증ID",
+            "unique": true
+        },
+        "device_id": {
+            "index": true,
+            "comment": "기기ID"
+        },
+        "user_seq": {
+            "index": true,
+            "comment": "사용자seq"
+        },
+        "public_key": {
+            "comment": "공개키"
+        }
+    },
+    "unique": [
+        [
+            "device_id",
+            "user_seq"
+        ]
+    ]
+}

package/src/app/routes/user/routes.ts

@@ -0,0 +1,27 @@
+/**
+ * User 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/user/routes.ts`를 탐색하여
+ * prefix `/api/v1/user` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - user          — 회원 프로필 정보
+ *   - user_biometric — 생체인증 정보
+ *   - account-ext   — account 엔티티 after_get 훅 확장 (hook-merge 지원 시 자동 병합)
+ */
+
+import type { FastifyInstance } from "fastify";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger, ensurePluginEntities } from "@gateway/api";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default async function userRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "user: ensureEntities failed"),
+    );
+
+    // TODO: GET /profile, PUT /profile 등 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/vessel-tracking/config.json

@@ -0,0 +1,3 @@
+{
+    "enabled": true
+}