AIOCR ERD2
Tables (15)
api_audit_log
- id — BIGINT — Primary key — NOT NULL — 기본키
- api_key_id — CHAR(36) — Foreign key → api_keys.id — API 키 ID (FK → API_KEYS)
- method — VARCHAR(10) — NOT NULL — HTTP 메서드 (GET, POST, PUT, DELETE 등)
- path — VARCHAR(500) — NOT NULL — 요청 경로
- status_code — INT — NOT NULL — HTTP 상태 코드
- ip_address — VARCHAR(45) — 클라이언트 IP
- user_agent — VARCHAR(500) — User-Agent 헤더
- request_body_size — INT — 요청 본문 크기 (bytes)
- response_time_ms — INT — 응답 시간 (ms)
- created_at — DATETIME — NOT NULL — 생성일시
api_keys
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- key_prefix — VARCHAR(8) — NOT NULL — 키 접두사 (표시용)
- key_hash — VARCHAR(255) — NOT NULL — API 키 해시 (SHA-256)
- name — VARCHAR(100) — NOT NULL — 키 이름 (용도 설명)
- owner_id — CHAR(36) — Foreign key → core_users.id — 소유자 (FK → CORE_USERS)
- owner_type — VARCHAR(20) — NOT NULL — 소유자 유형 (USER, SERVICE, SYSTEM)
- scopes — LONGTEXT — NOT NULL — 권한 범위 (JSON 배열)
- rate_limit — INT — 분당 요청 제한
- is_active — TINYINT — NOT NULL — 활성화 여부
- expires_at — DATETIME — 만료일시 (NULL=무제한)
- last_used_at — DATETIME — 마지막 사용일시
- last_used_ip — VARCHAR(45) — 마지막 사용 IP
- usage_count — BIGINT — 총 사용 횟수
- created_at — DATETIME — NOT NULL — 생성일시
- revoked_at — DATETIME — 폐기일시
- revoked_by — VARCHAR(100) — 폐기자
artifact
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- uri — VARCHAR(500) — NOT NULL — MinIO 저장 경로
- storage_type — VARCHAR(50) — NOT NULL — 저장소 유형 (MINIO, LOCAL)
- content_type — VARCHAR(100) — MIME 타입
- size_bytes — BIGINT — NOT NULL — 파일 크기 (바이트)
- checksum — VARCHAR(64) — NOT NULL — SHA-256 체크섬
- created_by — VARCHAR(100) — NOT NULL — 생성자 (스테이지명)
- created_at — DATETIME — NOT NULL — 생성일시
- expires_at — DATETIME — 만료일시
config_audit_logs
- id — BIGINT — Primary key — NOT NULL — 기본키
- table_name — VARCHAR(50) — NOT NULL — 변경된 테이블명
- record_id — INT — NOT NULL — 해당 레코드 ID
- action — VARCHAR(20) — NOT NULL — 액션 (INSERT, UPDATE, DELETE)
- old_value — LONGTEXT — 변경 전 값 (JSON)
- new_value — LONGTEXT — 변경 후 값 (JSON)
- changed_by — VARCHAR(100) — NOT NULL — 변경자
- changed_at — DATETIME — NOT NULL — 변경일시
- ip_address — VARCHAR(45) — 요청 IP 주소
- user_agent — TEXT — User-Agent 헤더
config_items
- id — INT — Primary key — NOT NULL — 기본키
- app_name — VARCHAR(50) — NOT NULL — 애플리케이션명
- key — VARCHAR(100) — NOT NULL — 설정 키
- value — LONGTEXT — NOT NULL — 설정 값 (JSON)
- value_type — VARCHAR(20) — NOT NULL — 값 타입 (int, str, bool, json, list)
- environment — VARCHAR(20) — NOT NULL — 환경 (dev, staging, prod, all)
- description — TEXT — 설명
- is_sensitive — TINYINT — 민감 정보 여부
- is_active — TINYINT — NOT NULL — 활성화 여부
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
- created_by_user_id — CHAR(36) — Foreign key → core_users.id — 생성자 (FK → CORE_USERS)
- updated_by_user_id — CHAR(36) — Foreign key → core_users.id — 수정자 (FK → CORE_USERS)
core_users
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- username — VARCHAR(50) — NOT NULL — 사용자명 (로그인 ID)
- email — VARCHAR(255) — NOT NULL — 이메일
- password_hash — VARCHAR(255) — NOT NULL — 비밀번호 해시 (bcrypt)
- display_name — VARCHAR(100) — 표시 이름
- role — VARCHAR(20) — NOT NULL — 역할 (ADMIN, OPERATOR, VIEWER)
- is_active — TINYINT — NOT NULL — 활성화 여부
- last_login_at — DATETIME — 마지막 로그인 일시
- last_login_ip — VARCHAR(45) — 마지막 로그인 IP (IPv4/IPv6)
- failed_login_count — INT — 연속 로그인 실패 횟수
- locked_until — DATETIME — 계정 잠금 해제 시간
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
- created_by — VARCHAR(100) — 생성자
dlq_records
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- dlq_id — VARCHAR(100) — NOT NULL — DLQ 레코드 ID (외부 추적용)
- job_id — CHAR(36) — Foreign key → job.id — NOT NULL — 원본 작업 (FK → JOB)
- error_code — VARCHAR(20) — Foreign key → error_codes.code — NOT NULL — 에러 코드 (FK → ERROR_CODES)
- stage — VARCHAR(100) — NOT NULL — 실패한 스테이지명
- attempt_count — INT — NOT NULL — 총 시도 횟수
- input_uri — VARCHAR(500) — 입력 데이터 URI
- debug_bundle_uri — VARCHAR(500) — 디버그 번들 URI
- last_error_message — TEXT — 마지막 에러 메시지
- status — VARCHAR(20) — NOT NULL — 상태 (PENDING, RETRYING, RESOLVED, ABANDONED)
- created_at — DATETIME — NOT NULL — 생성일시
- resolved_at — DATETIME — 해결/포기 일시
- resolved_by — VARCHAR(100) — 해결자
error_codes
- code — VARCHAR(20) — Primary key — NOT NULL — 에러 코드 (예: CORE-JOB-001)
- layer — VARCHAR(10) — NOT NULL — 레이어 (CORE, BIZ, INFRA)
- component — VARCHAR(20) — NOT NULL — 컴포넌트 (JOB, DET, RECG, STOR 등)
- severity — VARCHAR(15) — NOT NULL — 심각도 (TRANSIENT, DETERMINISTIC, CAPACITY)
- http_status — INT — NOT NULL — HTTP 상태 코드
- message — VARCHAR(500) — NOT NULL — 에러 메시지 (사용자용)
- description — TEXT — 상세 설명 (개발자용)
- recommended_action — TEXT — 권장 조치
- retryable — TINYINT — 재시도 가능 여부
- max_retries — INT — 최대 재시도 횟수
- base_delay_seconds — INT — 기본 재시도 지연 (초)
- is_active — TINYINT — 활성화 여부
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
job
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- external_job_id — VARCHAR(100) — NOT NULL — 외부 시스템 Job ID
- doc_kind — VARCHAR(100) — NOT NULL — 문서 종류 (GENERAL, INVOICE, TABLE 등)
- source_uri — VARCHAR(500) — NOT NULL — 입력 문서 URI
- status — VARCHAR(50) — NOT NULL — 상태 (QUEUED, RUNNING, COMPLETED, FAILED, CANCELLED)
- pipeline_version — VARCHAR(20) — 파이프라인 버전
- callback_url — VARCHAR(500) — Webhook URL
- trace_id — VARCHAR(100) — 분산 추적 ID (OpenTelemetry)
- prefect_flow_run_id — CHAR(36) — Prefect Flow Run ID
- options — LONGTEXT — 파이프라인 옵션 (JSON)
- artifact_policy — LONGTEXT — 산출물 정책 (JSON)
- progress — INT — 진행률 (0~100)
- current_step — VARCHAR(100) — 현재 스테이지
- priority — INT — NOT NULL — 우선순위 (높을수록 먼저 실행)
- error_code — VARCHAR(20) — Foreign key → error_codes.code — 에러 코드 (FK → ERROR_CODES)
- error_message — TEXT — 에러 메시지
- processing_time_ms — BIGINT — 전체 처리 시간 (ms)
- created_at — DATETIME — NOT NULL — 생성일시
- started_at — DATETIME — 처리 시작일시
- completed_at — DATETIME — 완료일시
job_event_log
- id — BIGINT — Primary key — NOT NULL — 기본키
- job_id — CHAR(36) — Foreign key → job.id — NOT NULL — 대상 작업 (FK → JOB)
- event_type — VARCHAR(50) — NOT NULL — 이벤트 타입 (CREATED, STARTED, STEP_START, STEP_END, COMPLETED, FAILED 등)
- step_name — VARCHAR(100) — 스테이지명
- status — VARCHAR(50) — 당시 상태
- details — LONGTEXT — 이벤트 상세 정보 (JSON)
- created_at — DATETIME — NOT NULL — 이벤트 발생일시
job_page
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- job_id — CHAR(36) — Foreign key → job.id — NOT NULL — 소속 작업 (FK → JOB)
- page_number — INT — NOT NULL — 페이지 번호 (1부터 시작)
- input_uri — VARCHAR(500) — NOT NULL — 입력 이미지 URI
- output_uri — VARCHAR(500) — 최종 IR URI
- status — VARCHAR(50) — NOT NULL — 상태 (PENDING, QUEUED, RUNNING, COMPLETED, FAILED)
- created_at — DATETIME — NOT NULL — 생성일시
- started_at — DATETIME — 처리 시작일시
- completed_at — DATETIME — 완료일시
model_registry
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- app_name — VARCHAR(50) — NOT NULL — 애플리케이션명
- model_name — VARCHAR(100) — NOT NULL — 모델명
- model_version — VARCHAR(50) — NOT NULL — 모델 버전
- model_path — VARCHAR(500) — NOT NULL — 모델 파일 경로
- model_config — LONGTEXT — 모델 설정 (JSON)
- model_type — VARCHAR(50) — NOT NULL — 모델 타입 (detection, recognition, classification)
- input_format — VARCHAR(100) — 입력 형식
- output_format — VARCHAR(100) — 출력 형식
- metadata — LONGTEXT — NOT NULL — 모델 메타데이터 (JSON)
- performance_metrics — LONGTEXT — 성능 메트릭 (JSON)
- gpu_memory_mb — INT — GPU 메모리 사용량 (MB)
- is_active — TINYINT — NOT NULL — 사용 가능 여부
- is_default — TINYINT — NOT NULL — 기본 모델 여부
- created_at — DATETIME — NOT NULL — 생성일시
- created_by_user_id — CHAR(36) — Foreign key → core_users.id — 모델 등록자 (FK → CORE_USERS)
- activated_at — DATETIME — 활성화일시
- activated_by_user_id — CHAR(36) — Foreign key → core_users.id — 활성화자 (FK → CORE_USERS)
pipeline
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- doc_kind — VARCHAR(50) — NOT NULL — 문서 종류
- pipeline_name — VARCHAR(100) — NOT NULL — 파이프라인명
- version — VARCHAR(20) — NOT NULL — 버전
- description — TEXT — 설명
- steps — LONGTEXT — NOT NULL — 파이프라인 단계 배열 (JSON)
- is_active — TINYINT — NOT NULL — 활성화 여부
- priority — INT — 우선순위
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
- created_by_user_id — CHAR(36) — Foreign key → core_users.id — 생성자 (FK → CORE_USERS)
- updated_by_user_id — CHAR(36) — Foreign key → core_users.id — 수정자 (FK → CORE_USERS)
pipeline_stage
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- pipeline_id — CHAR(36) — Foreign key → pipeline.id — NOT NULL — 소속 파이프라인 (FK → PIPELINE)
- stage_name — VARCHAR(100) — NOT NULL — 스테이지명
- endpoint — VARCHAR(100) — NOT NULL — Celery 큐 엔드포인트
- sequence — INT — NOT NULL — 실행 순서
- execution_mode — VARCHAR(20) — 실행 모드 (SEQUENTIAL, PARALLEL, CONDITIONAL)
- parallel_group — VARCHAR(50) — 병렬 그룹 ID
- branch_condition — LONGTEXT — 분기 조건 (JSON)
- config — LONGTEXT — 스테이지 설정 (JSON)
- model_id — CHAR(36) — Foreign key → model_registry.id — 모델 ID (FK → MODEL_REGISTRY)
- is_parallel — TINYINT — 다중 페이지 병렬 실행
- persist_result — TINYINT — 결과 DB 저장 여부
- timeout_seconds — INT — 타임아웃 (초)
- retry_count — INT — 재시도 횟수
- created_at — DATETIME — NOT NULL — 생성일시
stage_result
- id — CHAR(36) — Primary key — NOT NULL — 기본키
- job_page_id — CHAR(36) — Foreign key → job_page.id — NOT NULL — 대상 작업 페이지 (FK → JOB_PAGE)
- pipeline_stage_id — CHAR(36) — Foreign key → pipeline_stage.id — NOT NULL — 파이프라인 스테이지 (FK → PIPELINE_STAGE)
- stage_name — VARCHAR(100) — NOT NULL — 스테이지명 (캐시용)
- status — VARCHAR(50) — NOT NULL — 상태 (QUEUED, RUNNING, COMPLETED, FAILED, SKIPPED)
- input_params — LONGTEXT — 입력 파라미터 (JSON)
- output_data — LONGTEXT — 출력 데이터 (JSON)
- artifact_uri — VARCHAR(500) — 산출물 URI
- error_code — VARCHAR(20) — Foreign key → error_codes.code — 에러 코드 (FK → ERROR_CODES)
- error_message — TEXT — 에러 메시지
- attempt_count — INT — 시도 횟수
- processing_time_ms — INT — 처리 시간 (ms)
- created_at — DATETIME — NOT NULL — 생성일시
- started_at — DATETIME — 처리 시작일시
- completed_at — DATETIME — 완료일시
- expires_at — DATETIME — 자동 삭제 예정일