create-entity-app-server 0.0.3 → 0.0.4

package/src/app/plugins/ocr/types/store.ts

@@ -1,70 +0,0 @@
-import type { OcrResult } from "./driver.ts";
-
-export interface OcrResultRecord {
-    ocrId: string;
-    fileSeq?: number;
-    fileHash: string;
-    provider: string;
-    docType: string;
-    state: string; // pending/processing/completed/failed
-    refTable?: string;
-    refSeq?: number;
-    text?: string;
-    pages?: unknown;
-    parsed?: unknown;
-    confidence?: number;
-    processingMs?: number;
-    providerRaw?: unknown;
-    errorMessage?: string;
-    parseMethod?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-
-export interface OcrUsageRecord {
-    usageDate: string;
-    provider: string;
-    docType: string;
-    requestCount: number;
-    pageCount: number;
-    successCount?: number;
-    failCount?: number;
-    totalMs?: number;
-    avgConfidence?: number;
-}
-
-export interface OcrResultFilter {
-    provider?: string;
-    docType?: string;
-    state?: string;
-    fileSeq?: number;
-    refTable?: string;
-    refSeq?: number;
-    offset?: number;
-    limit?: number;
-}
-
-export interface OcrEntityStore {
-    createResult(record: OcrResultRecord): Promise<string>;
-    updateResultState(
-        id: string,
-        state: string,
-        result: OcrResult | null,
-        errMsg: string,
-    ): Promise<void>;
-    getResult(id: string): Promise<OcrResultRecord | null>;
-    listResults(
-        filter: OcrResultFilter,
-    ): Promise<{ items: OcrResultRecord[]; total: number }>;
-    deleteResult(id: string): Promise<void>;
-    incrementUsage(record: OcrUsageRecord): Promise<void>;
-    getDailyQuotaUsage(date: string): Promise<number>;
-    getMonthlyQuotaUsage(month: string): Promise<number>;
-}
-
-export interface QuotaStatus {
-    dailyUsed: number;
-    dailyLimit: number;
-    monthlyUsed: number;
-    monthlyLimit: number;
-}

package/src/app/plugins/ocr/types/template.ts

@@ -1,89 +0,0 @@
-import type { ParsedDocument } from "./parsed.ts";
-
-export interface Template {
-    docType: string;
-    label: string;
-    preprocess: PreprocessConfig;
-    keywords: Record<string, string[]>;
-    fields: Record<string, FieldConfig>;
-    requiredFields: string[];
-    confidenceWeight: Record<string, number>;
-}
-
-export interface FieldConfig {
-    outputKey: string;
-    mode?: string; // anchor(기본), region, regex_scan
-    criteria?: Criterion[];
-    region?: RegionConfig;
-    pattern?: string;
-    captureGroup?: number;
-    refine?: string;
-    required?: boolean;
-}
-
-export interface Criterion {
-    keyword: string;
-    direction: string;
-}
-
-export interface RegionConfig {
-    from: string;
-    to: string;
-    direction?: string;
-    xMinAnchor?: string;
-}
-
-export interface PreprocessConfig {
-    maxSlope: number;
-    slopeExceptions: string[];
-    yTolerance: number;
-    xTolerance: number;
-    removeKeywords: string[];
-    removePatterns: string[];
-    mergePatterns: string[];
-    keywords: Record<string, string[]>;
-}
-
-export interface ProcessedItem {
-    text: string;
-    isKeyword: boolean;
-    field: string;
-    centerX: number;
-    centerY: number;
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
-    width: number;
-    height: number;
-    slope: number;
-}
-
-export interface ProcessedPage {
-    keywordList: Record<string, ProcessedItem[]>;
-    valueList: ProcessedItem[];
-}
-
-export interface BaseItem {
-    item: ProcessedItem;
-    direction: string;
-}
-
-export interface MatchResult {
-    parsed?: ParsedDocument;
-    confidence: number;
-    missingRequired: string[];
-    extracted: Record<string, string>;
-}
-
-export interface LlmPromptTemplate {
-    docType: string;
-    systemMsg: string;
-    userMsg: string;
-    schema: unknown;
-}
-
-export interface RetryConfig {
-    maxRetries: number;
-    retryDelayMs: number;
-}

package/src/app/plugins/ocr/utils.ts

@@ -1,18 +0,0 @@
-/**
- * OCR 모듈 유틸리티
- */
-
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-
-/** CLI 도구 존재 여부 확인 */
-export async function which(cmd: string): Promise<boolean> {
-    try {
-        await execFileAsync("which", [cmd]);
-        return true;
-    } catch {
-        return false;
-    }
-}

package/src/app/plugins/pg/config.json

@@ -1,35 +0,0 @@
-{
-    "_comment": "결제(PG) 플러그인 — 토스페이먼츠·페이레터 등 결제 프로바이더 연동, 웹훅 처리 및 주문 관리 지원",
-    "enabled": false,
-    "default": "toss_payments",
-    "webhook_secret": "",
-    "order_id_prefix": "ORD",
-    "success_url": "/payment/success",
-    "fail_url": "/payment/fail",
-    "webhook_url": "/api/v1/pg/webhook",
-    "amount_limit": {
-        "min": 100,
-        "max": 10000000
-    },
-    "workers": 2,
-    "providers": {
-        "toss_payments": {
-            "driver": "toss_payments",
-            "_comment": "토스페이먼츠 V2",
-            "client_key": "${TOSS_CLIENT_KEY}",
-            "secret_key": "${TOSS_SECRET_KEY}",
-            "api_url": "https://api.tosspayments.com",
-            "api_version": "2024-06-01"
-        },
-        "payletter": {
-            "driver": "payletter",
-            "_comment": "페이레터 (Payletter) — Authorization: PLKEY {api_key}",
-            "client_id": "${PAYLETTER_CLIENT_ID}",
-            "api_key": "${PAYLETTER_API_KEY}",
-            "api_key_search": "${PAYLETTER_API_KEY_SEARCH}",
-            "api_url": "https://pgapi.payletter.com"
-        }
-    },
-    "deploy": true,
-    "minify": false
-}

package/src/app/plugins/push/config.json

@@ -1,18 +0,0 @@
-{
-    "_comment": "푸시 알림 플러그인 — FCM(Firebase Cloud Messaging) 기반 앱 푸시 발송, 큐·재시도·워커 설정 포함",
-    "enabled": false,
-    "default": "main",
-    "workers": 2,
-    "queue_size": 50,
-    "dispatch_interval_sec": 5,
-    "max_retries": 3,
-    "providers": {
-        "main": {
-            "driver": "fcm",
-            "project_id": "${FCM_PROJECT_ID}",
-            "key_file": "${FCM_KEY_FILE}"
-        }
-    },
-    "deploy": true,
-    "minify": false
-}

package/src/app/plugins/sms/config.json

@@ -1,33 +0,0 @@
-{
-    "_comment": "SMS 발송 플러그인 — 알리고 등 프로바이더 연동, 자동 LMS 전환·인증번호 발송·발송 제한 설정 포함",
-    "enabled": false,
-    "default": "aligo",
-    "sender": "${SMS_SENDER_NUMBER}",
-    "workers": 2,
-    "queue_size": 200,
-    "dispatch_interval_sec": 5,
-    "max_retries": 3,
-    "auto_lms": true,
-    "lms_threshold_bytes": 80,
-    "providers": {
-        "aligo": {
-            "driver": "aligo",
-            "api_key": "${ALIGO_API_KEY}",
-            "user_id": "${ALIGO_USER_ID}",
-            "sender": "${SMS_SENDER_NUMBER}"
-        }
-    },
-    "rate_limit": {
-        "per_number_per_minute": 5,
-        "per_minute": 60,
-        "per_hour": 500
-    },
-    "verification": {
-        "code_length": 6,
-        "ttl_sec": 180,
-        "max_attempts": 5,
-        "cooldown_sec": 60
-    },
-    "deploy": true,
-    "minify": true
-}

package/src/app/plugins/sms/config.ts

@@ -1,158 +0,0 @@
-/**
- * SMS 설정 로더
- *
- * 플러그인 디렉토리의 config.json을 읽고 환경변수 치환을 수행합니다.
- * Go 엔티티서버 `internal/config/sms_loader.go`에서 포팅
- */
-
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { logger } from "@gateway/api";
-import type { SmsConfig } from "./types/index.ts";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CONFIG_PATH = join(__dirname, "config.json");
-
-/** SMS 설정을 로드한다 */
-export function loadSmsConfig(): SmsConfig | null {
-    try {
-        let raw = readFileSync(CONFIG_PATH, "utf-8");
-
-        // 환경변수 치환: ${VAR} → process.env.VAR
-        raw = raw.replace(
-            /\$\{([^}]+)\}/g,
-            (_match, name) => process.env[name] ?? "",
-        );
-
-        const cfg: SmsConfig = JSON.parse(raw);
-
-        if (cfg.enabled === false) {
-            logger.info("SMS plugin disabled in config");
-            return null;
-        }
-
-        // 기본값 보정
-        if (!cfg.workers || cfg.workers <= 0) cfg.workers = 2;
-        if (!cfg.queue_size || cfg.queue_size <= 0) cfg.queue_size = 200;
-        if (!cfg.dispatch_interval_sec || cfg.dispatch_interval_sec <= 0)
-            cfg.dispatch_interval_sec = 5;
-        if (!cfg.max_retries || cfg.max_retries <= 0) cfg.max_retries = 3;
-        if (cfg.auto_lms === undefined) cfg.auto_lms = true;
-        if (!cfg.lms_threshold_bytes || cfg.lms_threshold_bytes <= 0)
-            cfg.lms_threshold_bytes = 80;
-
-        // 프로바이더가 1개이고 default 미설정 시 자동 추론
-        if (
-            !cfg.default &&
-            cfg.providers &&
-            Object.keys(cfg.providers).length === 1
-        ) {
-            cfg.default = Object.keys(cfg.providers)[0];
-        }
-
-        // 검증
-        if (!cfg.providers || Object.keys(cfg.providers).length === 0) {
-            logger.error("SMS config: at least one provider is required");
-            return null;
-        }
-        if (!cfg.default) {
-            logger.error("SMS config: default provider must be specified");
-            return null;
-        }
-        const driverNames = Object.keys(cfg.providers);
-        if (!driverNames.includes(cfg.default)) {
-            logger.error(
-                `SMS config: default provider '${cfg.default}' not found in providers`,
-            );
-            return null;
-        }
-
-        // 드라이버별 필수 필드 검증
-        for (const [name, p] of Object.entries(cfg.providers)) {
-            if (!p.driver) {
-                logger.error(
-                    `SMS config: provider '${name}': driver is required`,
-                );
-                return null;
-            }
-            switch (p.driver) {
-                case "aligo":
-                    if (!p.api_key || !p.user_id) {
-                        logger.error(
-                            `SMS config: provider '${p.driver}' (aligo): api_key and user_id are required`,
-                        );
-                        return null;
-                    }
-                    break;
-                case "solapi":
-                    if (!p.api_key || !p.api_secret) {
-                        logger.error(
-                            `SMS config: provider '${p.driver}' (solapi): api_key and api_secret are required`,
-                        );
-                        return null;
-                    }
-                    break;
-                case "ppurio":
-                    if (!p.account || !p.api_key) {
-                        logger.error(
-                            `SMS config: provider '${p.driver}' (ppurio): account and api_key are required`,
-                        );
-                        return null;
-                    }
-                    break;
-                case "nhn_cloud":
-                    if (!p.app_key || !p.secret_key) {
-                        logger.error(
-                            `SMS config: provider '${p.driver}' (nhn_cloud): app_key and secret_key are required`,
-                        );
-                        return null;
-                    }
-                    break;
-                case "aws_sns":
-                    if (!p.region || !p.access_key || !p.secret_key) {
-                        logger.error(
-                            `SMS config: provider '${p.driver}' (aws_sns): region, access_key, and secret_key are required`,
-                        );
-                        return null;
-                    }
-                    break;
-                default:
-                    logger.error(
-                        `SMS config: provider '${p.driver}': unknown driver`,
-                    );
-                    return null;
-            }
-        }
-
-        // 인증번호 기본값 보정
-        if (cfg.verification) {
-            if (
-                !cfg.verification.code_length ||
-                cfg.verification.code_length <= 0
-            )
-                cfg.verification.code_length = 6;
-            if (!cfg.verification.ttl_sec || cfg.verification.ttl_sec <= 0)
-                cfg.verification.ttl_sec = 180;
-            if (
-                !cfg.verification.max_attempts ||
-                cfg.verification.max_attempts <= 0
-            )
-                cfg.verification.max_attempts = 5;
-            if (
-                !cfg.verification.cooldown_sec ||
-                cfg.verification.cooldown_sec <= 0
-            )
-                cfg.verification.cooldown_sec = 60;
-        }
-
-        return cfg;
-    } catch (err: unknown) {
-        if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-            logger.info("SMS config not found, plugin skipped");
-        } else {
-            logger.error({ err }, "Failed to load SMS config");
-        }
-        return null;
-    }
-}

package/src/app/plugins/sms/entity-adapter.ts

@@ -1,213 +0,0 @@
-/**
- * SmsQuerier — Entity Server 어댑터
- *
- * entity-server-client를 통해 sms_log, sms_msg 엔티티에 접근.
- * DB 큐 패턴: pending → processing → sent/failed
- *
- * Go 엔티티서버 `internal/sms/entity_adapter.go`에서 포팅
- *
- * Note: Go의 CompareAndSwap는 구현하지 않음.
- *       단일 Node.js 프로세스이므로 dispatch loop에서 순차 처리하여 동시성 문제 방지.
- */
-
-import { entityServer, logger } from "@gateway/api";
-import type { SmsQuerier, PendingSmsLog, VerificationQuerier } from "./types/index.ts";
-
-export class SmsEntityAdapter implements SmsQuerier {
-    constructor(private readonly maxRetries: number = 3) {}
-
-    /** SMS 발송 로그를 등록한다 */
-    async submitSmsLog(data: Record<string, unknown>): Promise<void> {
-        await entityServer.submit("sms_log", data);
-    }
-
-    /** 대기 중인 SMS 로그를 조회·점유한다 */
-    async claimPendingSmsLogs(limit: number): Promise<PendingSmsLog[]> {
-        const resp = await entityServer.list("sms_log", {
-            status: "pending",
-            page: 1,
-            limit,
-            order: "seq",
-        } as any);
-
-        const items = ((resp.data as any)?.items ?? []) as Record<string, unknown>[];
-        const logs: PendingSmsLog[] = [];
-
-        for (const item of items) {
-            const seq = Number(item.seq ?? 0);
-            if (seq <= 0) continue;
-
-            // pending → processing (단일 프로세스이므로 CAS 대신 직접 갱신)
-            try {
-                await entityServer.submit("sms_log", {
-                    seq,
-                    status: "processing",
-                });
-                logs.push({
-                    log_seq: seq,
-                    provider: String(item.provider ?? ""),
-                    sender: String(item.sender ?? ""),
-                    receiver: String(item.receiver ?? ""),
-                    content: String(item.content ?? ""),
-                    subject: String(item.subject ?? ""),
-                    msg_type: String(item.msg_type ?? ""),
-                    image_url: String(item.image_url ?? ""),
-                    retry_count: Number(item.retry_count ?? 0),
-                    sms_msg_seq: Number(item.sms_msg_seq ?? 0),
-                });
-            } catch (err) {
-                logger.warn(
-                    { err, seq },
-                    "SMS: failed to claim log, skipping",
-                );
-            }
-        }
-
-        return logs;
-    }
-
-    /** SMS 로그 상태를 갱신한다 */
-    async updateSmsLogStatus(
-        logSeq: number,
-        status: string,
-        providerMsgId: string,
-        errMsg: string,
-    ): Promise<void> {
-        const data: Record<string, unknown> = {
-            status,
-            provider_msg_id: providerMsgId,
-            error_message: errMsg,
-        };
-        if (status === "sent") {
-            data.sent_at = "now()";
-        }
-        await entityServer.submit("sms_log", { seq: logSeq, ...data });
-    }
-
-    /** 서버 시작 시 stale processing 로그를 복구한다 */
-    async resetStaleSmsLogs(): Promise<void> {
-        const resp = await entityServer.list("sms_log", {
-            status: "processing",
-            page: 1,
-            limit: 1000,
-        } as any);
-
-        const items = ((resp.data as any)?.items ?? []) as Record<string, unknown>[];
-
-        for (const item of items) {
-            const seq = Number(item.seq ?? 0);
-            const retryCount = Number(item.retry_count ?? 0);
-
-            if (seq <= 0) continue;
-
-            try {
-                if (retryCount >= this.maxRetries) {
-                    await entityServer.submit("sms_log", {
-                        seq,
-                        status: "failed",
-                        error_message: "max retries exceeded (stale recovery)",
-                    });
-                } else {
-                    await entityServer.submit("sms_log", {
-                        seq,
-                        status: "pending",
-                        retry_count: retryCount + 1,
-                    });
-                }
-            } catch (err) {
-                logger.warn(
-                    { err, seq },
-                    "SMS: failed to reset stale log",
-                );
-            }
-        }
-
-        if (items.length > 0) {
-            logger.info(
-                `SMS: reset ${items.length} stale processing logs`,
-            );
-        }
-    }
-
-    /** sms_msg 상태를 갱신한다 */
-    async updateSmsMsgStatus(
-        msgSeq: number,
-        status: string,
-    ): Promise<void> {
-        if (msgSeq <= 0) return;
-        try {
-            await entityServer.submit("sms_msg", { seq: msgSeq, status });
-        } catch (err) {
-            logger.warn(
-                { err, msgSeq },
-                "SMS: failed to update sms_msg status",
-            );
-        }
-    }
-}
-
-/** SMS 인증번호 Entity Adapter */
-export class SmsVerificationEntityAdapter implements VerificationQuerier {
-    /** 인증번호 레코드를 등록하고 seq를 반환한다 */
-    async submitVerification(
-        data: Record<string, unknown>,
-    ): Promise<number> {
-        const resp = await entityServer.submit("sms_verification", data);
-        return resp.seq ?? 0;
-    }
-
-    /** 대기 중인 인증번호 레코드를 조회한다 */
-    async findPendingVerification(
-        phone: string,
-        purpose: string,
-    ): Promise<Record<string, unknown> | null> {
-        const resp = await entityServer.list("sms_verification", {
-            phone,
-            purpose,
-            status: "pending",
-            page: 1,
-            limit: 1,
-            order: "-seq",
-        } as any);
-
-        const items = ((resp.data as any)?.items ?? []) as Record<string, unknown>[];
-        return items[0] ?? null;
-    }
-
-    /** 인증번호 레코드를 갱신한다 */
-    async updateVerification(
-        seq: number,
-        data: Record<string, unknown>,
-    ): Promise<void> {
-        await entityServer.submit("sms_verification", { seq, ...data });
-    }
-
-    /** 동일 전화번호+목적의 이전 pending 건을 모두 만료시킨다 */
-    async expireOldVerifications(
-        phone: string,
-        purpose: string,
-    ): Promise<void> {
-        const resp = await entityServer.list("sms_verification", {
-            phone,
-            purpose,
-            status: "pending",
-            page: 1,
-            limit: 100,
-        } as any);
-
-        const items = ((resp.data as any)?.items ?? []) as Record<string, unknown>[];
-
-        for (const item of items) {
-            const seq = Number(item.seq ?? 0);
-            if (seq <= 0) continue;
-            try {
-                await entityServer.submit("sms_verification", {
-                    seq,
-                    status: "expired",
-                });
-            } catch {
-                // best-effort
-            }
-        }
-    }
-}