create-entity-app-server 0.0.3 → 0.1.13

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/smtp/config.json

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

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

@@ -1,41 +0,0 @@
-/**
- * SMTP 플러그인 설정 로더
- */
-
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { logger } from "@gateway/api";
-import type { SmtpPluginConfig } from "./types/index.ts";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CONFIG_PATH = join(__dirname, "config.json");
-
-/** SMTP 플러그인 설정을 로드한다 */
-export function loadSmtpConfig(): SmtpPluginConfig | null {
-    try {
-        let raw = readFileSync(CONFIG_PATH, "utf-8");
-
-        // 환경변수 치환: ${VAR} → process.env.VAR
-        raw = raw.replace(
-            /\$\{([^}]+)\}/g,
-            (_match, name) => process.env[name] ?? "",
-        );
-
-        const cfg: SmtpPluginConfig = JSON.parse(raw);
-
-        if (cfg.enabled === false) {
-            logger.info("SMTP plugin routes disabled in config");
-            return null;
-        }
-
-        return cfg;
-    } catch (err: unknown) {
-        if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-            // config.json 없으면 기본값으로 활성화
-            return { enabled: true };
-        }
-        logger.error({ err }, "Failed to load SMTP config");
-        return null;
-    }
-}

package/src/app/plugins/smtp/handlers.ts

@@ -1,52 +0,0 @@
-/**
- * SMTP API 핸들러
- *
- * 앱 서버가 직접 처리하는 이유:
- *  - 로컬 템플릿(templates/*.html) 렌더링 후 body_html을 완성하여 Go 서버로 전달
- *  - 프록시 패스스루로는 앱 서버 로컬 파일에 접근 불가
- *
- * 라우트에 없는 /api/v1/smtp/* 경로는 proxy/register.ts가 Go 서버로 패스스루한다.
- */
-
-import type { FastifyRequest, FastifyReply } from "fastify";
-import { ok, fail, sendEmail, entityServer } from "@gateway/api";
-import type { SendEmailParams } from "@gateway/api";
-
-// ─── 핸들러 ──────────────────────────────────────────────────────────────────
-
-/**
- * POST /api/v1/smtp/send
- *
- * templateName이 지정되면 로컬 templates/ 에서 렌더링 후 Go 서버에 전달.
- * templateName 없이 body_html/body_text만 지정하면 그대로 전달.
- */
-export async function handleSend(request: FastifyRequest, reply: FastifyReply) {
-    const params = (request.body ?? {}) as SendEmailParams;
-
-    if (!params.to || params.to.length === 0) {
-        return reply.status(400).send(fail("to is required"));
-    }
-
-    const seq = await sendEmail(params);
-    return ok({ seq });
-}
-
-/**
- * GET /api/v1/smtp/status/:seq
- *
- * Go 서버에 발송 상태를 조회한다.
- */
-export async function handleStatus(
-    request: FastifyRequest,
-    reply: FastifyReply,
-) {
-    const { seq } = request.params as { seq: string };
-    const seqNum = Number(seq);
-
-    if (!seqNum || seqNum <= 0) {
-        return reply.status(400).send(fail("Invalid seq"));
-    }
-
-    const result = await entityServer.smtpStatus(seqNum);
-    return ok(result);
-}

package/src/app/plugins/smtp/index.ts

@@ -1,33 +0,0 @@
-/**
- * SMTP 플러그인
- *
- * 앱 서버 내 모든 이메일 발송에 사용할 공유 레이아웃을 등록한다.
- * 알파벳 순 플러그인 로드 중 초기화되며, 이후의 모든 renderTemplate 호출에서
- * plugins/smtp/templates/layout.html 을 공통 래퍼로 사용한다.
- *
- * HTTP 라우트는 routes.ts 에서 등록하며, proxy/register.ts 의 패스스루보다
- * 먼저 처리된다 (system/routes/loader.ts → system/proxy/register.ts 순서).
- *
- *  - POST /api/v1/smtp/send    → 로컬 템플릿 렌더링 후 Go 서버로 발송
- *  - GET  /api/v1/smtp/status/:seq → Go 서버에 발송 상태 조회
- *
- * routes.ts에 없는 /api/v1/smtp/* 경로는 Go 서버로 패스스루된다.
- */
-
-import fp from "fastify-plugin";
-import type { FastifyInstance } from "fastify";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { setSharedLayout } from "@gateway/api";
-import { logger } from "@gateway/api";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export default fp(
-    async (_app: FastifyInstance) => {
-        const layoutPath = join(__dirname, "templates", "layout.html");
-        setSharedLayout(layoutPath);
-        logger.debug({ layout: layoutPath }, "Email shared layout registered");
-    },
-    { name: "smtp" },
-);

package/src/app/plugins/smtp/routes.ts

@@ -1,19 +0,0 @@
-/**
- * SMTP 라우트 테이블
- * 등록 경로: /api/v1/smtp/*
- *
- * 여기서 처리되지 않는 /api/v1/smtp/* 경로는
- * system/proxy/register.ts 에 의해 Go 서버로 패스스루된다.
- */
-
-import type { FastifyInstance } from "fastify";
-import * as h from "./handlers.ts";
-
-/** SMTP 라우트를 등록한다 */
-export default async function smtpRoutes(app: FastifyInstance) {
-    // POST /api/v1/smtp/send — 로컬 템플릿 렌더링 후 Go 서버로 발송
-    app.post("/send", h.handleSend);
-
-    // GET /api/v1/smtp/status/:seq — 발송 상태 조회
-    app.get("/status/:seq", h.handleStatus);
-}

package/src/app/plugins/smtp/types/config.ts

@@ -1,8 +0,0 @@
-/** plugins/smtp/config.json 스키마 */
-export interface SmtpPluginConfig {
-    enabled: boolean; // 라우트 활성화 여부 (false면 routes.ts 등록 안 됨)
-
-    deploy?: boolean; // 빌드 시 dist에서 제외 여부
-
-    minify?: boolean; // 빌드 시 난독화 여부
-}

package/src/app/plugins/smtp/types/index.ts

@@ -1 +0,0 @@
-export * from "./config.ts";

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

@@ -1,35 +0,0 @@
-{
-    "_comment": "전자세금계산서 플러그인 — 바로빌 연동, 국세청 자동 전송·상태 동기화·발행 큐 처리 지원",
-    "enabled": false,
-    "default": "barobill",
-    "workers": 2,
-    "queue_size": 100,
-    "dispatch_interval_sec": 10,
-    "max_retries": 3,
-    "providers": {
-        "barobill": {
-            "driver": "barobill",
-            "cert_key": "${TAXINVOICE_CERT_KEY}",
-            "corp_num": "${TAXINVOICE_CORP_NUM}",
-            "user_id": "${TAXINVOICE_USER_ID}",
-            "api_endpoint": "https://barobill.co.kr/TAPI/TaxInvoiceService.asmx",
-            "timeout_sec": 30
-        }
-    },
-    "nts": {
-        "auto_send": false,
-        "taxation_option": 1,
-        "taxation_add_tax_allow": 0,
-        "tax_exemption_option": 1,
-        "tax_exemption_add_tax_allow": 0
-    },
-    "notify": ["log"],
-    "sync": {
-        "enabled": false,
-        "interval_sec": 600,
-        "state_sync_interval_min": 10,
-        "max_list_days": 200
-    },
-    "deploy": true,
-    "minify": false
-}

package/src/app/routes/account/change-password/config.json

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

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

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

package/src/app/routes/account/reactivate/config.json

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

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

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

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

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

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

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

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

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

package/src/app/routes/calendar/entities/calendar_attendees.json

@@ -1,23 +0,0 @@
-{
-    "name": "calendar_attendees",
-    "description": "일정 참석자 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "fields": {
-        "event_seq": {
-            "index": true,
-            "comment": "일정seq"
-        },
-        "employee_seq": {
-            "index": true,
-            "comment": "직원seq"
-        }
-    },
-    "unique": [
-        [
-            "event_seq",
-            "employee_seq"
-        ]
-    ],
-    "fk": {
-        "event_seq": "calendar_events.seq"
-    }
-}

package/src/app/routes/calendar/entities/calendar_comments.json

@@ -1,17 +0,0 @@
-{
-    "name": "calendar_comments",
-    "description": "일정 댓글 정보. JWT 인증 시 account_seq ↔ account 관계. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "fields": {
-        "event_seq": {
-            "index": true,
-            "comment": "일정seq"
-        },
-        "account_seq": {
-            "index": true,
-            "comment": "사용자seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)"
-        }
-    },
-    "fk": {
-        "event_seq": "calendar_events.seq"
-    }
-}

package/src/app/routes/calendar/entities/calendar_events.json

@@ -1,48 +0,0 @@
-{
-    "name": "calendar_events",
-    "description": "달력 이벤트 정보. JWT 인증 시 account_seq ↔ account 관계. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "fields": {
-        "account_seq": {
-            "index": true,
-            "comment": "사용자seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)"
-        },
-        "bgn_time": {
-            "index": true,
-            "comment": "시작일시"
-        },
-        "category": {
-            "index": true,
-            "comment": "분류"
-        },
-        "end_time": {
-            "index": true,
-            "comment": "종료일시"
-        },
-        "group_seq": {
-            "index": true,
-            "comment": "그룹seq"
-        },
-        "method": {
-            "index": true,
-            "comment": "방식"
-        },
-        "related_seq": {
-            "index": true,
-            "comment": "연관seq"
-        },
-        "repeat": {
-            "comment": "반복여부"
-        },
-        "title": {
-            "index": true,
-            "comment": "제목"
-        },
-        "visible": {
-            "index": true,
-            "comment": "공개여부"
-        }
-    },
-    "fk": {
-        "group_seq": "hr_group.seq"
-    }
-}

package/src/app/routes/calendar/entities/calendar_kind.json

@@ -1,11 +0,0 @@
-{
-    "name": "calendar_kind",
-    "description": "calendar_kind 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "fields": {
-        "name": {
-            "index": true,
-            "comment": "이름",
-            "unique": true
-        }
-    }
-}

package/src/app/routes/calendar/entities/calendar_method.json

@@ -1,11 +0,0 @@
-{
-    "name": "calendar_method",
-    "description": "calendar_method 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "fields": {
-        "name": {
-            "index": true,
-            "comment": "이름",
-            "unique": true
-        }
-    }
-}

package/src/app/routes/calendar/routes.ts

@@ -1,32 +0,0 @@
-/**
- * Calendar 라우트 플러그인
- *
- * 자동 로더가 `app/routes/calendar/routes.ts`를 탐색하여
- * prefix `/api/v1/calendar` 으로 등록한다.
- *
- * 엔티티:
- *   - calendar_events     — 일정/이벤트
- *   - calendar_attendees  — 일정 참석자
- *   - calendar_comments   — 일정 댓글
- *   - calendar_files      — 일정 첨부파일
- *   - calendar_kind       — 일정 분류
- *   - calendar_method     — 일정 방법(비대면/대면 등)
- */
-
-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 calendarRoutes(
-    app: FastifyInstance,
-): Promise<void> {
-    await ensurePluginEntities(__dirname).catch((err) =>
-        logger.warn({ err }, "calendar: ensureEntities failed"),
-    );
-
-    // TODO: 일정 라우트 핸들러 추가
-    void app;
-}