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 — 자동 삭제 예정일