create-entity-app-server 0.0.3 → 0.1.13

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

@@ -1,71 +0,0 @@
-{
-    "_comment": "LLM(대형 언어 모델) 플러그인 — OpenAI·Anthropic·Gemini·Ollama 멀티 프로바이더, RAG·임베딩·챗봇·요약 지원",
-    "enabled": false,
-    "default": "main",
-    "usage_tracking": true,
-    "providers": {
-        "main": {
-            "description": "기본 제공자 (GPT-4o-mini, 범용)",
-            "driver": "openai",
-            "api_key": "${LLM_OPENAI_API_KEY}",
-            "model": "gpt-4o-mini",
-            "embed_model": "text-embedding-3-small",
-            "max_tokens": 2048,
-            "temperature": 0.1,
-            "timeout_sec": 30,
-            "rate_limit_rpm": 60,
-            "json_mode": true
-        },
-        "chatbot": {
-            "description": "챗봇 대화용 (한국어 우수)",
-            "driver": "anthropic",
-            "api_key": "${LLM_ANTHROPIC_API_KEY}",
-            "model": "claude-sonnet-4-20250514",
-            "max_tokens": 4096,
-            "temperature": 0.7,
-            "timeout_sec": 60,
-            "rate_limit_rpm": 30
-        },
-        "summary": {
-            "description": "문서 요약용 (최저가 대량처리)",
-            "driver": "gemini",
-            "api_key": "${LLM_GEMINI_API_KEY}",
-            "model": "gemini-2.0-flash",
-            "max_tokens": 2048,
-            "temperature": 0.3,
-            "timeout_sec": 30,
-            "rate_limit_rpm": 120
-        },
-        "local": {
-            "description": "로컬 LLM (민감 데이터용)",
-            "driver": "ollama",
-            "base_url": "http://localhost:11434",
-            "model": "llama3:8b",
-            "embed_model": "nomic-embed-text",
-            "max_tokens": 2048,
-            "temperature": 0.5,
-            "timeout_sec": 120,
-            "rate_limit_rpm": 10
-        }
-    },
-    "cache": {
-        "enabled": true,
-        "ttl_seconds": 3600,
-        "exclude_providers": ["local"]
-    },
-    "rag": {
-        "enabled": true,
-        "embed_provider": "main",
-        "default_chunk_size": 500,
-        "default_chunk_overlap": 50,
-        "default_top_k": 5,
-        "default_min_score": 0.7
-    },
-    "quota": {
-        "daily_token_limit": 1000000,
-        "monthly_token_limit": 20000000,
-        "notify": ["log", "smtp"]
-    },
-    "deploy": true,
-    "minify": false
-}

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

@@ -1,72 +0,0 @@
-{
-    "_comment": "OAuth 2.0 설정. 앱서버 OAuth 플러그인에서 직접 사용합니다.",
-    "enabled": false,
-    "deploy": true,
-    "minify": false,
-    "state_secret": "${OAUTH_STATE_SECRET}",
-    "state_ttl_sec": 600,
-    "success_redirect_url": "${OAUTH_SUCCESS_REDIRECT_URL}",
-    "failure_redirect_url": "${OAUTH_FAILURE_REDIRECT_URL}",
-    "providers": [
-        {
-            "driver": "google",
-            "client_id": "${GOOGLE_CLIENT_ID}",
-            "client_secret": "${GOOGLE_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/google/callback",
-            "scopes": ["openid", "email", "profile"]
-        },
-        {
-            "driver": "github",
-            "client_id": "${GITHUB_CLIENT_ID}",
-            "client_secret": "${GITHUB_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/github/callback"
-        },
-        {
-            "driver": "naver",
-            "client_id": "${NAVER_CLIENT_ID}",
-            "client_secret": "${NAVER_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/naver/callback"
-        },
-        {
-            "_comment": "Kakao - custom endpoint example",
-            "driver": "kakao",
-            "client_id": "${KAKAO_CLIENT_ID}",
-            "client_secret": "${KAKAO_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/kakao/callback",
-            "auth_url": "https://kauth.kakao.com/oauth/authorize",
-            "token_url": "https://kauth.kakao.com/oauth/token",
-            "user_info_url": "https://kapi.kakao.com/v2/user/me",
-            "scopes": ["profile_nickname", "account_email"],
-            "email_field": "kakao_account.email",
-            "name_field": "properties.nickname"
-        },
-        {
-            "_comment": "Apple Sign-In - client_secret JWT is auto-generated when apple_team_id/apple_key_id/apple_private_key are set",
-            "driver": "apple",
-            "client_id": "${APPLE_CLIENT_ID}",
-            "client_secret": "",
-            "redirect_url": "/v1/oauth/apple/callback",
-            "scopes": ["name", "email"],
-            "pkce": true,
-            "apple_team_id": "${APPLE_TEAM_ID}",
-            "apple_key_id": "${APPLE_KEY_ID}",
-            "apple_private_key": "${APPLE_PRIVATE_KEY}"
-        },
-        {
-            "driver": "linkedin",
-            "client_id": "${LINKEDIN_CLIENT_ID}",
-            "client_secret": "${LINKEDIN_CLIENT_SECRET}",
-            "redirect_url": "/api/v1/oauth/linkedin/callback",
-            "scopes": ["openid", "profile", "email"]
-        },
-        {
-            "_comment": "Line Login v2.1 - openid + email recommended",
-            "driver": "line",
-            "client_id": "${LINE_CLIENT_ID}",
-            "client_secret": "${LINE_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/line/callback",
-            "scopes": ["openid", "profile", "email"],
-            "pkce": true
-        }
-    ]
-}

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

@@ -1,50 +0,0 @@
-/**
- * CacheManager — SHA-256 기반 OCR 결과 캐싱
- */
-
-import { createHash } from "node:crypto";
-import type { OcrResult, OcrCacheConfig } from "./types/index.ts";
-
-export class CacheManager {
-    private readonly cache = new Map<
-        string,
-        { data: OcrResult; expireAt: number }
-    >();
-    private readonly ttlMs: number;
-
-    /** OCR 캐시를 TTL 설정으로 초기화한다 */
-    constructor(cfg: OcrCacheConfig) {
-        this.ttlMs = (cfg.ttlHours > 0 ? cfg.ttlHours : 168) * 3600 * 1000;
-    }
-
-    /** 캐시 키 생성: "ocr:{sha256(provider:docType:fileHash)}" */
-    cacheKey(fileHash: string, provider: string, docType: string): string {
-        const raw = `${provider}:${docType}:${fileHash}`;
-        const h = createHash("sha256").update(raw).digest("hex");
-        return `ocr:${h}`;
-    }
-
-    /** 캐시에서 OcrResult 조회 */
-    get(key: string): OcrResult | null {
-        const entry = this.cache.get(key);
-        if (!entry) return null;
-        if (Date.now() > entry.expireAt) {
-            this.cache.delete(key);
-            return null;
-        }
-        return entry.data;
-    }
-
-    /** OcrResult를 캐시에 저장 */
-    set(key: string, result: OcrResult): void {
-        this.cache.set(key, {
-            data: result,
-            expireAt: Date.now() + this.ttlMs,
-        });
-    }
-}
-
-/** 파일 데이터의 SHA-256 해시 */
-export function computeFileHash(data: Buffer): string {
-    return createHash("sha256").update(data).digest("hex");
-}

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

@@ -1,110 +0,0 @@
-{
-    "_comment": "OCR(문자 인식) 플러그인 — Google Vision·Naver CLOVA·AWS Textract·Azure·Upstage·Tesseract 멀티 프로바이더 지원",
-    "enabled": false,
-    "default_provider": "naver",
-    "providers": {
-        "google": {
-            "driver": "google",
-            "api_key": "${OCR_GOOGLE_API_KEY}",
-            "endpoint": "https://vision.googleapis.com/v1/images:annotate",
-            "supported_formats": [
-                "image/jpeg",
-                "image/png",
-                "image/gif",
-                "image/webp",
-                "image/bmp",
-                "application/pdf"
-            ],
-            "max_file_size": 20971520,
-            "timeout": 30000
-        },
-        "naver": {
-            "driver": "naver",
-            "api_key": "${OCR_NAVER_SECRET}",
-            "endpoint": "${OCR_NAVER_INVOKE_URL}",
-            "supported_formats": [
-                "image/jpeg",
-                "image/png",
-                "image/gif",
-                "image/bmp",
-                "image/tiff",
-                "application/pdf"
-            ],
-            "max_file_size": 20971520,
-            "timeout": 30000
-        },
-        "aws_textract": {
-            "driver": "aws_textract",
-            "api_key": "${OCR_AWS_ACCESS_KEY}",
-            "api_secret": "${OCR_AWS_SECRET_KEY}",
-            "region": "${OCR_AWS_REGION}",
-            "supported_formats": ["image/jpeg", "image/png", "application/pdf"],
-            "max_file_size": 10485760,
-            "timeout": 30000
-        },
-        "azure": {
-            "driver": "azure",
-            "api_key": "${OCR_AZURE_KEY}",
-            "endpoint": "${OCR_AZURE_ENDPOINT}",
-            "supported_formats": [
-                "image/jpeg",
-                "image/png",
-                "image/bmp",
-                "image/tiff",
-                "application/pdf"
-            ],
-            "max_file_size": 52428800,
-            "timeout": 60000
-        },
-        "upstage": {
-            "driver": "upstage",
-            "api_key": "${OCR_UPSTAGE_API_KEY}",
-            "endpoint": "https://api.upstage.ai/v1/document-ai/ocr",
-            "supported_formats": ["image/jpeg", "image/png", "application/pdf"],
-            "max_file_size": 20971520,
-            "timeout": 30000
-        },
-        "tesseract": {
-            "driver": "tesseract",
-            "supported_formats": [
-                "image/jpeg",
-                "image/png",
-                "image/gif",
-                "image/bmp",
-                "image/tiff"
-            ],
-            "max_file_size": 52428800,
-            "timeout": 60000
-        }
-    },
-    "cache": {
-        "enabled": true,
-        "ttl": 3600
-    },
-    "quota": {
-        "daily_limit": 1000,
-        "monthly_limit": 20000,
-        "warn_percent": 80
-    },
-    "dispatch": {
-        "max_queue_size": 100,
-        "concurrency": 3,
-        "tick_interval": 200
-    },
-    "parsing": {
-        "confidence_threshold": 0.6,
-        "template_dir": "configs/ocr-templates"
-    },
-    "llm_fallback": {
-        "enabled": true,
-        "provider": "",
-        "confidence_threshold": 0.85,
-        "prompt_dir": "configs/ocr-prompts"
-    },
-    "retry": {
-        "max_retries": 2,
-        "retry_delay": 1000
-    },
-    "deploy": true,
-    "minify": true
-}

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

@@ -1,126 +0,0 @@
-/**
- * OCR 설정 로더
- * 플러그인 디렉토리의 config.json 로드 + 환경변수 치환
- */
-
-import { readFileSync, existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import type {
-    OcrConfig,
-    OcrProviderConfig,
-    OcrLlmFallbackConfig,
-} from "./types/index.ts";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-const DEFAULT_CONFIG: Omit<OcrConfig, "providers"> = {
-    enabled: false,
-    default: "",
-    workers: 2,
-    queueSize: 50,
-    maxFileSizeMB: 20,
-    supportedFormats: [
-        "image/jpeg",
-        "image/png",
-        "image/webp",
-        "image/tiff",
-        "application/pdf",
-    ],
-    cache: { enabled: false, ttlHours: 168 },
-    quota: { dailyLimit: 0, monthlyLimit: 0, notify: [] },
-    parsing: {
-        templateDir: join(__dirname, "templates"),
-        confidenceThreshold: 0.6,
-    },
-    llmFallback: {
-        enabled: false,
-        provider: "",
-        confidenceThreshold: 0.85,
-        promptDir: join(__dirname, "templates", "prompts"),
-    },
-};
-
-/** 문자열 내 ${ENV} 패턴을 환경변수 값으로 치환한다 */
-function expandEnv(val: string | undefined): string {
-    if (!val) return "";
-    return val.replace(/\$\{([^}]+)\}/g, (_, key) => process.env[key] ?? "");
-}
-
-/** 프로바이더 설정의 모든 환경변수를 치환한다 */
-function expandProviderEnv(p: OcrProviderConfig): OcrProviderConfig {
-    return {
-        ...p,
-        apiKey: expandEnv(p.apiKey),
-        apiUrl: expandEnv(p.apiUrl),
-        apiEndpoint: expandEnv(p.apiEndpoint),
-        secretKey: expandEnv(p.secretKey),
-        credentialsPath: expandEnv(p.credentialsPath),
-        accessKeyId: expandEnv(p.accessKeyId),
-        secretAccessKey: expandEnv(p.secretAccessKey),
-        region: expandEnv(p.region),
-        endpoint: expandEnv(p.endpoint),
-        dataPath: expandEnv(p.dataPath),
-    };
-}
-
-/** OCR 설정 파일을 로드하고 환경변수를 치환하여 반환한다 */
-export function loadOcrConfig(): OcrConfig | null {
-    const filePath = join(__dirname, "config.json");
-    if (!existsSync(filePath)) return null;
-
-    const raw = JSON.parse(readFileSync(filePath, "utf-8"));
-    const cfg: OcrConfig = { ...DEFAULT_CONFIG, ...raw };
-
-    // JSON에서 snake_case → camelCase 변환
-    cfg.maxFileSizeMB = raw.max_file_size_mb ?? cfg.maxFileSizeMB;
-    cfg.queueSize = raw.queue_size ?? cfg.queueSize;
-    cfg.supportedFormats = raw.supported_formats ?? cfg.supportedFormats;
-    if (raw.cache) {
-        cfg.cache = {
-            enabled: raw.cache.enabled ?? false,
-            ttlHours: raw.cache.ttl_hours ?? 168,
-        };
-    }
-    if (raw.quota) {
-        cfg.quota = {
-            dailyLimit: raw.quota.daily_limit ?? 0,
-            monthlyLimit: raw.quota.monthly_limit ?? 0,
-            notify: raw.quota.notify ?? [],
-        };
-    }
-    if (raw.parsing) {
-        cfg.parsing = {
-            templateDir:
-                raw.parsing.template_dir ?? join(__dirname, "templates"),
-            confidenceThreshold: raw.parsing.confidence_threshold ?? 0.6,
-        };
-    }
-    if (raw.llm_fallback) {
-        const lf = raw.llm_fallback as OcrLlmFallbackConfig &
-            Record<string, unknown>;
-        cfg.llmFallback = {
-            enabled: (lf.enabled ?? false) as boolean,
-            provider: (lf.provider ?? "") as string,
-            confidenceThreshold: (lf.confidence_threshold ?? 0.85) as number,
-            promptDir: (lf.prompt_dir ??
-                join(__dirname, "templates", "prompts")) as string,
-        };
-    }
-
-    if (!cfg.enabled) return null;
-
-    // 환경변수 치환
-    cfg.providers = (cfg.providers ?? []).map(expandProviderEnv);
-
-    // 기본값 보정
-    if (!cfg.default && cfg.providers.length === 1) {
-        cfg.default = cfg.providers[0].driver;
-    }
-
-    if (cfg.providers.length === 0) {
-        throw new Error("ocr config: at least one provider must be configured");
-    }
-
-    return cfg;
-}

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

@@ -1,48 +0,0 @@
-/**
- * 8방향 상수 + 공간 방향 판정
- * PHP 레거시 코드의 8방향 상수 계승
- */
-
-import type { ProcessedItem } from "./types/index.ts";
-
-// 겹침 없는 방향 (A 영역과 B 영역이 완전히 분리)
-export const DIRECTION_RIGHT = "RIGHT";
-export const DIRECTION_LEFT = "LEFT";
-export const DIRECTION_DOWN = "DOWN";
-export const DIRECTION_UP = "UP";
-
-// 겹침 허용 방향 (중심점 비교만)
-export const DIRECTION_RIGHT_OVERLAP = "RIGHT_OVERLAP";
-export const DIRECTION_LEFT_OVERLAP = "LEFT_OVERLAP";
-export const DIRECTION_DOWN_OVERLAP = "DOWN_OVERLAP";
-export const DIRECTION_UP_OVERLAP = "UP_OVERLAP";
-
-/**
- * item이 base에 대해 direction 조건을 만족하는지 확인합니다.
- */
-export function checkDirectionMatch(
-    item: ProcessedItem,
-    base: ProcessedItem,
-    direction: string,
-): boolean {
-    switch (direction) {
-        case DIRECTION_RIGHT:
-            return item.left >= base.right;
-        case DIRECTION_LEFT:
-            return item.right <= base.left;
-        case DIRECTION_DOWN:
-            return item.top >= base.bottom;
-        case DIRECTION_UP:
-            return item.bottom <= base.top;
-        case DIRECTION_RIGHT_OVERLAP:
-            return item.centerX > base.centerX;
-        case DIRECTION_LEFT_OVERLAP:
-            return item.centerX < base.centerX;
-        case DIRECTION_DOWN_OVERLAP:
-            return item.centerY > base.centerY;
-        case DIRECTION_UP_OVERLAP:
-            return item.centerY < base.centerY;
-        default:
-            return false;
-    }
-}

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

@@ -1,130 +0,0 @@
-/**
- * DispatchWorker — 비동기 OCR 큐 + 워커 (Node.js setInterval 패턴)
- * Go goroutine+channel 패턴을 Node.js 싱글 스레드용으로 변환
- */
-
-import type {
-    DispatchJob,
-    RecognizeOptions,
-    OcrEntityStore,
-    OcrResult,
-} from "./types/index.ts";
-import { OcrError, ERR_ASYNC_QUEUE_FULL } from "./errors.ts";
-
-export class DispatchWorker {
-    private readonly queue: DispatchJob[] = [];
-    private readonly queueSize: number;
-    private readonly concurrency: number;
-    private running = 0;
-    private timer: ReturnType<typeof setInterval> | null = null;
-    private stopped = false;
-
-    // OcrService의 recognize 함수를 받아 사용
-    private recognizeFn:
-        | ((data: Buffer, opts: RecognizeOptions) => Promise<OcrResult>)
-        | null = null;
-    private entityStore: OcrEntityStore | null = null;
-
-    /** 비동기 OCR 큐를 지정된 큐 크기와 동시성으로 초기화한다 */
-    constructor(queueSize: number, concurrency: number) {
-        this.queueSize = queueSize > 0 ? queueSize : 50;
-        this.concurrency = concurrency > 0 ? concurrency : 2;
-    }
-
-    /** recognize 함수 및 entityStore 주입 */
-    init(
-        recognizeFn: (
-            data: Buffer,
-            opts: RecognizeOptions,
-        ) => Promise<OcrResult>,
-        entityStore: OcrEntityStore | null,
-    ): void {
-        this.recognizeFn = recognizeFn;
-        this.entityStore = entityStore;
-    }
-
-    /** 워커 시작 (200ms 간격 폴링) */
-    start(): void {
-        this.stopped = false;
-        this.timer = setInterval(() => this.tick(), 200);
-        console.log(
-            `[INFO] OCR dispatch workers started (concurrency=${this.concurrency})`,
-        );
-    }
-
-    /** 워커 종료 */
-    stop(): void {
-        this.stopped = true;
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-    }
-
-    /** 작업 큐에 추가 → 작업 ID 반환 */
-    submit(data: Buffer, opts: RecognizeOptions): string {
-        if (this.queue.length >= this.queueSize) {
-            throw new OcrError(
-                `async processing queue is full: queue size ${this.queueSize}`,
-                ERR_ASYNC_QUEUE_FULL,
-            );
-        }
-        const id = crypto.randomUUID();
-        this.queue.push({
-            id,
-            data,
-            opts,
-            createdAt: new Date().toISOString(),
-        });
-        return id;
-    }
-
-    /** 큐에서 작업을 가져와 처리한다 */
-    private tick(): void {
-        while (
-            this.running < this.concurrency &&
-            this.queue.length > 0 &&
-            !this.stopped
-        ) {
-            const job = this.queue.shift()!;
-            this.running++;
-            this.processJob(job).finally(() => {
-                this.running--;
-            });
-        }
-    }
-
-    /** 단일 OCR 작업을 실행하고 결과를 저장한다 */
-    private async processJob(job: DispatchJob): Promise<void> {
-        if (!this.recognizeFn) return;
-
-        try {
-            // 상태: processing
-            if (this.entityStore) {
-                await this.entityStore
-                    .updateResultState(job.id, "processing", null, "")
-                    .catch(() => {});
-            }
-
-            const result = await this.recognizeFn(job.data, job.opts);
-
-            // 상태: completed
-            if (this.entityStore) {
-                await this.entityStore
-                    .updateResultState(job.id, "completed", result, "")
-                    .catch(() => {});
-            }
-            console.log(
-                `[INFO] OCR async job ${job.id} completed (parse=${result.parseMethod} conf=${result.parseConfidence.toFixed(2)})`,
-            );
-        } catch (err) {
-            console.log(`[ERROR] OCR async job ${job.id} failed: ${err}`);
-            if (this.entityStore) {
-                const msg = err instanceof Error ? err.message : String(err);
-                await this.entityStore
-                    .updateResultState(job.id, "failed", null, msg)
-                    .catch(() => {});
-            }
-        }
-    }
-}