create-entity-app-server 0.0.3

package/src/app/plugins/llm/entities/llm_document.json

@@ -0,0 +1,67 @@
+{
+    "name": "llm_document",
+    "description": "RAG 지식베이스 문서 청크. 임베딩 벡터와 함께 저장.",
+    "compress": true,
+    "fields": {
+        "document_id": {
+            "index": true,
+            "comment": "문서 고유 식별자 (UUID 또는 파일명)",
+            "type": "varchar(200)",
+            "required": true
+        },
+        "chunk_index": {
+            "index": true,
+            "comment": "문서 내 청크 순서 (0부터)",
+            "type": "int",
+            "required": true
+        },
+        "title": {
+            "index": true,
+            "comment": "문서 제목",
+            "type": "varchar(200)",
+            "required": true
+        },
+        "content": {
+            "type": "text",
+            "comment": "청크 텍스트 내용",
+            "required": true
+        },
+        "content_type": {
+            "index": true,
+            "comment": "원문 MIME 타입 (text/plain, text/markdown 등)",
+            "type": "varchar(50)"
+        },
+        "vector": {
+            "type": "json",
+            "comment": "임베딩 벡터 ([]float32, JSON 배열)"
+        },
+        "vector_dim": {
+            "type": "int",
+            "comment": "벡터 디멘전 (1536, 768 등)"
+        },
+        "metadata": {
+            "type": "json",
+            "comment": "사용자 정의 메타데이터 ({category, tags, ...})"
+        },
+        "provider_name": {
+            "index": true,
+            "comment": "임베딩 생성 프로바이더 (dot product 일관성 보장)",
+            "type": "varchar(50)",
+            "required": true
+        },
+        "tenant_id": {
+            "index": true,
+            "comment": "테넌트 ID (데이터 격리)"
+        },
+        "token_count": {
+            "type": "int",
+            "comment": "청크 토큰 수 (참고용)"
+        },
+        "status": {
+            "index": true,
+            "type": ["active", "deleted"],
+            "default": "active",
+            "comment": "청크 상태"
+        }
+    }
+}

package/src/app/plugins/llm/entities/llm_usage.json

@@ -0,0 +1,51 @@
+{
+    "name": "llm_usage",
+    "description": "LLM API 호출 사용량 기록. 비용 모니터링 및 쿼터 관리용.",
+    "compress": true,
+    "read_only": true,
+    "fields": {
+        "provider_name": {
+            "index": true,
+            "comment": "LLM 프로바이더 이름 (llm.json 키)",
+            "type": "varchar(50)",
+            "required": true
+        },
+        "caller_service": {
+            "index": true,
+            "comment": "호출한 기능 (ocr, chatbot, summary 등)",
+            "type": "varchar(50)",
+            "required": true
+        },
+        "total_tokens": {
+            "index": true,
+            "comment": "총 토큰 수 (prompt + completion)",
+            "type": "int"
+        },
+        "tenant_id": {
+            "index": true,
+            "comment": "테넌트 ID"
+        },
+        "model": {
+            "type": "varchar(100)",
+            "comment": "사용된 모델명 (gpt-4o-mini 등)",
+            "required": true
+        },
+        "prompt_tokens": { "type": "int", "comment": "프롬프트 토큰 수" },
+        "completion_tokens": { "type": "int", "comment": "응답 토큰 수" },
+        "estimated_cost": {
+            "type": "decimal(10,6)",
+            "comment": "추정 비용 (USD)"
+        },
+        "request_time_ms": { "type": "int", "comment": "요청 처리 시간 (ms)" },
+        "status": {
+            "type": "varchar(20)",
+            "comment": "요청 결과 (success, error, timeout)"
+        },
+        "error_message": {
+            "type": "string",
+            "nullable": true,
+            "comment": "실패 시 오류 메시지"
+        },
+        "user_seq": { "nullable": true, "comment": "요청 사용자 seq" }
+    }
+}

package/src/app/plugins/llm/entities/llm_user_profile.json

@@ -0,0 +1,45 @@
+{
+    "name": "llm_user_profile",
+    "description": "LLM Profile Memory — 사용자별 기억 항목. 대화 시 system prompt에 자동 주입된다.",
+    "fields": {
+        "user_seq": {
+            "index": true,
+            "comment": "프로필 소유 사용자",
+            "required": true
+        },
+        "scope": {
+            "index": true,
+            "comment": "메모리 범위: global(전체 공유) 또는 chatbot_seq(챗봇 전용)",
+            "type": "varchar(50)",
+            "default": "global"
+        },
+        "chatbot_seq": {
+            "index": true,
+            "comment": "scope=chatbot 일 때 연결된 챗봇. null 이면 global",
+            "nullable": true
+        },
+        "key": {
+            "index": true,
+            "comment": "메모리 키 (예: 'name', 'preference', 'goal')",
+            "type": "varchar(100)",
+            "required": true
+        },
+        "value": {
+            "type": "text",
+            "comment": "메모리 값 (자연어 문장 권장)"
+        },
+        "source": {
+            "index": true,
+            "comment": "기록 출처: manual(직접 입력) | extracted(LLM 자동 추출)",
+            "type": ["manual", "extracted"],
+            "default": "manual"
+        },
+        "status": {
+            "index": true,
+            "comment": "활성 여부",
+            "type": ["active", "inactive"],
+            "default": "active"
+        }
+    },
+    "unique": ["user_seq", "scope", "key"]
+}