docs/db · tbls 생성

HWSS DB 스키마

각 -core 모듈의 Flyway 마이그레이션을 실제 PostgreSQL 에 적용한 결과를 읽어 만든 명세서입니다. 소유 모듈 기준으로 자른 뷰포인트마다 ER 다이어그램과 테이블 목록이 있고, 테이블 이름을 누르면 컬럼·제약·인덱스 전문이 있는 GitHub 문서로 갑니다. 설명이 비어 있는 테이블은 마이그레이션에 COMMENT ON 이 아직 없다는 뜻입니다. 문서를 직접 고치지 않고 ./scripts/db-docs.sh 로 다시 생성합니다.

142테이블

1586컬럼

86관계

230마이그레이션

dev 기준 #2181 머지 11/13 17:36 · 커밋 b8b358b4 · 계기 Merge pull request #2181 from fdxchatgpt/feat/proto-front-parity-20261112 프로토·프론트 화면 차이 9건 동일화 (야간 20261112 아침 확인) 완료 · 2026-11-13 17:48 KST 빌드 · 빌드 런

변경 추적

최근 변경

최근 14일 · PR 35건 (최근 20건 표시)

dev 에 머지된 PR 중 이 가이드 범위의 파일을 바꾼 것입니다. 파일을 누르면 아래 해당 행으로 이동하고, 7일 이내에 바뀐 파일 행은 주황색으로 강조됩니다.

#2161	11/13 · 오늘	제목은 로그인 후 표시 README.mdpublic.agent_studio_deployments.mdpublic.customer_companies.mdpublic.customer_disclosure_links.mdpublic.document_types.mdpublic.folder_classification_mapping_confirmations.mdschema.jsonviewpoint-1.md+1
#2140	11/11 · 어제	제목은 로그인 후 표시 README.mdexternal/smartreview-views.mdpublic.dim_hospitals.mdschema.jsonviewpoint-5.md
#2132	11/11 · 어제	제목은 로그인 후 표시 README.mdpublic.agent_studio_deployments.mdpublic.agent_studio_summary_config_versions.mdpublic.agent_studio_test_run_corrections.mdpublic.agent_studio_test_run_report_items.mdpublic.agent_studio_test_run_steps.mdpublic.agent_studio_test_runs.mdschema.json+1
#2112	11/11 · 2일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_deployments.mdschema.jsonviewpoint-3.md
#2113	11/11 · 2일 전	제목은 로그인 후 표시 README.mdpublic.analysis_requests.mdpublic.classification_corrections.mdpublic.classification_result_pages.mdpublic.classification_results.mdpublic.extraction_results.mdpublic.image_system_outbound_requests.mdpublic.image_transfers.md+13
#2102	11/11 · 2일 전	제목은 로그인 후 표시 README.mdpublic.report_hospital_selections.mdschema.jsonviewpoint-4.md
#2058	11/10 · 3일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_test_run_files.mdpublic.agent_studio_test_runs.mdschema.jsonviewpoint-3.md
#2032	11/09 · 3일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_test_run_corrections.mdpublic.agent_studio_test_run_report_items.mdpublic.agent_studio_test_run_steps.mdpublic.agent_studio_test_runs.mdschema.jsonviewpoint-3.md
#2034	11/09 · 4일 전	제목은 로그인 후 표시 public.report_hospital_selections.mdschema.jsonviewpoint-4.md
#1963	11/08 · 4일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_test_run_corrections.mdpublic.agent_studio_test_run_steps.mdpublic.agent_studio_test_runs.mdschema.jsonviewpoint-3.md
#2007	11/08 · 4일 전	제목은 로그인 후 표시 README.mdpublic.analysis_requests.mdpublic.classification_results.mdpublic.extraction_results.mdpublic.image_transfers.mdpublic.investigation_reports.mdpublic.report_business_contracts.mdpublic.report_drafts.md+8
#1998	11/08 · 4일 전	제목은 로그인 후 표시 README.mdpublic.analysis_requests.mdpublic.classification_results.mdpublic.extraction_results.mdpublic.image_transfers.mdpublic.investigation_reports.mdpublic.report_business_contracts.mdpublic.report_drafts.md+6
#1969	11/07 · 5일 전	제목은 로그인 후 표시 README.mdpublic.auth_refresh_tokens.mdpublic.auth_sessions.mdpublic.departments.mdpublic.organization_change_tracking.mdpublic.role_menu_permissions.mdpublic.roles.mdpublic.user_change_acknowledgements.md+7
#1952	11/07 · 6일 전	제목은 로그인 후 표시 README.mdpublic.classification_result_pages.mdpublic.classification_results.mdschema.jsonviewpoint-3.md
#1949	11/06 · 6일 전	제목은 로그인 후 표시 README.mdpublic.report_stat_fact_details.mdpublic.report_stat_fact_main_diseases.mdpublic.report_stat_facts.mdschema.jsonviewpoint-5.md
#1935	11/06 · 6일 전	제목은 로그인 후 표시 README.mdpublic.customer_companies.mdpublic.document_types.mdschema.jsonviewpoint-1.md
#1941	11/06 · 6일 전	제목은 로그인 후 표시 README.mdpublic.analysis_request_claim_hospitals.mdpublic.analysis_requests.mdschema.jsonviewpoint-4.md
#1915	11/06 · 6일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_test_run_files.mdpublic.agent_studio_test_run_steps.mdpublic.agent_studio_test_runs.mdschema.jsonviewpoint-3.md
#1903	11/06 · 7일 전	제목은 로그인 후 표시 README.mdpublic.agent_document_types.mdpublic.folder_classification_mappings.mdschema.jsonviewpoint-1.md
#1867	11/05 · 8일 전	제목은 로그인 후 표시 README.mdpublic.agent_studio_summary_pairs.mdpublic.chat_attachment_sets.mdpublic.chat_attachments.mdpublic.chat_message_sources.mdpublic.chat_sessions.mdschema.jsonviewpoint-10.md+1

조직·사용자·권한GitHub

organization-core. 조직도·사용자와 레벨×메뉴 권한, 조직 변경 사원 확인 기록, 시스템 세션용 리프레시 토큰.

erDiagram

"public.departments" }o--o| "public.departments" : "parent_department_id"
"public.users" }o--|| "public.departments" : "department_id"
"public.role_menu_permissions" }o--|| "public.roles" : "role_code"
"public.user_roles" }o--|| "public.roles" : "role_code"

"public.departments" {}
"public.roles" {}
"public.users" {}
"public.role_menu_permissions" {}
"public.user_roles" {}

organization-core5일 전 · #1969 컬럼 7 부서 로컬 디렉터리 (자기 참조 트리) — users 와 같다. 연동이 켜지면 스마트심사 조직도 뷰가 대신한다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`department_code`UQ	varchar(30)	NOT NULL	조직도 상의 부서 코드(예: D0011). 외부(HR) 식별자라 자연키로 쓴다
`department_name`	varchar(100)	NOT NULL	부서 이름
`department_type`	varchar(20)	NOT NULL	HEADQUARTERS · DIVISION · TEAM · 본사/사업부/팀 구분
`parent_department_id`	bigint	NULL	→ departments.id · 상위 부서. 최상위는 비어 있고 트리 깊이는 제한하지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_departments_code (department_code)
idx_departments_parent (parent_department_id)

이 테이블을 참조하는 곳

departments · users

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 15 사용자 로컬 디렉터리 — 스마트심사 라이브 연동이 꺼진 환경에서 쓴다. 연동이 켜지면 신원·조직은 스마트심사 뷰에서 직접 읽고 이 표는 조회 경로에서 빠진다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`employee_no`UQ	varchar(50)	NOT NULL		사번. SSO 세션이 주는 유일한 식별자이므로 로그인·조회의 기준키다
`user_id`UQ	varchar(100)	NOT NULL		계정 아이디. 별도 로그인 화면의 입력값
`user_name`	varchar(100)	NOT NULL		이름
`position_name`	varchar(50)	NULL		직급(책임·선임·사원 …). HR 연동 값이며 조회 전용이다
`duty_name`	varchar(50)	NULL		직책(팀장·파트장·팀원 …)
`job_description`	varchar(200)	NULL		담당 업무 설명
`mobile_phone`	varchar(30)	NULL		휴대전화. 개인정보이며 로그 마스킹 대상
`office_phone`	varchar(30)	NULL		사무실 전화
`hire_date`	date	NULL		입사일
`department_id`	bigint	NOT NULL		→ departments.id · 소속 부서
`department_leader`	boolean	NOT NULL	false	부서장 여부. 조직도 표시와 승인 라인 판단에 쓴다
`account_status`	varchar(20)	NOT NULL		ACTIVE · INACTIVE · 계정 사용 상태
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_users_employee_no (employee_no)
uq_users_user_id (user_id)
idx_users_department (department_id)

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 4 사용자 부수정보 — 스마트심사 뷰가 주지 않는 값(권한 레벨·이메일)만 우리 DB 에 둔다

컬럼	타입		키·허용값·설명
`employee_no`PK	varchar(50)	NOT NULL	대상 사용자 사번
`email`	varchar(200)	NULL	알림·보고서 메일 발송 주소
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 6 사용자 권한 레벨 5종 — 레벨 자체는 시스템 상수이고, 라벨과 순서만 데이터로 두어 코드 배포 없이 바꿀 수 있게 한다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`role_code`UQ	varchar(30)	NOT NULL	IT_SUPER_ADMIN · ORG_HEAD · CENTER_HEAD · TEAM_LEAD · MEMBER · 권한 레벨 코드
`role_name`	varchar(50)	NOT NULL	화면에 보이는 레벨 이름 — 레벨 숫자(Lv1 일반사용자 … Lv5 IT 슈퍼관리자, 체계도 번호). 직책명은 쓰지 않는다
`level_order`UQ	integer	NOT NULL	레벨 위계 순서 — 권한 매트릭스 열 순서이자 대표 레벨 판정(작을수록 상위). 1 IT 슈퍼관리자 · 2 본부장·실장 · 3 단장·팀장 · 4 센터장·파트장 · 5 일반사용자 (docs/decisions/20261014-role-level-order-and-names.md)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_roles_code (role_code)
uq_roles_level_order (level_order)

이 테이블을 참조하는 곳

role_menu_permissions · user_roles

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 5 사용자별 권한 — 사용자:권한은 1:N 이다. 권한이 늘어도 이메일이 행마다 중복되지 않도록 부수정보와 분리했다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`employee_no`UQ	varchar(50)	NOT NULL	대상 사용자 사번
`role_code`UQ	varchar(30)	NOT NULL	→ roles.role_code · 부여된 권한 레벨
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_user_roles_employee_role (employee_no, role_code)
idx_user_roles_employee_no (employee_no)

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 14 권한 레벨 × 메뉴 사용 권한 — 메뉴 카탈로그(코드·라벨·콘솔·순서)를 따로 두지 않고 여기에 동봉한다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`role_code`UQ	varchar(30)	NOT NULL		→ roles.role_code · 대상 권한 레벨
`console_type`	varchar(20)	NOT NULL		USER · ADMIN · 메뉴가 속한 콘솔. 사용자/관리자 라우트와 1:1 대응한다
`menu_code`UQ	varchar(50)	NOT NULL		메뉴 코드
`menu_name`	varchar(100)	NOT NULL		메뉴 이름
`display_order`	integer	NOT NULL		사이드바 표시 순서 — 확정된 메뉴 IA 결정에 따른다
`allowed`	boolean	NOT NULL		이 레벨이 이 메뉴를 쓸 수 있는지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`menu_group_label`	varchar(100)	NULL		사이드바 1depth 묶음 라벨 — 그룹 머리 메뉴(예: AGENT_MANAGEMENT)와 그 아래 화면이 같은 값을 갖는다
`menu_section_label`	varchar(100)	NULL		사이드바 2depth 라벨 — 그룹 안에서 이 화면이 속한 단계(예: 분류·추출-요약·사전분석조건). 그룹 머리·단독 화면은 NULL
`first_approver`	boolean	NOT NULL	false	지식컬렉션 승인 메뉴(APPROVAL_CENTER) 행에서만 참일 수 있는 1차 승인 지정. 참이면 이 레벨은 조회와 1차 승인을 모두 맡고, 한 레벨만 지정한다(서비스가 보장)
`default_allowed`	boolean	NOT NULL	false	이 셀의 기본 허용 여부 — 권한 관리 화면이 `기본값`으로 되돌릴 기준. 저장값(allowed)과 독립이며 저장 API 가 바꾸지 않는다
`bound_to_menu_code`	varchar(50)	NULL		권한이 따로 갈 수 없는 행의 묶음 머리 메뉴 코드 — 값이 있으면 allowed·default_allowed 가 머리 행과 같다. 시드에는 묶인 행이 없다(공시실 링크 설정은 V202610261200 으로 퇴역) — 구조만 남겨 둔다

인덱스

uq_role_menu_permissions_role_menu (role_code, menu_code)
idx_role_menu_permissions_role (role_code)

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 7 refresh 토큰 원장 — 회전·무효화의 서버 측 상태. 폐기된 토큰이 다시 오면 탈취 신호로 보고 그 사번의 토큰을 모두 폐기한다

컬럼	타입		키·허용값·설명
`token_id`PK	varchar(36)	NOT NULL	토큰 식별자. 토큰 값 자체는 저장하지 않는다
`employee_no`	varchar(50)	NOT NULL	토큰 주인의 사번
`expires_at`	timestamptz	NOT NULL	만료 시각
`revoked_at`	timestamptz	NULL	폐기된 시각. 살아 있는 토큰은 비어 있다
`revoke_reason`	varchar(20)	NULL	폐기 사유 — 동시 재발급 유예는 회전(ROTATED)에만 적용된다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_auth_refresh_tokens_employee_no (employee_no)
idx_auth_refresh_tokens_expires_at (expires_at)

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 9 로그인 세션 — 유휴 만료와 로그아웃 판정의 서버 측 상태 (만료가 지난 행은 로그인 시점에 정리)

컬럼	타입		키·허용값·설명
`session_id`PK	varchar(36)	NOT NULL	세션 식별자 — 토큰의 sid 클레임. 회전·재발급해도 바뀌지 않는다
`employee_no`	varchar(50)	NOT NULL	세션 주인의 사번
`started_at`	timestamptz	NOT NULL	로그인 시각
`last_activity_at`	timestamptz	NOT NULL	마지막 활동 시각 — 사람이 일으킨 API 호출. 화면의 배경 요청은 올리지 않는다
`expires_at`	timestamptz	NOT NULL	세션 만료 시각 — 최초 refresh 토큰의 만료와 같다
`ended_at`	timestamptz	NULL	세션이 끝난 시각. 살아 있는 세션은 비어 있다
`end_reason`	varchar(20)	NULL	LOGOUT · IDLE · SECURITY · 끝난 사유 — LOGOUT(로그아웃)·IDLE(유휴 만료)·SECURITY(refresh 재사용 감지로 전 세션 무효화)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_auth_sessions_employee_no (employee_no)
idx_auth_sessions_expires_at (expires_at)

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 4 조직 변경 사원 추적 설정 — 한 행. 기준 시각 이전의 인사 변경은 변경 대상자로 보지 않는다

컬럼	타입		키·허용값·설명
`id`PK	smallint	NOT NULL	고정 1 — 한 행만 둔다
`baseline_at`	timestamptz	NOT NULL	기준 시각 — 이 기능의 마이그레이션이 적용된 시각(서버별 첫 배포). 이후 변경만 대상자다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 6 조직 변경 확인 기록 — 사원별로 관리자가 확인한 마지막 인사 변경. 원천의 변경일시가 이 값과 다르면 다시 변경 대상자다

컬럼	타입		키·허용값·설명
`employee_no`PK	varchar(50)	NOT NULL	사번
`acknowledged_changed_at`	timestamp	NOT NULL	확인한 변경일시 — 확인 완료 때 원천(VW_AI_UVORG002_HIS.LAST_CHNG_DTTM)에 있던 값 그대로, 시간대 없는 한국 시각
`acknowledged_by`	varchar(50)	NOT NULL	확인한 관리자 사번
`acknowledged_at`	timestamptz	NOT NULL	확인 완료를 누른 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

제약 정의 전문 (GitHub)

organization-core5일 전 · #1969 컬럼 2 로컬·CI 표본 — 사원별 최종 인사 변경일시. 운영·개발 서버는 스마트심사 뷰 VW_AI_UVORG002_HIS 를 라이브로 읽고 이 표는 쓰지 않는다

컬럼	타입		기본값	키·허용값·설명
`employee_no`PK	varchar(50)	NOT NULL		사번
`last_changed_at`	timestamp	NOT NULL		최종 변경일시 — 소속·직책·직급이 바뀐 때, 시간대 없는 한국 시각

제약 정의 전문 (GitHub)

마스터 데이터GitHub

classification-core. 위탁사와 문서종 분류체계, 폴더 매핑과 확정 이력, 위탁사별 공시실 링크.

erDiagram

"public.document_types" }o--|| "public.customer_companies" : "customer_company_code"
"public.folder_classification_mappings" }o--|| "public.document_types" : "customer_company_code, document_type_code"
"public.folder_classification_mappings" }o--|| "public.agent_document_types" : "agent_document_type_code"
"public.customer_disclosure_links" |o--|| "public.customer_companies" : "customer_company_code"
"public.folder_classification_mapping_confirmations" }o--|| "public.customer_companies" : "customer_company_code"

"public.customer_companies" {}
"public.document_types" {}
"public.agent_document_types" {}
"public.folder_classification_mappings" {}
"public.customer_disclosure_links" {}
"public.folder_classification_mapping_confirmations" {}

classification-core오늘 · #2161 컬럼 13 위탁사 마스터 — 이미지 시스템 API-06 동기화가 원천이며, 최초 기동은 2026-11-06 개발 기준정보로 채운다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL		위탁사 코드. 다른 도메인이 FK 없이 이 값으로만 참조한다
`customer_company_name`	varchar(200)	NOT NULL		위탁사 이름
`active`	boolean	NOT NULL	true	사용 여부. 원본 마스터의 삭제는 비활성으로 표현된다
`changed_at`	timestamptz	NOT NULL		원본 마스터의 변경 시각. 과거 이벤트를 뒤늦게 받았을 때 무시 판단에 쓴다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`document_type_contract_id`	varchar(100)	NULL		API-07로 마지막 동기화된 문서분류 계약 식별자
`document_type_contract_changed_at`	timestamptz	NULL		문서분류 계약이 이미지시스템에서 변경된 시각
`onboarding_received_at`	timestamptz	NULL		신규 위탁사로 처음 수신한 시각. 이 컬럼 도입 이전부터 있던 위탁사는 NULL(온보딩 대상 아님)
`report_delivery_channel`	varchar(20)	NULL		MAIL · SMART_REVIEW · 보고서 초안 전송 방식(MAIL 메일 발송 / SMART_REVIEW 스마트심사 전송). NULL = 아직 고르지 않음(새로 수신한 위탁사)
`smart_review_partner_code`	varchar(10)	NULL		스마트심사 대외사 코드(예: A099). NULL 이면 스마트심사로 전송할 수 없다
`studio_change_review_required`	boolean	NOT NULL	false	에이전트 스튜디오 배포 대기 뒤 분류체계 매핑 확정이 남았는지 — 대기 때 켜고 매핑 확정이 끈다

인덱스

uq_customer_companies_code (customer_company_code)

이 테이블을 참조하는 곳

customer_disclosure_links · document_types · folder_classification_mapping_confirmations

제약 정의 전문 (GitHub)

classification-core오늘 · #2161 컬럼 6 위탁사별 공시실 링크 — 관리자 `공시실 링크 설정` 화면이 관리하는 URL 한 건과 노출 여부

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL		→ customer_companies.customer_company_code · 링크가 속한 위탁사 업무 코드 (customer_companies 참조, 위탁사당 1행)
`disclosure_url`	varchar(2048)	NOT NULL		사용자에게 열어 줄 공시실 주소. 공백만은 저장되지 않으며 형식 검증은 없다
`active`	boolean	NOT NULL	false	사용자 노출 여부. URL 이 없으면 켤 수 없다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_customer_disclosure_links_company (customer_company_code)

제약 정의 전문 (GitHub)

classification-core오늘 · #2161 컬럼 13 위탁사별 이미지시스템 폴더 분류 체계 — API-07 동기화가 원천이며, 최초 기동은 2026-11-06 개발 기준정보로 채운다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL		→ customer_companies.customer_company_code · 이 분류 체계를 쓰는 위탁사
`document_type_code`UQ	varchar(100)	NOT NULL		폴더 분류 코드. 위탁사 안에서 유일하다
`document_type_name`	varchar(200)	NOT NULL		폴더 분류 이름
`parent_document_type_code`	varchar(100)	NULL		상위 폴더 코드. 최상위는 비어 있다
`display_order`	integer	NOT NULL	0	같은 계층 안에서의 표시 순서
`active`	boolean	NOT NULL	true	사용 여부. 원본 마스터의 삭제는 비활성으로 표현된다
`model_mapping_status`	varchar(20)	NOT NULL	'PENDING'	MAPPED · PENDING · NOT_REQUIRED · 에이전트 분류로의 매핑이 갖춰졌는지
`changed_at`	timestamptz	NOT NULL		원본 마스터의 변경 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`folder_bundle_code`	varchar(100)	NULL		번호로 나뉜 폴더 묶음의 이름(위탁사 안에서 유일). NULL 이면 이름으로 짐작한다
`folder_bundle_ordinal`	integer	NULL		묶음 안 순번(1부터). 병원 순번이 이 값을 넘으면 묶음의 마지막 폴더를 쓴다

인덱스

uq_document_types_company_code (customer_company_code, document_type_code)
idx_document_types_company (customer_company_code)

이 테이블을 참조하는 곳

folder_classification_mappings

제약 정의 전문 (GitHub)

classification-core7일 전 · #1903 컬럼 8 낱장 단위 에이전트 분류 체계 마스터 — 위탁사와 무관한 공통 체계. 온톨로지 정의서 v2.0 2차_classify class_name(수동분류 매칭 v4: 세부 147종 + 표지 세분 4종 + 미분류)과 대분류 표지

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`agent_document_type_code`UQ	varchar(100)	NOT NULL		에이전트 분류 코드 (진단서·처방전 등 문서종)
`agent_document_type_name`	varchar(200)	NOT NULL		에이전트 분류 이름
`active`	boolean	NOT NULL	true	사용 여부
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`major_category`	varchar(50)	NOT NULL		온톨로지 대분류 (병원서류·손해사정문서·관공서서류·간병인서류·자문서류·표지·미분류)
`extraction_method`	varchar(20)	NOT NULL		EXTRACT · INSTRUCT · NONE · 정보추출 방식 — EXTRACT(항목 추출)·INSTRUCT(지시 기반 요약)·NONE(정보추출 대상 아님)

인덱스

uq_agent_document_types_code (agent_document_type_code)

이 테이블을 참조하는 곳

folder_classification_mappings

제약 정의 전문 (GitHub)

classification-core7일 전 · #1903 컬럼 7 위탁사별 이미지시스템 폴더 ↔ 에이전트 문서종 매핑. 문서종 하나가 폴더 여럿에 배정될 수 있다(N:M, 2026-09-28)

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL		→ document_types.customer_company_code · 이 매핑이 적용되는 위탁사
`document_type_code`UQ	varchar(100)	NOT NULL		→ document_types.document_type_code · 대상 폴더 분류
`agent_document_type_code`UQ	varchar(100)	NOT NULL		→ agent_document_types.agent_document_type_code · 그 폴더로 보낼 에이전트 분류
`active`	boolean	NOT NULL	true	사용 여부. 비활성 매핑은 자동분류에서 무시한다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_folder_classification_mappings_folder (customer_company_code, document_type_code)
uq_folder_classification_mappings (customer_company_code, document_type_code, agent_document_type_code)

제약 정의 전문 (GitHub)

classification-core오늘 · #2161 컬럼 9 위탁사별 분류체계 매핑 확정 이력 — 확정 1건이 1행(우리 DB 안의 확정 기록, 외부 전송 이력이 아니다)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL	→ customer_companies.customer_company_code · 확정이 속한 위탁사 업무 코드 (customer_companies 참조)
`confirmed_version`UQ	integer	NOT NULL	위탁사 안에서 1부터 올라가는 확정 번호 — 화면 배너의 `확정본과 동일 — vN`
`confirmed_at`	timestamptz	NOT NULL	관리자가 매핑을 확정한 시각
`confirmed_by`	varchar(50)	NOT NULL	확정한 사람의 사번 (세션 식별 기준키)
`changed_assignment_count`	integer	NOT NULL	이번 확정으로 배정이 달라진 에이전트 분류 수 — 추가·제거·교체를 각각 1건으로 센다
`folder_count`	integer	NOT NULL	확정 시점에 확정 대상이던 활성 폴더 수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_folder_classification_mapping_confirmations_version (customer_company_code, confirmed_version)
ix_folder_classification_mapping_confirmations_company (customer_company_code, confirmed_version)

제약 정의 전문 (GitHub)

보고서 접수·이미지 연동GitHub

investigation-core. 보고서, 이미지 시스템에서 받은 전송 건과 낱장. 전송(image_transfers·transfer_pages)은 접수 이력이고 report_pages 가 현재 문서함이다.

erDiagram

"public.image_transfers" }o--|| "public.investigation_reports" : "report_no"
"public.transfer_pages" }o--|| "public.image_transfers" : "transfer_id"
"public.report_pages" }o--|| "public.investigation_reports" : "report_no"
"public.report_business_contracts" }o--|| "public.investigation_reports" : "report_no"

"public.investigation_reports" {}
"public.image_transfers" {}
"public.transfer_pages" {}
"public.report_pages" {}
"public.report_business_contracts" {}

investigation-core2일 전 · #2113 컬럼 28 사고조사 보고서 — 접수번호 단위의 업무 건. 화면 목록과 처리 파이프라인이 모두 이 행을 기준으로 돈다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		접수번호. 이미지 시스템과 공유하는 업무 건 식별자이며 다른 테이블이 이 값으로 참조한다
`customer_company_code`	varchar(50)	NOT NULL		위탁사 코드. 마스터는 다른 도메인 소유라 FK 를 두지 않는다
`insured_name`	varchar(200)	NULL		피보험자명. 개인정보이며 로그 마스킹 대상
`investigator_employee_no`	varchar(50)	NULL		담당 조사자 사번
`consignment_type`	varchar(20)	NULL		LONG_TERM · LIFE · 위탁 구분 (장기/생명)
`list_status`	varchar(40)	NOT NULL		BEFORE_CONFIRM · CLASSIFYING · UNCLASSIFIED_DETECTED · EXTRACTING · EXTRACTION_COMPLETED · ANALYZING · ANALYSIS_COMPLETED · TRANSFER_COMPLETED · 목록 화면에 보이는 상태. 화면 스테퍼가 쓰는 값이다
`processing_status`	varchar(40)	NOT NULL		WAITING_FOR_TRANSFER · RECEIVED · VALIDATING · READY_FOR_CONFIRM · CLASSIFYING · EXTRACTING · UNCLASSIFIED_DETECTED · EXTRACTION_COMPLETED · ANALYZING · ANALYSIS_COMPLETED · REANALYSIS_REQUIRED · PROCESSING_FAILED · COMPLETED · TRANSFER_FAILED · 내부 처리 상태. 워크플로우 단계 진입 조건이 이 값으로 판정된다
`snapshot_baseline_status`	varchar(40)	NOT NULL	'NOT_CONFIRMED'	NOT_CONFIRMED · CONFIRMED_BASELINE · CHANGED_AFTER_BASELINE · 확정 기준 스냅샷이 잡혔는지, 잡힌 뒤 바뀌었는지
`confirmed_snapshot_transfer_id`	uuid	NULL		처리 기준으로 확정한 전송. 순환 FK 를 피해 값만 보관한다
`latest_accepted_transfer_id`	uuid	NULL		가장 최근에 정상 접수된 전송
`changed_after_confirm`	boolean	NOT NULL	false	확정 이후 변경이 들어왔는지. 목록 상태가 아니라 플래그로 관리한다
`has_unclassified_documents`	boolean	NOT NULL	false	미분류 낱장이 남아 있는지
`has_low_confidence_documents`	boolean	NOT NULL	false	분류 신뢰도가 낮은 낱장이 있는지
`report_draft_status`	varchar(20)	NOT NULL	'NONE'	NONE · GENERATING · READY · CONFIRMED · DISCARDED · 보고서 초안 진행 상태. NONE·GENERATING·READY(항목 선택 완료)·CONFIRMED(폐지, READY 와 같음)·DISCARDED(확정 초기화로 폐기)
`latest_raw_metadata`	jsonb	NULL		최신 시작 통지 원문 캐시. 전송별 원문은 image_transfers.raw_metadata 에 남는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`confirm_requested_at`	timestamptz	NULL		ZIP 검증 중에 들어온 확정 요청을 기억해 두는 자리. 검증이 끝나면 이어서 처리한다
`claim_type`	varchar(200)	NULL		사고조사 상세 화면에서 입력한 청구유형
`has_low_confidence_extraction`	boolean	NOT NULL	false	추출 완료 시 신뢰도가 임계 미만인 추출값이 있었는지. 분석 시작 때 해제된다
`reclassification_reserved_at`	timestamptz	NULL		분류·추출 중 재확정으로 걸린 재분류 예약을 처음 받은 시각. 비어 있으면 예약 없음, 소비되면 비운다
`reclassification_last_confirmed_at`	timestamptz	NULL		예약에 합쳐진 마지막 확정의 요청 시각. 예약과 함께 비운다
`carry_classification_corrections`	boolean	NOT NULL	false	다음 분류 결과에 직전 결과의 사용자 분류 지정을 다시 적용할지. 문서 편집 반영 분류부터에서 켜고, 결과를 만들 때 비운다
`classification_queued_at`	timestamptz	NULL		동시 AI 작업 한도로 자동 분류 시작이 대기열에 들어간 시각. 비어 있으면 대기 아님, 분류가 시작되면 비운다
`has_reference_mismatch`	boolean	NOT NULL	false	추출한 환자명이 피보험자 이름과 다른 항목이 있는지. 분석 시작 때 해제된다
`has_hospital_match_required`	boolean	NOT NULL	false	추출한 병원명 중 병원 목록에서 한 곳으로 정해지지 않은 것이 있는지. 분석 시작 때 해제된다
`incremental_base_classification_version`	integer	NULL		다시 분석 증분이 기다리는 기준 분류 버전 — CLASSIFY 단계가 기준 버전에 없는 낱장만 분류해 합친 뒤 비운다

인덱스

uq_investigation_reports_report_no (report_no)
idx_investigation_reports_company (customer_company_code)
idx_investigation_reports_list_status (list_status)
idx_investigation_reports_created_at (created_at, id)
idx_investigation_reports_classification_queue (investigator_employee_no, classification_queued_at)

이 테이블을 참조하는 곳

analysis_requests · classification_results · extraction_results · image_transfers · report_business_contracts · report_drafts · report_mail_dispatches · report_pages · smart_review_transfers · summary_results

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 9 API-01 접수 시 Smart심사 조사정보 View에서 조회해 저장한 보고서별 계약 메타데이터 스냅샷

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	→ investigation_reports.report_no · 계약정보가 속한 사고조사 보고서번호
`sequence_no`UQ	integer	NOT NULL	같은 보고서 안에서 계약 조회 결과에 부여한 표시 순번
`external_company_code`	varchar(10)	NULL	Smart심사 대외사 코드
`policy_no`	varchar(50)	NULL	증권번호
`product_name`	varchar(200)	NULL	보험 상품명
`contract_date`	date	NULL	보험 계약일자
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_business_contracts (report_no, sequence_no)
idx_report_business_contracts_report_no (report_no, sequence_no)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 19 이미지 시스템에서 받은 전송 묶음 — 접수 이력이다. 현재 문서함은 report_pages 쪽이다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`transfer_id`UQ	uuid	NOT NULL		이미지 시스템이 발급한 전송 식별자
`report_no`	varchar(100)	NOT NULL		→ investigation_reports.report_no · 이 전송이 속한 보고서의 접수번호
`transfer_type`	varchar(20)	NOT NULL		INITIAL · CHANGE · LOGICAL · 전송 갈래 — 최초/추가/논리 변경
`transfer_status`	varchar(30)	NOT NULL		WAITING_FOR_TRANSFER · VALIDATING · ACCEPTED · FAILED · 접수·검증 진행 상태
`zip_file_name`	varchar(255)	NULL		수신한 ZIP 파일명. 논리 변경 전송에는 ZIP 이 없다
`zip_sha256`	varchar(64)	NULL		수신한 ZIP 의 내용 해시
`page_count`	integer	NOT NULL	0	전송이 선언한 낱장 수
`occurred_at`	timestamptz	NOT NULL		이미지 시스템이 확정한 발생 시각
`started_at`	timestamptz	NULL		전송 시작 통지를 받은 시각
`completed_at`	timestamptz	NULL		전송 완료 통지를 받은 시각
`accepted_at`	timestamptz	NULL		정상 접수로 판정한 시각. 미반영 논리 변경 선처리의 순서 기준이다
`applied_at`	timestamptz	NULL		스냅샷에 반영한 시각. 비어 있으면 미반영 = 선처리 대상
`raw_metadata`	jsonb	NULL		수신한 통지 본문 원문
`failure_reason`	varchar(100)	NULL		접수·검증 실패 사유
`idempotency_key`UQ	uuid	NOT NULL		재통지(중복 수신) 판정 키. 전송 단위로 유일하다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`extraction_claimed_at`	timestamptz	NULL		압축 해제를 맡긴(또는 시작한) 시각 — VALIDATING 이 임대보다 오래 이 값 그대로면 재기동으로 끊긴 것으로 보고 다시 맡긴다

인덱스

uq_image_transfers_transfer_id (transfer_id)
uq_image_transfers_idempotency_key (idempotency_key)
idx_image_transfers_report_pending (report_no, applied_at, accepted_at)

이 테이블을 참조하는 곳

transfer_pages

제약 정의 전문 (GitHub)

investigation-core 컬럼 15 보고서번호별 이미지 전송 백그라운드 작업의 영속 대기열

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL		이미지 전송 작업을 직렬화하는 보고서번호
`job_type`	varchar(50)	NOT NULL		등록된 작업 처리기 유형
`payload`	text	NOT NULL		작업 처리기에 전달할 영속 문자열 페이로드
`idempotency_key`UQ	varchar(200)	NOT NULL		동일 작업 중복 등록 방지 키
`status`	varchar(20)	NOT NULL	'PENDING'	PENDING · RUNNING · SUCCEEDED · FAILED · 작업 상태: PENDING, RUNNING, SUCCEEDED, FAILED
`attempt_count`	integer	NOT NULL	0	임대를 획득해 실제 실행을 시작한 횟수
`max_attempts`	integer	NOT NULL		실행 실패 후 재시도할 수 있는 최대 횟수
`available_at`	timestamptz	NOT NULL		대기 작업을 다시 가져갈 수 있는 가장 이른 시각
`locked_by`	varchar(100)	NULL		현재 작업 임대를 보유한 애플리케이션 인스턴스 식별자
`locked_until`	timestamptz	NULL		인스턴스 장애 시 다른 인스턴스가 회수할 수 있는 임대 만료 시각
`last_error`	text	NULL		마지막 실행 실패 원인
`completed_at`	timestamptz	NULL		작업이 성공 또는 최종 실패로 끝난 시각
`created_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP

인덱스

uq_image_transfer_background_jobs_idempotency (idempotency_key)
ix_image_transfer_background_jobs_due (status, available_at, id)
ix_image_transfer_background_jobs_report_order (report_no, id)
ix_image_transfer_background_jobs_lease (status, locked_until)

제약 정의 전문 (GitHub)

investigation-core 컬럼 15 전송이 선언한 낱장 목록 — 통지 원문의 스냅샷이라 뒤에 바뀌지 않는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`transfer_id`UQ	uuid	NOT NULL		→ image_transfers.transfer_id · 이 낱장을 선언한 전송
`source_page_id`UQ	varchar(100)	NOT NULL		이미지 시스템의 불변 낱장 식별자
`change_status`	varchar(10)	NOT NULL	''	ADD · · MOVE · DELETE · 이 전송에서의 변경 갈래. 빈 문자열은 "유지"를 뜻한다
`page_no`	integer	NULL		문서함에서의 낱장 순서. 삭제 통지에는 순서 정보가 없다
`document_order`	integer	NULL		같은 문서종 묶음 안에서의 순서
`file_name`	varchar(255)	NULL		원본 파일명
`file_size_bytes`	bigint	NULL		선언된 파일 크기(byte)
`sha256`	varchar(64)	NULL		선언된 내용 해시
`document_type_code`	varchar(100)	NULL		이미지시스템 폴더 분류 코드
`document_type_name`	varchar(200)	NULL		이미지시스템 폴더 분류 이름
`validation_status`	varchar(20)	NOT NULL	'PENDING'	PENDING · VALID · INVALID · ZIP 안 실제 파일과 대조한 검증 결과
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`mfileid`	varchar(100)	NULL		이미지 시스템 아카이브 파일 ID. 기존 행과 삭제 통지에는 없을 수 있다

인덱스

uq_transfer_pages_page (transfer_id, source_page_id)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 24 보고서의 현재 문서함 — 전송들을 반영한 결과의 구체화 뷰. 화면이 보는 것은 이 표다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	→ investigation_reports.report_no · 이 낱장이 속한 보고서의 접수번호
`source_page_id`UQ	varchar(100)	NOT NULL	이미지 시스템의 불변 낱장 식별자. 접수번호와 함께 이 낱장을 찾는 키다. PDF 에서 풀어낸 낱장은 원본 식별자에 -p0001 형태의 쪽 번호를 붙인다
`page_no`	integer	NOT NULL	이미지시스템 스냅샷 기준 순서. PDF 에서 풀어낸 낱장은 원본 행의 값을 따른다 — 화면의 낱장 번호는 이 값과 sheet_index 순으로 다시 센다
`document_order`	integer	NOT NULL	같은 문서종 묶음 안에서의 순서
`document_type_code`	varchar(100)	NULL	이미지시스템 폴더 분류 코드
`document_type_name`	varchar(200)	NULL	이미지시스템 폴더 분류 이름
`storage_path`	varchar(500)	NOT NULL	해제된 낱장 파일의 내부 저장 경로. 파일 위치는 이 값에서만 나온다
`file_size_bytes`	bigint	NOT NULL	실제 기록한 파일 크기(byte)
`sha256`	varchar(64)	NOT NULL	실제 기록한 내용 해시
`origin_transfer_id`	uuid	NOT NULL	이 파일이 들어온 전송
`deleted_at`	timestamptz	NULL	삭제 통지를 반영한 시각. 비어 있는 행만 활성 낱장이다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`file_name`	varchar(255)	NOT NULL	API-01에서 수신한 페이지 원본 파일명
`mfileid`	varchar(100)	NULL	현재 페이지의 이미지 시스템 아카이브 파일 ID
`parent_source_page_id`	varchar(100)	NULL	PDF 에서 풀어낸 낱장이면 그 PDF 원본 행의 source_page_id. 이미지시스템이 보낸 행은 비어 있다
`sheet_index`	integer	NULL	PDF 에서 풀어낸 낱장이면 그 PDF 안의 쪽 번호(1부터)
`sheet_count`	integer	NULL	이 행이 낱장으로 풀린 PDF 원본이면 그 쪽 수. 값이 있는 행은 화면·문서 AI 플랫폼에 낱장으로 나가지 않는다
`image_system_document_type_id`	varchar(100)	NULL	API-09·10 재배분 응답의 이미지시스템 최종 문서분류 ID
`image_system_file_order`	integer	NULL	API-09·10 재배분 응답의 문서분류 폴더 내부 순서
`image_system_deleted`	boolean	NULL	API-09·10 재배분 응답의 이미지시스템 최종 삭제 여부
`image_system_last_user_id`	varchar(100)	NULL	API-09·10 재배분 응답의 최종 변경 사용자 ID
`image_system_last_time`	varchar(19)	NULL	API-09·10 재배분 응답의 최종 변경 시각 문자열

인덱스

uq_report_pages_page (report_no, source_page_id)
idx_report_pages_report_order (report_no, page_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 스캔 문서함 낱장 편집(삭제 예정·표시 순서)의 저장분. report_pages 에 겹쳐 보는 오버레이

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		접수번호 — report_pages 와 같은 값. FK 는 두지 않는다
`source_page_id`UQ	varchar(100)	NOT NULL		편집 대상 낱장의 이미지시스템 페이지 식별자
`deleted`	boolean	NOT NULL	false	사용자가 지운 낱장인가. 참이면 문서함 목록과 장수에서 빠진다
`display_order`	integer	NULL		사용자가 정한 화면 표시 순서(0부터). 순서를 건드리지 않은 낱장은 NULL
`edited_by_employee_no`	varchar(50)	NULL		편집을 저장한 사람의 사번. 담당자 없는 건의 비인증 저장은 NULL
`edited_at`	timestamptz	NOT NULL		편집을 저장한 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_page_edits_page (report_no, source_page_id)

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 이미지 시스템 쓰기 API 의 멱등 키 원장 — 같은 키의 재요청을 가려낸다

컬럼	타입		키·허용값·설명
`id`PK	uuid	NOT NULL
`endpoint`UQ	varchar(200)	NOT NULL	요청을 받은 엔드포인트
`source_system`UQ	varchar(50)	NOT NULL	요청을 보낸 시스템
`idempotency_key`UQ	uuid	NOT NULL	요청이 제시한 멱등 키
`request_hash`	varchar(64)	NOT NULL	요청 본문 해시. 같은 키로 다른 본문이 오면 충돌로 본다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_image_integration_idempotency (endpoint, source_system, idempotency_key)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 11 이미지시스템 API-09·10 발신 시도 및 최종 결과 원장

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL		발신 원장 식별자
`report_no`	varchar(100)	NOT NULL		사고조사 번호
`api_code`	varchar(10)	NOT NULL		API-09 · API-10 · 발신 API 구분(API-09 또는 API-10)
`idempotency_key`UQ	uuid	NOT NULL		모든 재시도에서 동일하게 사용하는 멱등 키
`classification_result_id`	bigint	NULL		→ classification_results.id · API-09가 반영하는 분류 결과 식별자
`status`	varchar(20)	NOT NULL		PROCESSING · SUCCESS · FAILED · PROCESSING, SUCCESS, FAILED
`attempt_count`	integer	NOT NULL	0	최초 호출을 포함한 실제 전송 시도 횟수
`last_error`	text	NULL		마지막 실패 예외 메시지
`completed_at`	timestamptz	NULL		성공 또는 최종 실패 종료 시각
`created_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP	생성 시각
`updated_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP	수정 시각

인덱스

uk_image_system_outbound_requests_key (idempotency_key)
idx_image_system_outbound_requests_report (report_no, created_at)

제약 정의 전문 (GitHub)

문서 분석 (분류·추출·요약)GitHub

investigation-core. 에이전트 파이프라인의 단계별 결과와 사용자 수정 이력, 에이전트 스튜디오 문서 분류·추출 스키마 저장본(단계별 버전).

erDiagram

"public.classification_result_pages" }o--|| "public.classification_results" : "classification_result_id"
"public.extraction_result_fields" }o--|| "public.extraction_results" : "extraction_result_id"
"public.summary_cards" }o--|| "public.summary_results" : "summary_result_id"
"public.summary_cards" }o--o| "public.summary_sections" : "summary_section_id"
"public.summary_items" }o--|| "public.summary_cards" : "summary_card_id"
"public.summary_item_sources" }o--|| "public.summary_items" : "summary_item_id"
"public.classification_corrections" }o--|| "public.classification_results" : "classification_result_id"
"public.extraction_field_corrections" }o--|| "public.extraction_results" : "extraction_result_id"
"public.extraction_field_corrections" }o--|| "public.extraction_result_fields" : "extraction_result_field_id"
"public.summary_sections" }o--|| "public.summary_results" : "summary_result_id"
"public.summary_group_document_types" }o--|| "public.summary_groups" : "summary_group_id"
"public.agent_studio_document_categories" }o--|| "public.agent_studio_schema_versions" : "version_id"
"public.agent_studio_document_types" }o--|| "public.agent_studio_schema_versions" : "version_id"
"public.agent_studio_extraction_fields" }o--|| "public.agent_studio_schema_versions" : "version_id"
"public.agent_studio_extraction_fields" }o--o| "public.agent_studio_extraction_fields" : "parent_field_id"
"public.agent_studio_test_run_files" }o--|| "public.agent_studio_test_runs" : "run_id"
"public.agent_studio_test_run_steps" }o--|| "public.agent_studio_test_runs" : "run_id"
"public.agent_studio_test_run_corrections" |o--|| "public.agent_studio_test_run_steps" : "step_id"
"public.agent_studio_test_run_report_items" }o--|| "public.agent_studio_test_run_steps" : "step_id"

"public.classification_results" {}
"public.classification_result_pages" {}
"public.extraction_results" {}
"public.extraction_result_fields" {}
"public.summary_results" {}
"public.summary_cards" {}
"public.summary_items" {}
"public.summary_item_sources" {}
"public.classification_corrections" {}
"public.extraction_field_corrections" {}
"public.summary_sections" {}
"public.summary_groups" {}
"public.summary_group_document_types" {}
"public.agent_studio_schema_versions" {}
"public.agent_studio_document_categories" {}
"public.agent_studio_document_types" {}
"public.agent_studio_extraction_fields" {}
"public.agent_studio_test_runs" {}
"public.agent_studio_test_run_files" {}
"public.agent_studio_test_run_steps" {}
"public.agent_studio_test_run_corrections" {}
"public.agent_studio_test_run_report_items" {}

investigation-core2일 전 · #2113 컬럼 11 분류 결과 한 벌 — 버전으로 쌓는다. 재분류가 이전 결과를 지우지 않아야 무엇이 달라졌는지 볼 수 있다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		→ investigation_reports.report_no · 대상 보고서의 접수번호
`classification_version`UQ	integer	NOT NULL		보고서 안에서의 분류 회차
`source_transfer_id`	uuid	NOT NULL		이 결과를 산출한 기준 전송
`finalized_at`	timestamptz	NULL		외부 반영을 확정한 시각
`pushed_at`	timestamptz	NULL		이미지 시스템에 역반영한 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`external_job_id`	varchar(200)	NULL		외부 실행(Studio Job) 참조. 레줌 재실행이 이 값을 필요로 한다
`provenance`	varchar(10)	NOT NULL	'STUB'	STUB · LIVE · 결과의 근원 — 실제 에이전트 응답인지 스텁인지
`source_job_ids`	varchar(2000)	NULL		이 결과를 만든 분류 Job 들(분류 차수 순, 쉼표 구분). 증분으로 합친 결과만 채운다 — 비어 있으면 external_job_id 하나

인덱스

uq_classification_results_version (report_no, classification_version)

이 테이블을 참조하는 곳

classification_corrections · classification_result_pages · image_system_outbound_requests

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 14 낱장별 분류 결과 — 분류 결과 한 벌에 속한 행들

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`classification_result_id`UQ	bigint	NOT NULL	→ classification_results.id · 이 행이 속한 분류 결과 한 벌
`source_page_id`UQ	varchar(100)	NOT NULL	대상 낱장 식별자
`agent_document_type_code`	varchar(100)	NULL	에이전트가 판정한 문서종. 미분류는 비어 있다
`agent_document_type_name`	varchar(200)	NULL	문서종 이름
`confidence`	numeric(4,3)	NULL	분류 신뢰도(0~1). 임계값 미달이면 저신뢰로 본다
`classification_status`	varchar(20)	NOT NULL	CLASSIFIED · UNCLASSIFIED · REVIEW_REQUIRED · 이 낱장의 분류 확정 상태
`result_source`	varchar(20)	NOT NULL	AI_AUTO · MANUAL · 이 값이 에이전트 판정인지 사용자 보정인지
`image_folder_type_code`	varchar(100)	NULL	이미지 시스템에 역반영할 폴더 분류
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`document_group_no`	integer	NULL	분류가 낱장을 묶은 문서의 순번(결과 한 벌 안에서 1부터). 같은 값의 낱장은 한 문서다. 묶음 정보가 없는 결과(스텁·기존 판)는 NULL
`hospital_name`	varchar(200)	NULL	분류가 이 낱장이 속한 문서에서 읽은 병원명. 병원 서류가 아니거나 분류가 주지 않았으면(스텁·기존 판·수동 지정) NULL
`classification_batch_no`	smallint	NULL	이 낱장을 판정한 분류 차수(1부터, 비어 있으면 1). 증분 추가분은 다음 차수 — 병원 구간을 차수 경계에서 끊는다

인덱스

uq_classification_result_pages_page (classification_result_id, source_page_id)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 21 분류 보정 원장 — 결과 행을 덮어쓰기 전후를 남긴다. 외부에 보낼 델타이자 되돌리기·감사의 근거

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`classification_result_id`	bigint	NOT NULL		→ classification_results.id · 보정 대상 분류 결과 한 벌
`source_page_id`	varchar(100)	NOT NULL		보정 대상 낱장
`correction_type`	varchar(20)	NOT NULL		MANUAL_ASSIGN · AI_CONFIRM · 보정 갈래 — 문서종 직접 지정 / 저신뢰 분류 그대로 확정
`previous_document_type_code`	varchar(100)	NULL		보정 직전 문서종. 델타의 "from"
`previous_document_type_name`	varchar(200)	NULL		보정 직전 문서종 이름
`previous_confidence`	numeric(4,3)	NULL		보정 직전 신뢰도
`previous_status`	varchar(20)	NOT NULL		보정 직전 분류 확정 상태
`previous_result_source`	varchar(20)	NOT NULL		보정 직전 값의 출처(에이전트 판정인지 사용자 보정인지)
`applied_document_type_code`	varchar(100)	NULL		보정 후 문서종. 델타의 "to"
`applied_document_type_name`	varchar(200)	NULL		보정 후 문서종 이름
`applied_status`	varchar(20)	NOT NULL		보정 후 분류 확정 상태
`applied_result_source`	varchar(20)	NOT NULL		보정 후 값의 출처
`corrected_by_employee_no`	varchar(50)	NULL		보정한 사람의 사번
`corrected_at`	timestamptz	NOT NULL		보정 시각
`sync_status`	varchar(20)	NOT NULL	'PENDING'	PENDING · APPLIED · SKIPPED · FAILED · 외부 파이프라인 반영 상태. 반영 구현이 붙기 전에는 대기 상태로 쌓이는 것이 정상이다
`synced_at`	timestamptz	NULL		외부 반영 시각
`sync_failure_reason`	varchar(500)	NULL		외부 반영 실패 사유
`external_reference`	varchar(200)	NULL		반영 시 외부가 돌려준 참조(잡 ID 등)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_classification_corrections_result (classification_result_id, corrected_at)
idx_classification_corrections_sync (sync_status, corrected_at)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 8 추출 결과 한 벌 — 분류와 같은 이유로 버전을 둔다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		→ investigation_reports.report_no · 대상 보고서의 접수번호
`extraction_version`UQ	integer	NOT NULL		보고서 안에서의 추출 회차
`source_classification_version`	integer	NULL		어느 분류 결과 위에서 추출했는지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`provenance`	varchar(10)	NOT NULL	'STUB'	STUB · LIVE · 결과의 근원 — 실제 에이전트 응답인지 스텁인지
`external_job_id`	varchar(200)	NULL		이 결과를 만든 문서 AI 플랫폼 작업 식별자. 요약(ANALYZE)이 source_job_id 로 이어받는다. 스텁 결과는 NULL

인덱스

uq_extraction_results_version (report_no, extraction_version)

이 테이블을 참조하는 곳

extraction_field_corrections · extraction_result_fields

제약 정의 전문 (GitHub)

investigation-core 컬럼 16 추출 항목 — 문서종별 컬럼이 아니라 키·값·신뢰도의 범용 행으로 둔다. 추출 스키마가 바뀌어도 테이블이 흔들리지 않는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`extraction_result_id`UQ	bigint	NOT NULL	→ extraction_results.id · 이 항목이 속한 추출 결과 한 벌
`document_type_code`UQ	varchar(100)	NOT NULL	어느 문서종에서 뽑은 항목인지
`source_page_id`UQ	varchar(100)	NULL	근거가 된 낱장. 화면의 "근거 문서로 이동"이 이 값을 쓴다
`field_key`UQ	varchar(200)	NOT NULL	항목 키. 통계 적재가 어느 키를 어느 축으로 쓸지는 설정으로 정한다
`field_label`	varchar(200)	NULL	화면에 보이는 항목 이름
`field_value`	text	NULL	항목 값. 저장 정책에 따라 원문·마스킹 문자열·빈 값이 들어간다
`value_policy`	varchar(20)	NOT NULL	STORED · MASKED · NOT_STORED · 값 저장 정책 — 원문 보관 / 결합 특정 방지용 마스킹 / 개인 식별 정보라 미저장
`confidence`	numeric(4,3)	NULL	추출 신뢰도(0~1). 임계값 미달이면 화면이 저신뢰로 표시한다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`location_x`	numeric(6,5)	NULL	원문 위치 — 근거 낱장 폭에 대한 왼쪽 위 꼭짓점 가로 비율(0~1). 위치를 모르면 NULL
`location_y`	numeric(6,5)	NULL	원문 위치 — 근거 낱장 높이에 대한 왼쪽 위 꼭짓점 세로 비율(0~1). 위치를 모르면 NULL
`location_width`	numeric(6,5)	NULL	원문 위치 — 근거 낱장 폭에 대한 가로 비율(0~1). 위치를 모르면 NULL
`location_height`	numeric(6,5)	NULL	원문 위치 — 근거 낱장 높이에 대한 세로 비율(0~1). 위치를 모르면 NULL
`output_pointer`	varchar(500)	NULL	플랫폼 결과 본문(문서 output) 안의 항목 JSON 포인터 — 보정 값을 되돌려 놓을 자리. 모르면 NULL

인덱스

uq_extraction_result_fields_key (extraction_result_id, document_type_code, source_page_id, field_key)
idx_extraction_result_fields_result_type (extraction_result_id, document_type_code)

이 테이블을 참조하는 곳

extraction_field_corrections

제약 정의 전문 (GitHub)

investigation-core 컬럼 17 추출값 수정 이력 — 분류 보정 원장과 같은 형태. 항목이 지워지면 이력도 함께 지워진다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`extraction_result_field_id`	bigint	NOT NULL		→ extraction_result_fields.id · 고친 항목
`extraction_result_id`	bigint	NOT NULL		→ extraction_results.id · 결과 한 벌 — 수정 건수를 항목 조인 없이 세도록 승계해 둔다
`document_type_code`	varchar(100)	NOT NULL		항목의 문서종 (수정 시점 기준으로 승계)
`source_page_id`	varchar(100)	NULL		항목의 근거 낱장 (수정 시점 기준으로 승계)
`field_key`	varchar(200)	NOT NULL		항목 키 (수정 시점 기준으로 승계)
`value_policy`	varchar(20)	NOT NULL		STORED · MASKED · NOT_STORED · 수정 시점에 항목에 적용돼 있던 저장 정책 — 아래 두 값이 어떤 규칙으로 가려진 값인지 말해 준다
`previous_value`	text	NULL		수정 직전 값. 첫 행이면 최초 추출값이고, 비어 있던 항목을 채운 경우는 비어 있다
`applied_value`	text	NULL		수정 후 값. 값을 비운 경우는 비어 있다
`corrected_by_employee_no`	varchar(50)	NULL		수정한 사람의 사번
`corrected_at`	timestamptz	NOT NULL		수정 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`sync_status`	varchar(20)	NOT NULL	'PENDING'	PENDING · APPLIED · SKIPPED · FAILED · 플랫폼 저장 결과 반영 상태 — PENDING/APPLIED/SKIPPED/FAILED
`synced_at`	timestamptz	NULL		반영(또는 건너뜀·실패)을 기록한 시각
`sync_failure_reason`	varchar(500)	NULL		반영 실패 사유(값을 담지 않는다)
`external_reference`	varchar(200)	NULL		이 보정을 실은 왕복의 플랫폼 업로드 참조(import id)

인덱스

idx_extraction_field_corrections_result (extraction_result_id, corrected_at)
idx_extraction_field_corrections_field (extraction_result_field_id, corrected_at)
idx_extraction_field_corrections_sync (sync_status, corrected_at)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 요약 섹션 골격(위탁사 기본 구성 + 청구유형 예외)의 버전. 관리자 에이전트 스튜디오 Instruct 설정의 저장 형태

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`scope_code`UQ	varchar(100)	NOT NULL		적용 범위 — 위탁사 마스터 코드(customer_companies.customer_company_code, 예: HLI) 또는 공통(COMMON). 마스터에 없는 코드는 리졸버가 고르지 못해 공통 골격으로 떨어진다
`skeleton_version`UQ	integer	NOT NULL		범위 안에서 1부터 증가하는 버전
`active`	boolean	NOT NULL	true	지금 요약이 쓰는 버전인가. 범위당 하나만 참
`definition_json`	text	NOT NULL		골격 정의 JSON — 섹션(종류·배치·열·byte 제한·반영 방식·항목·지침)과 청구유형 예외
`created_by_employee_no`	varchar(50)	NULL		이 버전을 저장한 사람. 시드 행은 NULL
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_summary_skeletons_version (scope_code, skeleton_version)
idx_summary_skeletons_scope_active (scope_code, active)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 요약 그룹 — 2depth 문서종 묶음과 요약 프롬프트. 보고서 요약 탭의 구획 하나이자 요약 호출 1회

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`group_code`UQ	varchar(100)	NOT NULL	그룹 코드(프론트 그룹 id). 생성 후 바뀌지 않는다. 업스테이지 Instruct 템플릿 그룹은 SUM-GROUP-TPL-<템플릿 번호>
`group_name`	varchar(200)	NOT NULL	그룹 이름 — 요약 탭 구획 머리말
`prompt`	text	NOT NULL	그룹 요약 프롬프트 — 요약 호출의 input_text
`display_order`	integer	NOT NULL	요약 탭 구획 순서(0부터)
`updated_by_employee_no`	varchar(50)	NULL	마지막으로 저장한 사람. 시드 행은 NULL
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_summary_groups_code (group_code)

이 테이블을 참조하는 곳

summary_group_document_types

제약 정의 전문 (GitHub)

investigation-core 컬럼 5 요약 그룹에 묶은 2depth 문서종. 한 문서종은 한 그룹에만 든다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`summary_group_id`	bigint	NOT NULL	→ summary_groups.id · 요약 그룹
`agent_document_type_code`UQ	varchar(100)	NOT NULL	2depth 문서종 코드(agent_document_types 코드 = Studio 분류 라벨)
`display_order`	integer	NOT NULL	그룹 안 문서종 순서(0부터)
`created_at`	timestamptz	NOT NULL

인덱스

uq_summary_group_document_types_code (agent_document_type_code)
idx_summary_group_document_types_group (summary_group_id)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 요약 그룹 판 — 저장 한 번이 한 행, 가장 큰 판이 지금 값. 행은 고치지 않는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_no`UQ	integer	NOT NULL	1 부터 저장할 때마다 1 씩 오르는 판 번호
`document`	jsonb	NOT NULL	그룹 전체 — [{code, name, displayOrder, documentTypeCodes, prompt}] 구획 순서
`saved_by_employee_no`	varchar(50)	NULL	이 판을 저장한 사람. 지금 값을 처음 판으로 옮긴 행은 NULL
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_summary_group_versions_no (version_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 이 화면에서 저장한 Studio 지시서에 담을 자리가 없는 값 — 지시서 하나에 한 행, 행은 고치지 않는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`studio_config_id`UQ	varchar(100)	NOT NULL	Studio 지시서(Config) 식별자
`stage`	varchar(20)	NOT NULL	CLASSIFY · EXTRACT · 단계 — CLASSIFY 문서 분류 / EXTRACT 추출 스키마
`document`	jsonb	NOT NULL	CLASSIFY: 라벨 → {keywords, enabled}, EXTRACT: 라벨 → 추출 항목 목록(표시 이름·대조·마스터 규칙)
`summary_group_version_no`	integer	NULL	추출 지시서와 함께 저장한 요약 그룹 판(summary_group_versions.version_no). 분류는 비어 있다
`saved_by_employee_no`	varchar(50)	NOT NULL	이 지시서를 저장한 관리자 사번
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_config_extras_config (studio_config_id)
ix_agent_studio_config_extras_stage_created (stage, created_at)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 추출 지시서의 요약 그룹 짝 — 지시서 하나에 한 행, 요약 설정을 저장하면 판 번호를 옮긴다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`studio_config_id`UQ	varchar(100)	NOT NULL	Studio 추출 지시서(Config) 식별자
`summary_group_version_no`	integer	NOT NULL	요약 그룹 판 — summary_group_versions.version_no
`saved_by_employee_no`	varchar(50)	NOT NULL	이 짝을 마지막으로 저장한 관리자 사번
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_summary_pairs_config (studio_config_id)

제약 정의 전문 (GitHub)

investigation-core어제 · #2132 컬럼 6 에이전트 스튜디오 실행 테스트 한 번 — 관리자 한 명이 올린 서류와 단계별 실행을 묶는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`	varchar(50)	NULL	테스트 위탁사 코드. 고르기 전이면 비어 있다
`created_by`	varchar(50)	NOT NULL	실행을 만든 관리자 사번 — 다른 관리자에게는 보이지 않는다
`last_activity_at`	timestamptz	NOT NULL	마지막으로 파일·실행·조회가 있었던 시각 — 보관 기간 정리의 기준
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

ix_agent_studio_test_runs_last_activity (last_activity_at)

이 테이블을 참조하는 곳

agent_studio_test_run_files · agent_studio_test_run_steps

제약 정의 전문 (GitHub)

investigation-core3일 전 · #2058 컬럼 14 실행 테스트에 올린 서류 한 건 — 원본은 보관하지 않고 Studio 에 올린 PDF 의 식별자만 둔다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`run_id`	bigint	NOT NULL	→ agent_studio_test_runs.id · 실행 — agent_studio_test_runs.id
`display_order`	integer	NOT NULL	첨부 순서(1부터) — 분류 작업 입력 순서이자 화면 순서
`file_name`	varchar(255)	NOT NULL	관리자가 올린 원본 파일명
`size_bytes`	bigint	NOT NULL	원본 파일 크기(바이트)
`page_count`	integer	NOT NULL	쪽 수 — 분류 결과의 쪽 범위를 파일·쪽으로 되짚는 기준
`sha256`	varchar(64)	NOT NULL	원본 파일 SHA-256 — 같은 실행에 같은 파일을 두 번 올리지 않게 한다
`provider`	varchar(50)	NOT NULL	파일을 올린 문서 AI 플랫폼 식별자
`external_file_id`	varchar(100)	NULL	플랫폼 파일 식별자. 업로드 전·실패면 비어 있다
`status`	varchar(20)	NOT NULL	PROCESSING · READY · FAILED · 플랫폼 파일 상태 — PROCESSING(준비 중)·READY·FAILED
`failure_reason`	varchar(500)	NULL	업로드·준비 실패 사유
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`storage_key`	varchar(300)	NULL	변환한 PDF 의 객체 저장소 키. 저장소로 옮기기 전에 올린 행과 저장 실패 행은 비어 있다

인덱스

ix_agent_studio_test_run_files_run (run_id)

제약 정의 전문 (GitHub)

investigation-core어제 · #2132 컬럼 18 실행 테스트의 단계 실행 — 실행·단계마다 한 행, 다시 실행하면 행을 바꾼다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`run_id`UQ	bigint	NOT NULL	→ agent_studio_test_runs.id · 실행 — agent_studio_test_runs.id
`stage`UQ	varchar(20)	NOT NULL	CLASSIFY · EXTRACT · REPORT · 단계 — CLASSIFY(문서 분류)·EXTRACT(정보 추출)·REPORT(AI 보고서)
`config_id`	varchar(100)	NOT NULL	돌린 Studio 지시서(Config) 식별자 — 그 단계 에이전트의 가장 최근 지시서
`config_version`	varchar(50)	NULL	돌린 지시서의 버전 표시값
`provider`	varchar(50)	NOT NULL	작업을 맡긴 문서 AI 플랫폼 식별자
`external_job_id`	varchar(100)	NULL	플랫폼 작업 식별자. 합본을 준비하는 동안은 비어 있다
`status`	varchar(20)	NOT NULL	RUNNING · SUCCEEDED · FAILED · 작업 상태 — RUNNING·SUCCEEDED·FAILED
`error_code`	varchar(100)	NULL	실패 코드
`pages`	text	NULL	단계 결과(JSON) — 분류는 낱장별 판정, 추출은 항목별 값, 보고서는 실행에 쓴 분석 조건
`requested_by`	varchar(50)	NOT NULL	이 단계를 실행한 관리자 사번
`completed_at`	timestamptz	NULL	작업이 끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`input_file_id`	varchar(100)	NULL	작업에 넣은 파일의 Studio 식별자 — 분류는 합본 PDF, 추출은 이어 실행한 분류 Job 의 파일. 스텁·준비 전이면 비어 있다
`input_file_sha256`	varchar(64)	NULL	분류 합본 PDF 의 SHA-256 — 결과 왕복이 새 Job 을 발급하는 플랫폼에서 갱신 Job 을 파일 내용으로 찾는다
`source_job_id`	varchar(100)	NULL	추출이 이어 실행한 분류 Job(검수 반영을 거쳤으면 갱신 Job). 분류 단계·준비 전이면 비어 있다
`summary_config_version_no`	integer	NULL	보고서 단계가 요약 그룹을 부른 요약 지시서 버전(agent_studio_summary_config_versions.version_no) — 다른 단계는 비어 있다

인덱스

uq_agent_studio_test_run_steps_stage (run_id, stage)

이 테이블을 참조하는 곳

agent_studio_test_run_corrections · agent_studio_test_run_report_items

제약 정의 전문 (GitHub)

investigation-core어제 · #2132 컬럼 23 실행 테스트 추출 전 분류 검수 반영(결과 왕복) 한 번 — 추출 단계마다 한 행, 사람이 문서종을 바꾼 낱장이 있을 때만

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`step_id`UQ	bigint	NOT NULL		→ agent_studio_test_run_steps.id · 이 왕복을 기다리는 단계(추출·보고서) — agent_studio_test_run_steps.id
`provider`	varchar(50)	NOT NULL		문서 AI 플랫폼 식별자
`collection_ref`	varchar(200)	NOT NULL		분류 결과가 쌓인 저장소(Studio Export Collection) — 분류 단계에서 돌린 지시서의 것
`phase`	varchar(30)	NOT NULL		EXPORT_REQUESTED · EXPORT_READY · IMPORT_UPLOADED · IMPORT_COMMITTED · IMPORT_READY · RESOLVED · FAILED · 걸음 — EXPORT_REQUESTED·EXPORT_READY·IMPORT_UPLOADED·IMPORT_COMMITTED·IMPORT_READY·RESOLVED·FAILED
`source_job_id`	varchar(100)	NOT NULL		덮어쓸 분류 Job
`source_file_id`	varchar(100)	NOT NULL		그 Job 의 입력 파일(합본 PDF)
`label_count`	integer	NOT NULL		보낼 항목 수 — 분류는 문서종을 바꾼 낱장, 추출은 값을 고친 항목
`export_ref`	varchar(500)	NULL		내보내기 참조
`download_ref`	text	NULL		내보낸 결과를 내려받을 참조(서명된 URL) — 올리기에 한 번 쓴다
`import_ref`	varchar(500)	NULL		덮어써 올린 업로드 참조
`payload_sha256`	varchar(64)	NULL		올린 본문의 SHA-256
`sent_item_count`	integer	NULL		실제로 덮어쓴 항목 수
`resolved_job_id`	varchar(100)	NULL		반영 뒤 이어 실행할 분류 Job — 제자리 정정이면 원 Job 과 같다
`resolved_file_ids`	text	NULL		그 Job 의 파일 식별자(JSON 배열)
`error_code`	varchar(100)	NULL		실패 코드
`error_detail`	varchar(500)	NULL		실패 상세 — 플랫폼 코드·위치만, 값은 싣지 않는다
`requested_at`	timestamptz	NOT NULL		왕복을 시작한 시각 — 제한 시간과 갱신 Job 찾기의 기준
`completed_at`	timestamptz	NULL		왕복이 끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`result_kind`	varchar(20)	NOT NULL	'CLASSIFICATION'	CLASSIFICATION · EXTRACTION · 되돌려 놓는 결과 종류 — CLASSIFICATION(추출 전 분류 라벨)·EXTRACTION(보고서 전 추출 값)
`idempotency_key`	varchar(100)	NOT NULL		플랫폼 요청의 멱등 키 — 왕복마다 무작위 값, 재시도하는 동안 그대로다

인덱스

uq_agent_studio_test_run_corrections_step (step_id)

제약 정의 전문 (GitHub)

investigation-core어제 · #2132 컬럼 18 실행 테스트 보고서의 탭·요약 그룹 결과 한 건 — 실행과 함께 1일 뒤 지운다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`step_id`UQ	bigint	NOT NULL		→ agent_studio_test_run_steps.id · 보고서 단계 — agent_studio_test_run_steps.id
`item_kind`UQ	varchar(10)	NOT NULL		TAB · GROUP · 종류 — TAB(보고서 탭)·GROUP(요약 그룹)
`item_key`UQ	varchar(200)	NOT NULL		탭 키 또는 요약 그룹 코드
`item_name`	varchar(200)	NOT NULL		화면 표시 이름
`display_order`	integer	NOT NULL		표시 순서(0부터)
`status`	varchar(20)	NOT NULL		PENDING · RUNNING · SUCCEEDED · FAILED · 상태 — PENDING·RUNNING·SUCCEEDED·FAILED
`prompt`	text	NULL		실제로 보낸 지시문 — 탭은 조립 원문(단위테스트면 고친 원문), 요약 그룹은 그룹 프롬프트
`output`	text	NULL		결과 — 탭은 출력 JSON, 요약 그룹은 결과 글. 개인정보가 들어갈 수 있다
`sources`	text	NULL		탭 항목별 요약근거를 서류·쪽으로 되짚은 값(JSON). 없으면 비어 있다
`external_id`	varchar(100)	NULL		플랫폼 식별자 — 탭은 Response, 요약 그룹은 Job
`repaired`	boolean	NOT NULL	false	탭 출력이 스키마에 맞지 않아 키 매칭으로 보정했는지
`error_code`	varchar(100)	NULL		실패 코드
`error_detail`	varchar(500)	NULL		실패 상세 — 값은 싣지 않는다
`unit_tested_at`	timestamptz	NULL		고친 원문으로 이 탭만 다시 돈 시각
`completed_at`	timestamptz	NULL		끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_test_run_report_items (step_id, item_kind, item_key)

제약 정의 전문 (GitHub)

investigation-core오늘 · #2161 컬럼 24 에이전트 스튜디오 배포 기록 — 실행 테스트를 통과한 분류·추출 Config·요약 판·보고서 판 한 벌. 적용된 가장 최근 행이 배포본

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`test_run_id`	bigint	NOT NULL	배포의 근거가 된 실행 테스트(agent_studio_test_runs.id) — 실행이 지워져도 번호만 남긴다
`studio_provider`	varchar(50)	NOT NULL	문서 AI 플랫폼 식별자
`classify_agent_id`	varchar(100)	NOT NULL	분류 에이전트 id
`classify_config_id`	varchar(100)	NOT NULL	테스트한 분류 Config id
`classify_config_version`	varchar(50)	NULL	분류 Config 버전 표시값 — 모르면 비어 있다
`extract_agent_id`	varchar(100)	NOT NULL	추출 에이전트 id
`extract_config_id`	varchar(100)	NOT NULL	테스트한 추출 Config id
`extract_config_version`	varchar(50)	NULL	추출 Config 버전 표시값 — 모르면 비어 있다
`summary_group_version_no`	integer	NOT NULL	요약 그룹 판 — 추출 Config 의 짝(summary_group_versions.version_no)
`instruct_version_no`	integer	NOT NULL	보고서(INSTRUCT) 판 — agent_studio_instruct_versions.version_no
`status`	varchar(20)	NOT NULL	APPLIED · PENDING_MAPPING · APPLIED = 적용됨, PENDING_MAPPING = 2depth 문서종이 바뀌어 위탁사 분류체계 매핑 확정을 기다림
`added_document_types`	text	NULL	앞 배포 대비 더해진 2depth 문서종(JSON 배열) — 배포 대기 안내용
`removed_document_types`	text	NULL	앞 배포 대비 빠진 2depth 문서종(JSON 배열) — 배포 대기 안내용
`deployed_by_employee_no`	varchar(50)	NOT NULL	배포한 관리자 사번
`deployed_at`	timestamptz	NOT NULL	배포 일시
`applied_at`	timestamptz	NULL	적용 일시 — 배포 대기면 비어 있다
`created_at`	timestamptz	NOT NULL	행 생성 일시
`updated_at`	timestamptz	NOT NULL	행 수정 일시
`summary_agent_id`	varchar(100)	NULL	배포 때 요약 그룹 에이전트 id(환경 설정) — 설정이 없으면 비어 있다
`summary_config_id`	varchar(100)	NULL	배포 때 요약 그룹 지시서 id(환경 설정) — 설정이 없으면 비어 있다
`summary_group_overrides`	text	NULL	배포 때 그룹별로 다르게 부르는 요약 에이전트·지시서(JSON {그룹코드: {agentId, configId}}) — 없으면 비어 있다
`summary_config_version_no`	integer	NULL	테스트한 요약 지시서 버전 — 버전 표 이전 배포는 비어 있다
`renamed_document_types`	text	NULL	앞 배포 대비 이름이 바뀐 2depth 문서종(JSON 배열 [{from,to}]) — 문서종 키로 판정, 추가·삭제 목록에는 넣지 않는다

인덱스

ix_agent_studio_deployments_status (status, id)

제약 정의 전문 (GitHub)

investigation-core어제 · #2132 컬럼 10 요약 그룹 지시서 버전 — 분류 지시서마다 Import 형태를 맞춘 요약 지시서 한 벌(기본 + 그룹별)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_no`UQ	integer	NOT NULL	버전 번호 — 1부터 오른다
`classify_config_id`	varchar(100)	NULL	짝인 분류 지시서 — 환경 설정 시드는 비어 있다
`agent_id`	varchar(100)	NOT NULL	요약 그룹 에이전트 id
`config_id`	varchar(100)	NOT NULL	그룹별 지정이 없는 그룹이 쓰는 요약 지시서 id
`group_configs`	text	NULL	그룹 코드별 요약 에이전트·지시서(JSON {그룹코드: {agentId, configId}}) — 없으면 비어 있다
`based_on_version_no`	integer	NULL	복제한 앞 버전 — 시드는 비어 있다
`created_by`	varchar(50)	NOT NULL	만든 관리자 사번 — 시드는 SYSTEM
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uk_agent_studio_summary_config_versions_version (version_no)
ix_agent_studio_summary_config_versions_classify (classify_config_id, version_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 에이전트 스튜디오 문서 분류(CLASSIFY)·추출 스키마(EXTRACT) 설정의 버전 — 저장 한 번이 한 행이고 그 단계의 전체 값이 이 버전 아래 복사된다. 단계마다 가장 큰 버전이 최신 저장본이다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stage`UQ	varchar(20)	NOT NULL	CLASSIFY · EXTRACT · 단계 — CLASSIFY 문서 분류(1depth·2depth 문서종) / EXTRACT 추출 스키마(문서종별 추출 항목)
`version_no`UQ	integer	NOT NULL	단계 안 버전 번호. 저장마다 1 씩 오르며 행은 고치지 않는다
`saved_by_employee_no`	varchar(50)	NOT NULL	이 버전을 저장한 관리자 사번. 서버가 기동 때 넣은 첫 버전은 SYSTEM
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_schema_versions_no (stage, version_no)

이 테이블을 참조하는 곳

agent_studio_document_categories · agent_studio_document_types · agent_studio_extraction_fields

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 에이전트 스튜디오 1depth 문서종(분류군) — 분류 버전 × 1depth 한 행

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_id`UQ	bigint	NOT NULL	→ agent_studio_schema_versions.id · 분류(CLASSIFY) 버전
`category_key`UQ	varchar(100)	NOT NULL	1depth 고유 키(화면 1depth id) — 버전이 바뀌어도 같은 분류군이면 같은 값
`name`	varchar(200)	NOT NULL	1depth 표시명. 같은 버전 안에서 겹치지 않는다
`description`	text	NOT NULL	1depth 설명
`display_order`	integer	NOT NULL	1depth 순서(0부터)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_document_categories_key (version_id, category_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 12 에이전트 스튜디오 2depth 문서종 — 분류 버전 × 2depth 한 행

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_id`UQ	bigint	NOT NULL	→ agent_studio_schema_versions.id · 분류(CLASSIFY) 버전
`doc_type_key`UQ	varchar(100)	NOT NULL	2depth 고유 키(화면 2depth id) — 이름이 바뀌어도 같은 문서종이면 같은 값. 추출 스키마 버전과 이 키로 잇는다
`category_key`	varchar(100)	NOT NULL	소속 1depth 키(같은 버전의 agent_studio_document_categories.category_key)
`name`UQ	varchar(200)	NOT NULL	2depth 표시명 = Studio 분류 라벨 = 요약 그룹이 묶는 문서종 코드. 같은 버전 안에서 겹치지 않는다
`label_key`	varchar(100)	NOT NULL	분류 결과값 영문 키(추출 라우팅 조건)
`description`	text	NOT NULL	문서 설명 — 분류 판정 설명
`enabled`	boolean	NOT NULL	사용 여부
`keywords`	text	NOT NULL	분류 판정 힌트 낱말 — JSON 문자열 배열 글(순서 유지)
`display_order`	integer	NOT NULL	소속 1depth 안 순서(0부터)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_document_types_key (version_id, doc_type_key)
uq_agent_studio_document_types_name (version_id, name)
ix_agent_studio_document_types_category (version_id, category_key, display_order)

제약 정의 전문 (GitHub)

investigation-core 컬럼 18 에이전트 스튜디오 추출 항목 — 추출 스키마 버전 × 2depth 문서종 × 항목 한 행. 표 컬럼은 표 항목을 부모로 둔 행이다. 항목이 없는 문서종은 행이 없다(분류만 하는 정상 상태)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_id`	bigint	NOT NULL	→ agent_studio_schema_versions.id · 추출 스키마(EXTRACT) 버전
`doc_type_key`	varchar(100)	NOT NULL	2depth 문서종 키(분류 버전의 agent_studio_document_types.doc_type_key). 분류 버전과 FK 로 묶지 않는다 — 두 단계 버전은 따로 쌓인다
`parent_field_id`	bigint	NULL	→ agent_studio_extraction_fields.id · 표 컬럼이면 그 표 항목 행. 최상위 항목은 NULL
`field_key_id`	varchar(100)	NOT NULL	화면 항목 고유 id(fieldId) — 버전이 바뀌어도 같은 항목이면 같은 값
`field_name`	varchar(200)	NOT NULL	항목 표시명. 같은 목록 안에서 겹치지 않는다
`field_key`	varchar(100)	NOT NULL	추출 결과 키 = 추출 JSON 스키마 속성 이름. 화면에서 받지 않고 시스템이 정한다
`field_type`	varchar(20)	NOT NULL	STRING · NUMBER · INTEGER · BOOLEAN · TABLE · 값 유형 — STRING·NUMBER·INTEGER·BOOLEAN, 표는 TABLE(표 컬럼은 TABLE 이 될 수 없다)
`is_list`	boolean	NOT NULL	값이 고른 유형의 배열(목록)로 오는지. 표 항목은 늘 false
`is_required`	boolean	NOT NULL	추출 JSON 스키마 required 에 넣는지(화면에서 고치지 않는다)
`description`	text	NOT NULL	항목 설명 — 추출 지시. 필수
`reference_case_field`	varchar(100)	NULL	추출값 대조 기준 사건 정보 키. 피보험자 이름(insured_name)만 쓴다. NULL 이면 대조하지 않는다
`reference_compare`	varchar(20)	NULL	EXACT · NORMALIZED · 대조 방식 — EXACT 글자 그대로 / NORMALIZED 공백·괄호·가운뎃점 차이 무시
`reference_allow_alias`	boolean	NULL	조사자가 기준값(외국인 본명 표기 등)을 더 넣을 수 있는지
`master_match`	varchar(20)	NULL	추출값을 붙일 마스터 — HOSPITAL 병원 마스터. NULL 이면 붙이지 않는다
`display_order`	integer	NOT NULL	목록(문서종 최상위 또는 표 컬럼) 안 순서(0부터)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

ix_agent_studio_extraction_fields_version (version_id, doc_type_key, display_order)
ix_agent_studio_extraction_fields_parent (parent_field_id)

이 테이블을 참조하는 곳

agent_studio_extraction_fields

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 11 요약 결과 한 벌 — 확정 전에는 본문을 고칠 수 있고 확정 후에는 항목별 보고서 반영만 체크한다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		→ investigation_reports.report_no · 대상 보고서의 접수번호
`summary_version`UQ	integer	NOT NULL		보고서 안에서의 요약 회차
`source_analysis_request_version`	integer	NULL		어느 분석 요청(조건) 위에서 만든 요약인지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`confirmed_at`	timestamptz	NULL		요약을 확정한 시각. 확정 후에는 본문을 고칠 수 없다
`confirmed_by_employee_no`	varchar(50)	NULL		확정한 사람의 사번
`provenance`	varchar(10)	NOT NULL	'STUB'	STUB · LIVE · 결과의 근원 — 실제 에이전트 응답인지 스텁인지
`skeleton_version`	varchar(100)	NULL		이 요약을 만든 섹션 골격의 버전(스튜디오 저장 버전 또는 내장 기본값 식별자). 골격 정의는 결과에 다시 싣지 않고 이 값으로 참조한다
`claim_type_codes_json`	text	NULL		근거 분석 요청이 고른 청구유형(보고서 양식) 코드의 요청 시점 스냅샷(JSON 문자열 배열)

인덱스

uq_summary_results_version (report_no, summary_version)

이 테이블을 참조하는 곳

summary_cards · summary_sections

제약 정의 전문 (GitHub)

investigation-core 컬럼 16 요약 결과 한 벌의 구역(섹션) — 위탁사 × 청구유형 골격의 한 칸. 요약 화면의 탭 하나이자 초안 본문의 구역 하나

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`summary_result_id`UQ	bigint	NOT NULL		→ summary_results.id · 이 섹션이 속한 요약 결과
`section_key`UQ	varchar(100)	NOT NULL		골격 정의의 섹션 키. 같은 요약 안에서 유일하며 초안 구역·전달 JSON 이 이 키로 가리킨다
`section_name`	varchar(300)	NOT NULL		섹션 표시명(위탁사 양식의 칸 이름 — 병원별 요약·사고경위·손해사정서 등)
`section_kind`	varchar(20)	NOT NULL		SUMMARY_TABLE · SUMMARY_TEXT · NARRATIVE · 섹션 종류. SUMMARY_TABLE 요약 표 / SUMMARY_TEXT 요약 텍스트 / NARRATIVE 담당자 서술(초안에 전문 포함)
`layout_mode`	varchar(20)	NOT NULL		ITEM_LIST · ROW_TABS · 배치. ITEM_LIST 카드 안 항목 목록 / ROW_TABS 행 추가 탭(카드 = 행, 열마다 항목)
`columns_json`	text	NULL		ROW_TABS 의 열 이름 배열(JSON 문자열 배열). ITEM_LIST 면 NULL
`byte_limit_unit`	varchar(10)	NULL		SECTION · ITEM · TAB · byte 제한 단위. SECTION 섹션 전체 / ITEM 항목마다 / TAB 행마다. 제한이 없으면 NULL
`byte_limit_korean`	integer	NULL		byte 제한 — 한글 기준 값(자료 표기). 영문 기준의 절반 예산
`byte_limit_english`	integer	NULL		byte 제한 — 영문+숫자 기준 값(자료 표기). 비ASCII 1자를 2byte 로 센 값과 비교한다
`report_inclusion`	varchar(20)	NOT NULL	'BODY'	BODY · REFERENCE_ONLY · EXCLUDED · 보고서 반영 방식. BODY 초안 본문 포함 / REFERENCE_ONLY 전달 JSON 참조 구역에만 동봉 / EXCLUDED 화면 전용
`conditional`	boolean	NOT NULL	false	자료 존재 조건에 따라 생기는 섹션인가(의료자문·이륜차·직업직무변경·간호기록지·보조지표)
`display_order`	integer	NOT NULL		요약 안에서의 표시 순서(0부터)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`output_json`	text	NULL		이 섹션(탭)을 낸 Instruct 출력 JSON 원형. 지시서 소유 스키마로 답한 결과에만 있다. 같은 탭이 여러 번 왔으면 JSON 배열

인덱스

uq_summary_sections_key (summary_result_id, section_key)
idx_summary_sections_result_order (summary_result_id, display_order)

이 테이블을 참조하는 곳

summary_cards

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 병원(기관)별 요약 카드 — 화면 구조를 그대로 따른다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`summary_result_id`	bigint	NOT NULL	→ summary_results.id · 이 카드가 속한 요약 결과 한 벌
`institution_code`	varchar(100)	NULL	기관 식별자. 원천이 정해지지 않아 자유 문자열이다
`institution_name`	varchar(300)	NULL	기관 이름
`display_order`	integer	NOT NULL	카드 표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`summary_section_id`	bigint	NULL	→ summary_sections.id · 이 카드가 속한 섹션. 섹션 도입(2026-09-29) 전 행은 아래 백필로 병원별 요약 섹션에 붙였다
`tab_title`	varchar(300)	NULL	ROW_TABS 섹션에서 행(탭)의 제목 — 청구유형 중복 선택 시 유형별 소제목이 여기 들어간다. 요약 표 섹션이면 NULL

인덱스

idx_summary_cards_result_order (summary_result_id, display_order)
idx_summary_cards_section_order (summary_section_id, display_order)

이 테이블을 참조하는 곳

summary_items

제약 정의 전문 (GitHub)

investigation-core 컬럼 16 카드 안의 요약 항목 — 내원경위·검사내용·진단병명·치료내용 등

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`summary_card_id`UQ	bigint	NOT NULL		→ summary_cards.id · 이 항목이 속한 카드
`item_key`UQ	varchar(200)	NOT NULL		항목 키. 값 집합은 보고서 양식에 따라 달라진다
`item_label`	varchar(300)	NULL		화면에 보이는 항목 이름
`item_content`	text	NULL		요약 본문
`display_order`	integer	NOT NULL		카드 안에서의 표시 순서
`edited`	boolean	NOT NULL	false	사용자가 손댄 항목인지. 재요약이 수정본을 덮어쓸지 판단하는 근거
`edited_by_employee_no`	varchar(50)	NULL		수정한 사람의 사번
`edited_at`	timestamptz	NULL		수정 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`report_reflected`	boolean	NOT NULL	false	보고서에 반영했는지 체크. 확정 후에만 켤 수 있다
`report_reflected_at`	timestamptz	NULL		반영 체크 시각
`report_reflected_by_employee_no`	varchar(50)	NULL		반영을 체크한 사람의 사번
`original_content`	text	NULL		첫 사용자 수정 전의 AI 원문. 수정된 적 없으면 NULL 이고 확정 초기화가 이 값으로 되돌린다
`author`	varchar(10)	NOT NULL	'AI'	AI · HUMAN · 작성 주체. AI 생성 항목 / HUMAN 조사자 전용 항목(Studio 출력 골격에서 제외, 화면에서 입력, 미입력이면 본문 NULL)

인덱스

uq_summary_items_key (summary_card_id, item_key)

이 테이블을 참조하는 곳

summary_item_sources

제약 정의 전문 (GitHub)

investigation-core 컬럼 11 요약 항목의 출처 — 한 항목에 여럿이 붙고, 스캔 낱장과 지식컬렉션 청크가 섞일 수 있다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`summary_item_id`	bigint	NOT NULL	→ summary_items.id · 출처가 붙는 요약 항목
`source_type`	varchar(30)	NOT NULL	DOCUMENT_PAGE · COLLECTION_CHUNK · 출처 갈래 — 이 보고서의 스캔 낱장 / 지식컬렉션 문서 조각
`source_page_id`	varchar(100)	NULL	스캔 낱장 출처. 스냅샷이 바뀌어도 기록은 남아야 하므로 FK 를 두지 않는다
`collection_id`	bigint	NULL	지식컬렉션 출처. 컬렉션은 다른 도메인 소유라 값만 보관한다
`collection_file_id`	bigint	NULL	지식컬렉션 파일 출처
`chunk_reference`	varchar(300)	NULL	플랫폼이 준 청크 식별자·페이지 등 출처를 되짚는 값
`quoted_text`	text	NULL	화면에 보여줄 근거 문구. 원문 전체가 아니라 인용 조각이다
`display_order`	integer	NOT NULL	출처 표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_summary_item_sources_item_order (summary_item_id, display_order)

제약 정의 전문 (GitHub)

분석 요청·보고서 산출GitHub

investigation-core. 분석 요청 입력값과 보고서 초안·양식·메일 발송, 청약서 폼 설정 버전, 1인 동시 AI 분석 요청 한도, 사고조사 챗봇 AI 보고서 반영 원장, 챗봇·반영 지시문 판(관리자 API 로 고친다).

erDiagram

"public.analysis_request_forms" }o--|| "public.analysis_requests" : "analysis_request_id"
"public.analysis_request_contracts" }o--|| "public.analysis_requests" : "analysis_request_id"
"public.analysis_request_contract_items" }o--|| "public.analysis_request_contracts" : "contract_id"
"public.analysis_request_collections" }o--|| "public.analysis_requests" : "analysis_request_id"
"public.report_template_variables" }o--|| "public.report_templates" : "report_template_id"
"public.report_draft_sections" }o--|| "public.report_drafts" : "report_draft_id"
"public.report_draft_ai_tabs" }o--|| "public.report_drafts" : "report_draft_id"
"public.report_draft_llm_tabs" }o--o| "public.report_drafts" : "report_draft_id"
"public.agent_studio_instruct_tabs" }o--|| "public.agent_studio_instruct_versions" : "version_id"
"public.agent_studio_instruct_tab_bodies" }o--|| "public.claim_types" : "claim_type_code"
"public.agent_studio_instruct_tab_bodies" }o--|| "public.agent_studio_instruct_tabs" : "tab_id"
"public.analysis_request_files" }o--|| "public.analysis_requests" : "analysis_request_id"
"public.analysis_request_claim_hospitals" }o--|| "public.analysis_requests" : "analysis_request_id"

"public.analysis_requests" {}
"public.analysis_request_forms" {}
"public.analysis_request_contracts" {}
"public.analysis_request_contract_items" {}
"public.analysis_request_collections" {}
"public.report_drafts" {}
"public.report_templates" {}
"public.report_template_variables" {}
"public.report_draft_sections" {}
"public.claim_types" {}
"public.report_draft_ai_tabs" {}
"public.report_draft_llm_tabs" {}
"public.agent_studio_instruct_versions" {}
"public.agent_studio_instruct_tabs" {}
"public.agent_studio_instruct_tab_bodies" {}
"public.analysis_request_files" {}
"public.analysis_request_claim_hospitals" {}

investigation-core2일 전 · #2113 컬럼 11 분석 요청(분석 조건) 한 벌 — 양식 → 계약별 정보 → 참조 컬렉션 → 기타 요청 순서로 화면과 같은 구조다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	→ investigation_reports.report_no · 대상 보고서의 접수번호
`request_version`UQ	integer	NOT NULL	재분석 회차. 이전 조건을 지우지 않아야 무엇을 바꿔 다시 돌렸는지 볼 수 있다
`other_request`	text	NULL	기타 요청(자유 서술). 파일 첨부는 이 항목 범위 밖이다
`reference_note`	text	NULL	참고자료 메모
`requested_by_employee_no`	varchar(50)	NOT NULL	요청한 사람의 사번
`requested_at`	timestamptz	NOT NULL	요청 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`application_form_version`	integer	NULL	요청 시점에 조사자 화면이 읽은 청약서 폼 설정 버전(application_form_versions.version). 0 은 서버 내장 기본값, NULL 은 기록 전 요청
`claim_type_options_json`	text	NULL	요청 시점 청구유형 목록 전체 스냅샷(JSON 배열: code·name·representativeEligible). 기록 전 요청은 NULL

인덱스

uq_analysis_requests_version (report_no, request_version)

이 테이블을 참조하는 곳

analysis_request_claim_hospitals · analysis_request_collections · analysis_request_contracts · analysis_request_files · analysis_request_forms

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 요청이 고른 청구유형 — 복수 선택, 요청마다 대표 하나

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL		→ analysis_requests.id · 이 선택이 속한 분석 요청
`report_form_code`UQ	varchar(100)	NOT NULL		청구유형 코드(claim_types.claim_type_code). 열 이름은 옛 보고서 양식 시절 그대로
`display_order`	integer	NOT NULL		표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`claim_type_name`	varchar(200)	NULL		요청 시점의 청구유형 이름 스냅샷. 마스터에 없는 코드는 NULL
`representative`	boolean	NOT NULL	false	대표 청구유형 여부. 요청마다 많아야 한 행

인덱스

uq_analysis_request_forms (analysis_request_id, report_form_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 요청에 딸린 계약별 정보 — 계약일자·상품명·청약서 유형·약관 매칭

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL	→ analysis_requests.id · 이 계약이 속한 분석 요청
`sequence_no`UQ	integer	NOT NULL	계약 순번(1부터). 화면 표시 순서와 같다
`contract_date`	date	NULL	계약일자
`product_name`	varchar(300)	NULL	상품명
`proposal_type_code`	varchar(100)	NULL	청약서 유형
`terms_document_code`	varchar(200)	NULL	이 계약에 매칭한 약관 문서. 지식컬렉션 파일을 가리키지만 다른 도메인 소유라 값만 보관한다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`policy_no`	varchar(100)	NULL	계약별 증권번호(스마트심사 연계 값 또는 조사자 입력)

인덱스

uq_analysis_request_contracts (analysis_request_id, sequence_no)

이 테이블을 참조하는 곳

analysis_request_contract_items

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 계약별 청약서 질문과 고지사항 항목

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`contract_id`UQ	bigint	NOT NULL	→ analysis_request_contracts.id · 이 항목이 속한 계약
`item_category`UQ	varchar(30)	NOT NULL	PROPOSAL_QUESTION · DISCLOSURE · 항목 갈래 — 청약서 유형별 질문 세트 / 추출값으로 자동 채운 뒤 고치는 고지사항
`item_key`UQ	varchar(200)	NOT NULL	항목 키
`item_label`	varchar(300)	NULL	화면에 보이는 항목 이름
`item_value`	text	NULL	항목 값
`display_order`	integer	NOT NULL	표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_analysis_request_contract_items (contract_id, item_category, item_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 요청이 참조할 지식컬렉션 — 컬렉션은 다른 도메인 소유라 FK 없이 값만 보관한다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL	→ analysis_requests.id · 이 참조가 속한 분석 요청
`collection_id`UQ	bigint	NOT NULL	참조할 컬렉션
`display_order`	integer	NOT NULL	표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_analysis_request_collections (analysis_request_id, collection_id)

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 요청이 고른 컬렉션 안에서 좁혀 볼 문서 — 문서를 고르지 않은 컬렉션은 전체. 다른 도메인 소유라 FK 없이 값만 보관한다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL	→ analysis_requests.id · 이 문서 선택이 속한 분석 요청
`collection_id`	bigint	NOT NULL	문서가 속한 컬렉션(요청의 analysis_request_collections 중 하나)
`file_id`UQ	bigint	NOT NULL	좁혀 볼 컬렉션 문서
`display_order`	integer	NOT NULL	표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_analysis_request_files (analysis_request_id, file_id)

제약 정의 전문 (GitHub)

investigation-core6일 전 · #1941 컬럼 11 분석 요청의 청구병원·대표 상병 — 조사자가 켠 병원만, 요청 시점 스냅샷

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL	→ analysis_requests.id · 이 청구병원이 속한 분석 요청
`sequence_no`UQ	integer	NOT NULL	표시 순서(1부터, 요청 안에서 유일)
`hospital_name`	varchar(200)	NOT NULL	병원 이름 — 병원코드가 붙으면 마스터 이름, 아니면 표지(추출) 이름
`hospital_code`	varchar(50)	NULL	병원코드(병원 마스터 키). 하나로 정해지지 않은 병원(병원 미지정)은 NULL
`extracted_name`	varchar(200)	NULL	표지(추출)에 적힌 병원 이름
`diagnosis_code`	varchar(20)	NULL	대표 상병코드(KCD, 소수점 첫째 자리까지). 고르지 않았으면 NULL
`diagnosis_name`	varchar(200)	NULL	대표 상병명. 고르지 않았으면 NULL
`diagnosis_source`	varchar(20)	NULL	EXTRACTED · SEARCH · 대표 상병을 고른 곳 — EXTRACTED(확인 진단)·SEARCH(직접 검색). 고르지 않았으면 NULL
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_analysis_request_claim_hospitals (analysis_request_id, sequence_no)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2102 컬럼 9 접수 건에서 조사자가 서류 병원명에 지정한 병원

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL	식별자
`report_no`UQ	varchar(50)	NOT NULL	접수번호
`normalized_name`UQ	varchar(300)	NOT NULL	표기 차이를 걷어낸 서류 병원명
`extracted_name`	varchar(300)	NOT NULL	서류에서 뽑은 병원명
`hospital_key`	varchar(100)	NULL	지정한 병원 키(dim_hospitals.hospital_key). NULL 이면 목록에 없는 병원으로 진행한 것
`selected_by_employee_no`	varchar(50)	NULL	지정한 조사자 사번
`created_at`	timestamptz	NOT NULL	생성 일시
`updated_at`	timestamptz	NOT NULL	수정 일시
`cover_relation`	varchar(20)	NULL	SAME_HOSPITAL · OTHER_HOSPITAL · 표지 병원과의 관계 확인. SAME_HOSPITAL=같은 병원, OTHER_HOSPITAL=다른 병원이지만 포함이 맞음, NULL=확인 대상이 아니거나 아직 확인 전

인덱스

uq_report_hospital_selections (report_no, normalized_name)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 11 보고서 초안 — 섹션으로 쪼개지 않고 통 본문으로 둔다. 세부 구성이 아직 미확정이기 때문이다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		→ investigation_reports.report_no · 대상 보고서의 접수번호
`draft_version`UQ	integer	NOT NULL		초안 회차(1부터). 이전 버전을 지우지 않아 무엇을 바꿨는지 되짚을 수 있다
`body`	text	NULL		구역 텍스트를 이어 붙인 통 본문(메일·전송이 읽는 값). 섹션 도입(2026-09-29) 전 초안은 이 값만 있다
`body_format`	varchar(10)	NOT NULL	'TEXT'	TEXT · HTML · 본문 형식 — 평문인지 서식 있는 HTML 인지. 화면이 안전하게 렌더하려면 알아야 한다
`source_summary_version`	integer	NULL		어느 요약 버전의 확정분에서 만들었는지
`created_by_employee_no`	varchar(50)	NULL		초안을 생성시킨 사람의 사번
`edited_by_employee_no`	varchar(50)	NULL		마지막으로 본문을 고친 사람. 생성 직후에는 비어 있다
`edited_at`	timestamptz	NULL		마지막 수정 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_drafts_version (report_no, draft_version)

이 테이블을 참조하는 곳

report_draft_ai_tabs · report_draft_llm_tabs · report_draft_sections

제약 정의 전문 (GitHub)

investigation-core 컬럼 15 보고서 초안 한 버전의 구역(요약 BODY 섹션마다 텍스트 한 장). 조사자 수정본과 조립 시점 원문을 함께 둔다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_draft_id`UQ	bigint	NOT NULL		→ report_drafts.id · 이 구역이 속한 초안 버전
`section_key`UQ	varchar(100)	NOT NULL		요약 섹션 키(summary_sections.section_key)
`section_name`	varchar(300)	NOT NULL		섹션 표시명(조립 시점 값)
`generated_text`	text	NULL		조립 시점 원문 — 반영 체크 항목을 규칙대로 펼친 텍스트. 되돌리기의 복원 값
`section_text`	text	NULL		조사자 수정본. 수정 전이면 원문과 같다. 요약 스냅샷과 동기화하지 않는다
`edited`	boolean	NOT NULL	false	조사자가 손댄 구역인가 — 화면의 수정됨 표시
`edited_by_employee_no`	varchar(50)	NULL		마지막으로 고친 사람
`edited_at`	timestamptz	NULL		마지막 수정 시각
`byte_limit_unit`	varchar(10)	NULL		SECTION · ITEM · TAB · 요약 섹션에서 옮겨 온 byte 제한 단위
`byte_limit_korean`	integer	NULL		요약 섹션에서 옮겨 온 byte 제한(한글 기준)
`byte_limit_english`	integer	NULL		요약 섹션에서 옮겨 온 byte 제한(영문+숫자 기준)
`display_order`	integer	NOT NULL		초안 안에서의 구역 순서(0부터)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_draft_sections_key (report_draft_id, section_key)
idx_report_draft_sections_draft_order (report_draft_id, display_order)

제약 정의 전문 (GitHub)

investigation-core 컬럼 19 보고서 초안 구역별 AI 탭 작업 — 초안 버전의 구역 1개가 1행

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL		행 식별자
`report_no`	varchar(50)	NOT NULL		접수번호
`report_draft_id`UQ	bigint	NOT NULL		→ report_drafts.id · 대상 초안 버전 (report_drafts 참조)
`section_key`UQ	varchar(100)	NOT NULL		대상 구역 키 (report_draft_sections.section_key)
`tab_order`	integer	NOT NULL		탭 순서 — 0 은 첫 탭 에이전트, 1 부터는 나머지 탭 에이전트
`provider`	varchar(30)	NOT NULL		문서 AI 플랫폼 식별자 (ai_pipeline_jobs.provider 와 같은 값)
`status`	varchar(20)	NOT NULL		REQUESTED(맡기기 전) / SUBMITTED(플랫폼 처리 중) / APPLIED(구역에 반영) / FAILED
`external_job_id`	varchar(100)	NULL		플랫폼 작업 식별자 — 맡긴 뒤에 채운다
`idempotency_key`	varchar(100)	NOT NULL		맡기기 요청의 멱등 키 — 행마다 고정
`generated_text`	text	NULL		플랫폼이 쓴 탭 글(근거 표식 제거) — 나머지 탭 지시문의 근거가 된다
`error_code`	varchar(100)	NULL		실패 코드
`error_detail`	varchar(1000)	NULL		실패 상세
`check_count`	integer	NOT NULL	0	플랫폼 상태를 확인한 횟수 — 제한 시간·대기 간격 계산에 쓴다
`next_check_at`	timestamptz	NOT NULL		다음에 진행시킬 시각
`requested_at`	timestamptz	NOT NULL		작업을 만든 시각
`submitted_at`	timestamptz	NULL		플랫폼에 맡긴 시각
`finished_at`	timestamptz	NULL		반영 또는 실패로 끝난 시각
`created_at`	timestamptz	NOT NULL		생성 시각
`updated_at`	timestamptz	NOT NULL		수정 시각

인덱스

uq_report_draft_ai_tabs_section (report_draft_id, section_key)
ix_report_draft_ai_tabs_due (status, next_check_at)

제약 정의 전문 (GitHub)

investigation-core 컬럼 31 보고서 초안 탭별 LLM 직접 호출 원장 — 초안 버전의 템플릿 탭 1개가 1행

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL		행 식별자
`report_no`	varchar(50)	NOT NULL		접수번호
`report_draft_id`UQ	bigint	NULL		→ report_drafts.id · 대상 초안 버전 (report_drafts 참조). v2 「AI 보고서 생성」 단계의 탭이면 NULL
`customer_company_code`	varchar(50)	NOT NULL		템플릿을 고른 위탁사 코드
`tab_key`UQ	varchar(100)	NOT NULL		템플릿 탭 키 — 에이전트 스튜디오 탭 키 tab-{위탁사 코드}-{탭 키}. 2026-10-23 이전 행은 파일 템플릿 키(1-hospital-summary 등)
`tab_name`	varchar(200)	NOT NULL		탭 이름
`tab_order`	integer	NOT NULL		호출 순서 — 0 은 탭1(추출 Job 첨부), 1 부터는 앞 탭 JSON 을 받는다
`section_key`	varchar(100)	NULL		결과를 채울 구역 키 — 초안 구역(report_draft_sections.section_key) 또는 AI 보고서 생성 단계의 요약 구역(summary_sections.section_key). 없으면 원장에만 남긴다
`provider`	varchar(30)	NOT NULL		문서 AI 플랫폼 식별자 (ai_pipeline_jobs.provider 와 같은 값)
`status`	varchar(20)	NOT NULL		REQUESTED(보내기 전·다시 보낼 차례) / RUNNING(보냈고 결과 대기) / SUCCEEDED / FAILED
`prompt_version`	varchar(200)	NULL		쓴 프롬프트 판 — instruct-v<설정 버전>/<탭 키>@<지시문·골격·유형별 본문 지문 12자>. 2026-10-23 이전 행은 <manifest 판>/<탭 키>@<파일 지문>
`schema_name`	varchar(64)	NULL		text.format.name
`model`	varchar(100)	NULL		요청에 실은 모델
`input_job_id`	varchar(100)	NULL		탭1 이 첨부한 추출 Job (input_job, include_parse=false)
`response_id`	varchar(100)	NULL		마지막 시도의 Studio Response 식별자 — 응답을 잃었을 때 재조회에 쓴다
`attempt_count`	integer	NOT NULL	0	보낸 횟수 — 출력 불일치·출력 한도 때만 다시 보낸다
`response_history`	text	NULL		시도별 기록 JSON 배열 [{attempt, responseId, outcome, errorCode, inputTokens, outputTokens}] — 측정·실패 원문 회수용
`output_json`	text	NULL		탭 출력 JSON — 뒤 탭 프롬프트의 {{탭 키}} 변수 값. 서류 내용을 담는다
`repaired`	boolean	NOT NULL	false	재시도를 다 쓰고 키 매칭 보정으로 맞춘 결과인지
`error_code`	varchar(100)	NULL		실패(또는 마지막 재시도 사유) 코드
`error_detail`	varchar(1000)	NULL		실패 상세 — 플랫폼 문구·검증 경로만, 서류 값은 싣지 않는다
`check_count`	integer	NOT NULL	0	진행시킨 횟수 — 대기 간격 계산에 쓴다
`next_check_at`	timestamptz	NOT NULL		다음에 진행시킬 시각
`lease_until`	timestamptz	NULL		실행 잠금 만료 — 한 탭을 두 주기가 동시에 보내지 않게 한다
`requested_at`	timestamptz	NOT NULL		행을 만든 시각
`started_at`	timestamptz	NULL		마지막으로 보낸 시각
`finished_at`	timestamptz	NULL		성공 또는 실패로 끝난 시각
`created_at`	timestamptz	NOT NULL		생성 시각
`updated_at`	timestamptz	NOT NULL		수정 시각
`ai_pipeline_job_id`UQ	bigint	NULL		→ ai_pipeline_jobs.id · v2 「AI 보고서 생성」(GENERATE_REPORT_TABS) 단계 시도 원장 (ai_pipeline_jobs 참조). 초안에 묶인 탭이면 NULL
`extra_instruction`	text	NULL		탭 지시문 끝에 붙일 글 — v2 탭1 의 검수 수정값 줄(원문 → 최종). 없으면 NULL

인덱스

uq_report_draft_llm_tabs_tab (report_draft_id, tab_key)
ix_report_draft_llm_tabs_due (status, next_check_at)
uq_report_draft_llm_tabs_pipeline_job_tab (ai_pipeline_job_id, tab_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 16 사고조사 챗봇 AI 보고서 반영 원장 — Studio 를 부른 반영 한 번이 1행

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL		행 식별자
`report_no`	varchar(50)	NOT NULL		접수번호
`base_summary_version`	integer	NOT NULL		반영 기준이 된 요약 결과 판 (summary_results.summary_version)
`new_summary_version`	integer	NULL		반영으로 만든 요약 결과 판 — REFLECTED 일 때만
`outcome`	varchar(20)	NOT NULL		REFLECTED · NO_CHANGE · FAILED · REFLECTED(새 판) / NO_CHANGE(모든 탭 참조가 비어 새 판 없음) / FAILED(검증·플랫폼 실패·저장 직전 판 충돌)
`error_code`	varchar(100)	NULL		실패 코드 — 우리 검증(OUTPUT_NOT_JSON·TAB_MISSING·REFERENCES_INVALID·TAB_SCHEMA_MISMATCH)·플랫폼 코드·VERSION_CONFLICT
`response_id`	varchar(100)	NULL		Studio Response 식별자 — 응답을 받기 전에 끊겼으면 NULL
`model`	varchar(100)	NULL		플랫폼이 답한 모델
`changed_tabs_json`	text	NULL		고친 탭과 근거 JSON 배열 [{key, name, references[]}] — 모델이 적은 근거 줄(문서명·조항 수준)
`without_case_jobs`	boolean	NOT NULL	false	분류·추출 Job(input_job) 없이 반영했는지 — 스텁 환경이거나 플랫폼 인스턴스가 바뀐 경우
`requested_by_employee_no`	varchar(50)	NULL		반영을 누른 사용자 사번
`requested_at`	timestamptz	NOT NULL		반영을 요청받은 시각
`finished_at`	timestamptz	NOT NULL		결과를 남긴 시각
`created_at`	timestamptz	NOT NULL		생성 시각
`updated_at`	timestamptz	NOT NULL		수정 시각
`instruction_version_no`	integer	NOT NULL	0	이번 반영에 쓴 지시문 판(chat_prompt_versions.version_no, 키 INVESTIGATION_REFLECTION_INSTRUCTION). 기본 문구를 썼으면 0

인덱스

ix_report_reflections_report (report_no, id)

제약 정의 전문 (GitHub)

investigation-core 컬럼 12 보고서 양식(프롬프트 형식) — 관리자 화면의 저장소이자 분석 요청이 고르는 목록

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`template_code`UQ	varchar(100)	NOT NULL		양식 식별자. 버전이 달라도 같은 코드다
`template_version`UQ	integer	NOT NULL		양식 개정 회차
`template_name`	varchar(200)	NOT NULL		양식 이름
`customer_company_code`	varchar(50)	NULL		위탁사 전용 양식이면 그 코드, 공통 양식이면 비어 있다
`body`	text	NULL		프롬프트 형식 본문. 변수는 {{key}} 형태로 본문 안에 들어간다
`active`	boolean	NOT NULL	false	활성 버전 여부. 코드당 하나이며 강제는 애플리케이션이 한다
`hidden`	boolean	NOT NULL	false	화면 목록에 노출하지 않는 양식인지
`deleted_at`	timestamptz	NULL		삭제 시각(soft delete). 이미 참조된 양식을 물리 삭제하면 그 요청이 무엇을 골랐는지 알 수 없다
`created_by_employee_no`	varchar(50)	NULL		등록한 사람의 사번
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_templates_code_version (template_code, template_version)
idx_report_templates_active_code (template_code, active)
idx_report_templates_company (customer_company_code)

이 테이블을 참조하는 곳

report_template_variables

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 양식 본문에 삽입할 수 있는 변수 목록 — 화면의 "변수 삽입" 버튼이 읽는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_template_id`UQ	bigint	NOT NULL	→ report_templates.id · 이 변수가 속한 양식
`variable_key`UQ	varchar(100)	NOT NULL	변수 키. 본문에서는 {{key}} 로 쓴다
`variable_label`	varchar(200)	NULL	화면에 보이는 변수 이름
`display_order`	integer	NOT NULL	표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_report_template_variables (report_template_id, variable_key)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 13 보고서 메일 발송 기록 — 무엇을 누구에게 언제 보냈는지

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL	→ investigation_reports.report_no · 대상 보고서의 접수번호
`draft_version`	integer	NOT NULL	보낸 초안 버전. 초안이 여러 벌이라 이 값이 없으면 무엇을 보냈는지 알 수 없다
`recipient_email`	varchar(200)	NOT NULL	수신 주소. 조직 정보의 사용자 이메일에서 채운다
`recipient_employee_no`	varchar(50)	NULL	수신자 사번
`subject`	varchar(500)	NOT NULL	메일 제목
`dispatch_status`	varchar(20)	NOT NULL	SENT · FAILED · 발송 결과
`failure_reason`	varchar(500)	NULL	발송 실패 사유
`requested_by_employee_no`	varchar(50)	NULL	발송을 요청한 사람의 사번
`dispatched_at`	timestamptz	NOT NULL	발송 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`elapsed_ms`	integer	NULL	SMTP 발송 호출 구간 소요시간(ms). 2026-10-05 이전 행은 NULL(측정값 없음).

인덱스

idx_report_mail_dispatches_report (report_no, dispatched_at)
idx_report_mail_dispatches_dispatched_at (dispatched_at)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 15 보고서 스마트심사 전송 기록 — 전송 시도 1회가 1행

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL	행 식별자
`report_no`	varchar(100)	NOT NULL	→ investigation_reports.report_no · 접수번호
`transmission_seq`	integer	NOT NULL	전송 회차(1부터). 성공한 전송마다 오르고, 실패 뒤 재시도는 같은 회차를 쓴다
`draft_version`	integer	NOT NULL	보낸 보고서 초안 버전
`partner_code`	varchar(10)	NOT NULL	보낸 스마트심사 대외사 코드
`transfer_status`	varchar(20)	NOT NULL	SENT · FAILED · SENT(결과 코드 0000) / FAILED
`http_status`	integer	NULL	응답 HTTP 상태. 응답을 받지 못했으면 NULL
`result_code`	varchar(10)	NULL	응답 결과 코드(0000·4xxx·5xxx). 응답을 받지 못했으면 NULL
`failure_reason`	varchar(500)	NULL	실패 사유 — 받는 쪽의 코드별 고정 문구 또는 연결 실패 요약
`receiver_request_id`	varchar(100)	NULL	응답의 requestId — 스마트심사 로그 추적용
`elapsed_ms`	integer	NULL	HTTP 호출 구간 소요시간(ms)
`requested_by_employee_no`	varchar(50)	NULL	전송을 실행한 사번
`transmitted_at`	timestamptz	NOT NULL	전송 시각 — 전달 JSON 의 transmittedAt 과 같다
`created_at`	timestamptz	NOT NULL	생성 시각
`updated_at`	timestamptz	NOT NULL	수정 시각

인덱스

idx_smart_review_transfers_report (report_no, transmitted_at)
idx_smart_review_transfers_transmitted_at (transmitted_at)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 보고서 파기 증적(보고서 원본과 독립 보존)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL	파기된 보고서의 접수번호
`received_at`	timestamptz	NOT NULL	최초 인입일자(investigation_reports.created_at 스냅샷)
`disposed_at`	timestamptz	NOT NULL	실제 파기 완료 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_report_disposal_logs_disposed_at (disposed_at, id)
idx_report_disposal_logs_report_no (report_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 분석 조건 1번 청구유형 마스터 — 관리자 `보고서 유형 설정`의 목록. 위탁사 공통이며 추가·삭제만 있다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`claim_type_code`UQ	varchar(100)	NOT NULL		청구유형 코드. 삭제된 것까지 포함해 유일하고 재사용하지 않는다. 관리자 추가 유형은 CUSTOM_ 뒤에 id 를 붙인 값
`claim_type_name`	varchar(100)	NOT NULL		표시명. 살아 있는 목록 안에서 중복될 수 없다(삭제된 이름은 다시 쓸 수 있다)
`display_order`	integer	NOT NULL		표시순서. 서버가 매기는 증가값이며 추가한 유형은 맨 뒤에 붙는다 — 순서 변경은 없다
`representative_eligible`	boolean	NOT NULL		대표 청구유형으로 지정할 수 있는가. 기본 14종 중 1~3번만 불가, 관리자 추가 유형은 항상 가능
`built_in`	boolean	NOT NULL		기본 14종인가. 참이면 삭제할 수 없다
`deleted_at`	timestamptz	NULL		삭제 시각. 행을 지우지 않는 이유는 id·코드를 재사용하지 않기 위해서다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`enabled`	boolean	NOT NULL	true	사용자 분석 조건 선택지에 보이는가 — 관리자 활성/비활성 토글, 즉시 적용

인덱스

uq_claim_types_code (claim_type_code)
idx_claim_types_live_order (deleted_at, display_order)

이 테이블을 참조하는 곳

agent_studio_instruct_tab_bodies

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 청약서 폼 설정의 버전 이력 — 관리자 `청약서 폼 설정`이 저장한 유형별 질문·공통 변수 한 벌. 가장 큰 버전이 현재 설정이고 조사자 분석 조건 입력이 읽는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version`UQ	integer	NOT NULL	설정 버전. 저장마다 1 씩 오르며 행은 고치지 않는다. 저장된 행이 없으면 서버 내장 기본값이 버전 0 으로 현재다
`document`	jsonb	NOT NULL	설정 전체의 JSON 문서 — 청약서 유형 목록(forms)과 조사자 직접입력 변수 목록(variables)
`change_note`	varchar(300)	NULL	관리자가 저장 버튼을 눌러 새 버전을 만들 때 기록한 변경 요약 한 줄
`saved_by_employee_no`	varchar(50)	NOT NULL	이 버전을 저장한 관리자 사번
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_application_form_versions_version (version)

제약 정의 전문 (GitHub)

investigation-core 컬럼 5 에이전트 스튜디오 INSTRUCT 설정의 버전 — 저장 한 번이 한 행이고 전 위탁사 탭·본문이 이 버전 아래 복사된다. 가장 큰 버전이 최신 저장본이다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_no`UQ	integer	NOT NULL	버전 번호. 저장마다 1 씩 오르며 행은 고치지 않는다
`saved_by_employee_no`	varchar(50)	NOT NULL	이 버전을 저장한 관리자 사번. 서버가 기동 때 넣은 첫 버전은 SYSTEM
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_instruct_versions_no (version_no)

이 테이블을 참조하는 곳

agent_studio_instruct_tabs

제약 정의 전문 (GitHub)

investigation-core 컬럼 13 에이전트 스튜디오 INSTRUCT 위탁사 탭 — 버전 × 위탁사 × 탭 한 행. 탭 하나가 보고서 에이전트 Instruct 노드 하나다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`version_id`UQ	bigint	NOT NULL	→ agent_studio_instruct_versions.id · 이 탭이 속한 INSTRUCT 버전(agent_studio_instruct_versions.id)
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 마스터 코드(다른 모듈 표라 FK 없음)
`tab_key`UQ	varchar(100)	NOT NULL	탭 고유 키 — 버전이 바뀌어도 같은 탭이면 같은 값. 다른 위탁사 복사·버전 비교에 쓴다
`name`UQ	varchar(100)	NOT NULL	탭 표시명. 같은 버전·위탁사 안에서 겹치지 않는다
`display_order`	integer	NOT NULL	위탁사 안 탭 순서(0부터)
`enabled`	boolean	NOT NULL	사용 여부
`prompt`	text	NOT NULL	탭 프롬프트 — {{계약}} 같은 변수 자리를 품는다. 고른 보고서 유형 본문은 이 뒤 {{조건별작성지침}} 자리에 붙는다
`output_schema`	text	NOT NULL	출력 JSON 골격 — 관리자가 쓴 글 그대로(키 순서 유지). JSON 객체·배열·깊이 상한은 서버가 검사한다
`byte_limit`	integer	NULL	탭 글 byte 제한. NULL 이면 제한 없음. 새 탭 기본 1000
`report_inclusion`	varchar(20)	NOT NULL	BODY · REFERENCE_ONLY · EXCLUDED · 탭 글을 보고서에 싣는 방식 — BODY 본문 포함 / REFERENCE_ONLY 참조 자료로만 / EXCLUDED 화면에서만
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_instruct_tabs_key (version_id, customer_company_code, tab_key)
uq_agent_studio_instruct_tabs_name (version_id, customer_company_code, name)
ix_agent_studio_instruct_tabs_version (version_id, customer_company_code, display_order)

이 테이블을 참조하는 곳

agent_studio_instruct_tab_bodies

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 에이전트 스튜디오 INSTRUCT 탭 × 보고서 유형 본문 — 보고서를 만들 때 고른 보고서 유형의 본문을 탭 프롬프트 뒤 {{조건별작성지침}} 자리에 이어 붙인다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`tab_id`UQ	bigint	NOT NULL	→ agent_studio_instruct_tabs.id · 이 본문이 속한 탭(agent_studio_instruct_tabs.id)
`claim_type_code`UQ	varchar(100)	NOT NULL	→ claim_types.claim_type_code · 보고서 유형(청구유형 마스터) 코드
`body`	text	NOT NULL	그 유형을 골랐을 때 이어 붙일 본문. 빈 본문은 행을 만들지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_agent_studio_instruct_tab_bodies (tab_id, claim_type_code)
ix_agent_studio_instruct_tab_bodies_claim_type (claim_type_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 챗봇·AI 보고서 반영 지시문의 판 — 저장 한 번이 한 행, 지시문마다 가장 큰 판이 지금 쓰는 문구. 행은 고치지 않는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`prompt_key`UQ	varchar(60)	NOT NULL	지시문 이름(코드가 정한 목록) — 예: INVESTIGATION_REFLECTION_INSTRUCTION
`version_no`UQ	integer	NOT NULL	지시문마다 1 부터 저장할 때마다 1 씩 오르는 판 번호
`body`	text	NOT NULL	지시 문구 — 편집 칸 부분만. 데이터 칸·출력 형식과 짝인 문장은 코드에 고정이다(결정 2항)
`saved_by_employee_no`	varchar(50)	NOT NULL	이 판을 저장한 사람의 사번
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_chat_prompt_versions_key_no (prompt_key, version_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 5 1인 동시 AI 분석 요청 한도 — 한 행(id=1)짜리 운영 설정

컬럼	타입		기본값	키·허용값·설명
`id`PK	smallint	NOT NULL
`max_active_jobs_per_investigator`	integer	NOT NULL		조사자 한 명이 동시에 AI 를 돌릴 수 있는 건수(분류중·추출중·분석중), 1 이상
`updated_by`	varchar(50)	NULL		마지막으로 한도를 바꾼 사람의 사번 — 시드 값이면 NULL
`created_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP

제약 정의 전문 (GitHub)

investigation-core 컬럼 11 조사건이 끝까지 쓰는 사고조사 Workflow 설정의 판 — 건마다 한 행, 고치지 않는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	접수번호(investigation_reports.report_no)
`capture_basis`	varchar(20)	NOT NULL	INTAKE · FIRST_USE · INTAKE = 이미지 시스템 API-01 로 건이 처음 생길 때, FIRST_USE = 이 표 이전에 들어온 건을 처음 설정을 읽을 때 고정
`instruct_version_no`	integer	NULL	보고서(에이전트 스튜디오 3단계 INSTRUCT) 판 — agent_studio_instruct_versions.version_no. NULL 이면 그때 저장된 판이 없어 이 건은 LLM 보고서를 만들지 않는다
`application_form_version`	integer	NOT NULL	청약서 폼 설정 판 — application_form_versions.version, 0 은 서버 기본값
`chat_prompt_versions`	jsonb	NOT NULL	지시문 판 — {"지시문 키": chat_prompt_versions.version_no}, 0 은 코드 기본 문구
`claim_type_ids`	jsonb	NOT NULL	그때 살아 있던 보고서 유형(청구유형) — claim_types.id 배열. 유형은 이름·순서를 바꾸지 않고 소프트 삭제만 하므로 id 로 그때 목록이 다시 만들어진다
`studio_agents`	jsonb	NOT NULL	Studio 에이전트 식별자 — {"provider": 플랫폼, "agents": {"용도": {"agentId", "configId"}}}. 접속 대상이 바뀌어 provider 가 다르면 쓰지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`summary_group_version_no`	integer	NULL	요약 그룹 판 — summary_group_versions.version_no. 이 칸이 생기기 전 스냅샷은 NULL 이고 처음 읽을 때 한 번 채운다

인덱스

uq_investigation_settings_snapshots_report_no (report_no)

제약 정의 전문 (GitHub)

업무 데이터 통계GitHub

investigation-core statistics. 차원(dim_*)·사실(report_stat_*)·일별 롤업(stat_daily_*) 의 star schema 와 적재 실패·미매핑 대기열.

erDiagram

"public.report_stat_fact_details" }o--|| "public.report_stat_facts" : "report_stat_fact_id"
"public.report_stat_fact_main_diseases" }o--|| "public.report_stat_facts" : "report_stat_fact_id"

"public.report_stat_facts" {}
"public.report_stat_fact_details" {}
"public.report_stat_fact_main_diseases" {}

investigation-core어제 · #2140 컬럼 9 병원 차원 — 집계 키는 코드이고 표시명은 여기 대표 표기다. 모델이 뽑은 문자열로 집계하지 않는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`hospital_key`UQ	varchar(100)	NOT NULL		집계 키 — 요양기관기호 우선, 없으면 정규화한 명칭 키
`display_name`	varchar(200)	NOT NULL		화면에 쓰는 대표 표기
`region_sido`	varchar(50)	NULL		시/도. 추출 주소를 행정구역 사전으로 파싱해 채운다
`region_sigungu`	varchar(50)	NULL		시/군/구
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`from_master`	boolean	NOT NULL	false	스마트심사 병원 뷰(VW_AI_HOSPINFO)에서 적재한 행인가. 시드·관리자가 만든 키는 FALSE — 숨김 대상이 아니다
`hidden`	boolean	NOT NULL	false	뷰에서 빠져 숨긴 행 — 병원 찾기·병원 지정 후보·지역 선택지에서 뺀다. 키를 가리키는 기록의 이름 표시에는 그대로 쓴다

인덱스

uq_dim_hospitals_key (hospital_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 6 의사 차원

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`doctor_key`UQ	varchar(100)	NOT NULL	집계 키 — 면허번호, 없으면 병원 키 + 정규화한 이름
`display_name`	varchar(200)	NOT NULL	화면에 쓰는 대표 표기
`hospital_key`	varchar(100)	NULL	소속 병원 키. 병원이 미매핑이어도 의사는 남을 수 있어 FK 로 묶지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_dim_doctors_key (doctor_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 5 질병 차원

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`disease_code`UQ	varchar(20)	NOT NULL	KCD 코드
`display_name`	varchar(200)	NOT NULL	KCD 표준 병명
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_dim_diseases_code (disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 12 표기 차이 흡수용 별칭 사전 — 원문 표기 하나가 차원 키 하나로. 세 차원이 같은 형태라 한 표에 둔다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`dimension`UQ	varchar(20)	NOT NULL		HOSPITAL · DOCTOR · DISEASE · 어느 차원의 별칭인지
`alias`UQ	varchar(500)	NOT NULL		모델이 뽑은 원문 표기
`mapped_key`	varchar(100)	NOT NULL		이 표기가 가리키는 차원 키
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`source`	varchar(20)	NOT NULL	'STATISTICS'	INVESTIGATION · ADMIN · STATISTICS · 등재 경로 — INVESTIGATION 사고조사 화면의 병원 지정 단계, ADMIN 관리자 병원 명칭 매핑 화면, STATISTICS 통계 미매핑 큐 처리
`registered_by_employee_no`	varchar(50)	NULL		등재한 사람의 사번. 시드·시스템 등재는 NULL
`report_no`	varchar(100)	NULL		등재한 건의 접수 번호(사고조사 화면 등재만). 관리자·통계 등재는 NULL
`applied_count`	integer	NOT NULL	0	이 이름으로 자동 지정된 횟수(한 건에서 같은 등재는 한 번만)
`last_applied_at`	timestamptz	NULL		마지막으로 자동 지정에 쓰인 시각. 아직 쓰이지 않았으면 NULL
`active`	boolean	NOT NULL	true	사용 여부 — FALSE 면 자동 지정·통계 적재의 별칭 조회에 쓰지 않는다(목록에는 남는다)

인덱스

uq_stat_dim_aliases (dimension, alias)

제약 정의 전문 (GitHub)

investigation-core6일 전 · #1949 컬럼 18 업무 데이터 통계의 보고서당 1행 — 단일값 차원을 담는다. 보고서가 파기돼도 통계는 남아야 하므로 FK 를 두지 않는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		보고서 키
`customer_company_code`	varchar(50)	NOT NULL		위탁사 코드
`claim_type_code`	varchar(100)	NULL		청구유형 — 분석 요청의 보고서 양식 코드를 승계한다
`policy_no`	varchar(100)	NULL		증권번호(청약번호가 아니다). 추출 또는 수기 입력값
`investigator_employee_no`	varchar(50)	NULL		조사자 사번
`department_code`	varchar(30)	NULL		분류 시작 시점의 조사자 소속 부서 스냅샷 — 인사이동 후에도 과거 건은 당시 부서로 집계한다
`department_name`	varchar(200)	NULL		그 시점의 부서 이름 스냅샷
`main_disease_code`	varchar(20)	NULL		보고서 1건을 대표하는 KCD 코드
`transferred_at`	timestamptz	NOT NULL		전송 완료 시각 — 업무 데이터 통계의 기간 축
`processing_seconds`	bigint	NULL		건별 처리시간(초). 집계 범위가 미확정이라 비어 있을 수 있다
`page_count`	integer	NULL		확정 시점의 활성 낱장 수. 통지값이 아니라 실제 개수를 센다
`fact_version`	integer	NOT NULL	1	같은 보고서로 다시 적재될 때마다 오른다. 건수는 늘지 않고 버전만 남는다
`source`	varchar(10)	NOT NULL		STUB · LIVE · 원천 결과의 근원 승계 — 실제 응답인지 스텁인지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`main_disease_name`	varchar(200)	NULL		적재 시점의 메인 질병 표준명 — 마스터에 없으면 NULL(#32)
`main_disease_source`	varchar(20)	NULL		CLAIM_HOSPITAL · AUTO_RULE · 대표 상병을 정한 곳 — CLAIM_HOSPITAL(분석 조건 청구병원 선택)·AUTO_RULE(추출 결과 자동 판정). 대표 상병이 없거나 이 컬럼 이전 적재면 NULL

인덱스

uq_report_stat_facts_report (report_no)
idx_report_stat_facts_transferred_company (transferred_at, customer_company_code)
idx_report_stat_facts_main_disease (main_disease_code)

이 테이블을 참조하는 곳

report_stat_fact_details · report_stat_fact_main_diseases

제약 정의 전문 (GitHub)

investigation-core6일 전 · #1949 컬럼 11 보고서 1건 안의 병원·의사·질병·문서종 조합 — 병원이 3곳이면 3행. 부모가 지워지면 함께 지워진다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_stat_fact_id`	bigint	NOT NULL	→ report_stat_facts.id · 이 조합이 속한 보고서 사실 행
`report_no`UQ	varchar(100)	NOT NULL	보고서 키. 드릴다운·CSV 가 부모 조인 없이 읽도록 승계한다
`seq_no`UQ	integer	NOT NULL	보고서 안에서의 조합 순번
`hospital_key`	varchar(100)	NULL	병원 차원 키. 코드로 바꾸지 못한 값은 비우고 미매핑 대기열에 남긴다
`doctor_key`	varchar(100)	NULL	의사 차원 키
`disease_code`	varchar(20)	NULL	질병 차원 키
`document_type_code`	varchar(100)	NULL	이 조합이 나온 문서종
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`disease_name`	varchar(200)	NULL	적재 시점의 질병 표준명 — 마스터에 없으면 NULL(#32)

인덱스

uq_report_stat_fact_details_seq (report_no, seq_no)
idx_report_stat_fact_details_fact (report_stat_fact_id)
idx_report_stat_fact_details_hospital_disease (hospital_key, disease_code)

제약 정의 전문 (GitHub)

investigation-core6일 전 · #1949 컬럼 4 보고서 1건의 대표 상병 — 조사자가 청구병원마다 고른 상병(중복 없이), 없으면 자동 판정 1건

컬럼	타입		키·허용값·설명
`report_stat_fact_id`PKUQ	bigint	NOT NULL	→ report_stat_facts.id · 이 대표 상병이 속한 통계 사실 행
`disease_order`PK	integer	NOT NULL	순서(0부터) — 청구병원 표시 순서를 따른다
`disease_code`UQ	varchar(20)	NOT NULL	대표 상병 KCD 코드(통계 질병 키)
`disease_name`	varchar(200)	NULL	적재 시점의 상병명 — 마스터 표준명, 마스터에 없으면 조사자가 고른 이름

인덱스

pk_report_stat_fact_main_diseases (report_stat_fact_id, disease_order)
uq_report_stat_fact_main_diseases_code (report_stat_fact_id, disease_code)
idx_report_stat_fact_main_diseases_code (disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 25 시스템 통계의 보고서당 1행 — 분류 시작에 생기고 요약·전송 완료에 갱신된다. 미전송 건도 남는 것이 이 표의 존재 이유다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		보고서 키. 보고서당 1행
`customer_company_code`	varchar(50)	NOT NULL		위탁사 코드
`investigator_employee_no`	varchar(50)	NULL		조사자 사번. 미배정 건은 비어 있다
`department_code`	varchar(30)	NULL		분류 시작 시점의 조사자 소속 부서 스냅샷
`department_name`	varchar(200)	NULL		그 시점의 부서 이름 스냅샷
`requested_at`	timestamptz	NOT NULL		분류 시작(분석 요청) 시각 — 시스템 통계의 기간 축
`summarized_at`	timestamptz	NULL		요약 생성 완료 시각. 요약 전이면 비어 있다
`transferred_at`	timestamptz	NULL		전송 완료 시각. 미전송 건은 비어 있다
`processing_seconds`	bigint	NULL		건별 처리시간(초). 요약 완료 시 채운다
`page_count`	integer	NULL		요약 완료 시점의 활성 낱장 수
`classified_page_count`	integer	NULL		분류된 낱장 수 — 판정을 조회 시점이 아니라 적재 시점에 계산해 수치로 박는다
`corrected_page_count`	integer	NULL		사용자가 분류를 고친 낱장 수
`extracted_field_count`	integer	NULL		추출 항목 수
`corrected_field_count`	integer	NULL		사용자가 고친 추출 항목 수
`reanalyzed`	boolean	NOT NULL	false	최초 요약 이후 다시 분석이 한 번이라도 있었는지
`transferred`	boolean	NOT NULL	false	전송 완료 여부. 전송 완료 시각과 항상 같이 움직인다
`fact_version`	integer	NOT NULL	1	같은 보고서의 생애주기가 처음부터 다시 시작될 때마다 오른다
`source`	varchar(10)	NOT NULL		STUB · LIVE · 원천 결과의 근원 승계
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`summary_edited`	boolean	NULL		#15 검토율의 요약 단계 — 최신 요약 결과에 사용자가 고친 항목이 있는지(E30). 요약 전이면 NULL
`additional_document_restart`	boolean	NOT NULL	false	진행 중인 재실행이 추가 서류로만 돌았는지 — 다음 요약 완료 적재가 읽고 비운다(#15)
`low_confidence_confirmed_page_count`	integer	NULL		#13 저신뢰 분류를 사용자가 그대로 확정한 페이지 수 — 직접 지정도 있으면 세지 않는다. 요약 전 NULL
`chat_reflected`	boolean	NULL		#15 검토율의 챗봇 반영 — 새 판을 만든 반영이 있는지. 요약 전 NULL

인덱스

uq_report_lifecycle_facts_report (report_no)
idx_report_lifecycle_facts_requested_company (requested_at, customer_company_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 7 일별 롤업 — 위탁사·조직별 보고서 건수 (차원 키 없음)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜 (기간 축을 날짜로 자른 값)
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축 — 적재 시점의 부서 스냅샷
`report_count`	integer	NOT NULL	그날 그 축에서 집계된 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_reports (stat_date, customer_company_code, department_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 일별 롤업 — 병원별 청구 집중도. 표시명·지역은 병원 차원이 갖는다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`hospital_key`UQ	varchar(100)	NOT NULL	병원 차원 키
`report_count`	integer	NOT NULL	그날 그 병원이 등장한 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_hospitals (stat_date, customer_company_code, department_code, hospital_key)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 일별 롤업 — 질병코드별 건수. 키는 보고서의 메인 질병코드다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`disease_code`UQ	varchar(20)	NOT NULL	보고서의 메인 질병코드
`report_count`	integer	NOT NULL	그날 그 질병코드로 집계된 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_diseases (stat_date, customer_company_code, department_code, disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 일별 롤업 — 병원 + 질병 조합 건수. 둘 중 하나라도 미매핑이면 제외된다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`hospital_key`UQ	varchar(100)	NOT NULL	병원 차원 키
`disease_code`UQ	varchar(20)	NOT NULL	질병 차원 키
`report_count`	integer	NOT NULL	그날 그 조합이 등장한 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_hospital_diseases (stat_date, customer_company_code, department_code, hospital_key, disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 일별 롤업 — 병원 + 의사 + 질병 조합 건수

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`hospital_key`UQ	varchar(100)	NOT NULL	병원 차원 키
`doctor_key`UQ	varchar(100)	NOT NULL	의사 차원 키
`disease_code`UQ	varchar(20)	NOT NULL	질병 차원 키
`report_count`	integer	NOT NULL	그날 그 조합이 등장한 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_hospital_doctor_diseases (stat_date, customer_company_code, department_code, hospital_key, doctor_key, disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 일별 롤업 — 청구유형별 건수

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`claim_type_code`UQ	varchar(100)	NOT NULL	청구유형 코드
`report_count`	integer	NOT NULL	그날 그 청구유형으로 집계된 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_claim_types (stat_date, customer_company_code, department_code, claim_type_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 일별 롤업 — 청구유형 + 질병 처리 건수(위탁사 → 청구유형 → 진단명 드릴다운)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜(전송 완료 시각의 롤업 시간대 달력 날짜)
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축(부서 스냅샷이 없으면 NULL)
`claim_type_code`UQ	varchar(100)	NOT NULL	청구유형 코드
`disease_code`UQ	varchar(20)	NOT NULL	메인 질병코드
`report_count`	integer	NOT NULL	그날 그 청구유형·질병으로 집계된 보고서 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_claim_type_diseases (stat_date, customer_company_code, department_code, claim_type_code, disease_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 8 일별 롤업 — 증권번호별 청구 현황(동일 증권의 반복 청구 탐지)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	집계 대상 날짜
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 축
`department_code`UQ	varchar(30)	NULL	조직 축
`policy_no`UQ	varchar(100)	NOT NULL	증권번호
`report_count`	integer	NOT NULL	그날 그 증권번호로 들어온 청구 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_policies (stat_date, customer_company_code, department_code, policy_no)

제약 정의 전문 (GitHub)

investigation-core 컬럼 18 일별 롤업 — 시스템 통계의 화면 조회용 집계층. 합계와 모수를 함께 두어 평균을 조회 시점에 나눈다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL		집계 대상 날짜 (분류 시작 시각을 날짜로 자른 값)
`customer_company_code`UQ	varchar(50)	NOT NULL		위탁사 축
`department_code`UQ	varchar(30)	NULL		조직 축
`requested_count`	integer	NOT NULL		그날 분류가 시작된 건수
`summarized_count`	integer	NOT NULL		그날 요약이 끝난 건수
`transferred_count`	integer	NOT NULL		그날 전송이 끝난 건수
`processing_seconds_sum`	bigint	NOT NULL		처리시간 합(초). 모수는 processing_count 다
`processing_count`	integer	NOT NULL		처리시간이 집계된 건수 — 평균의 분모
`classified_page_sum`	bigint	NOT NULL		분류된 낱장 수 합
`corrected_page_sum`	bigint	NOT NULL		분류를 고친 낱장 수 합
`extracted_field_sum`	bigint	NOT NULL		추출 항목 수 합
`corrected_field_sum`	bigint	NOT NULL		고친 추출 항목 수 합
`reanalyzed_count`	integer	NOT NULL		다시 분석이 있었던 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`reviewed_count`	integer	NOT NULL	0	#15 검토 건수 — 분류 정정·추출 수정·요약 수정·챗봇 반영 중 하나라도 있는 보고서 수
`confirmed_page_sum`	bigint	NOT NULL	0	#13 저신뢰 확정 페이지 수 합

인덱스

uq_stat_daily_lifecycle (stat_date, customer_company_code, department_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 추출 완료율 두 축(문서종·필드)의 일별 롤업 — 시스템 통계 #18·#19 가 읽는 집계층

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	분류 시작(분석 요청) 시각을 설정 시간대로 자른 날짜 — 생애주기 롤업과 같은 기간 축
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 코드
`department_code`UQ	varchar(30)	NULL	분류 시작 시점 조사자의 부서 코드 스냅샷. 알 수 없으면 NULL(NULL 도 하나의 축 값)
`axis`UQ	varchar(20)	NOT NULL	DOC_TYPE · FIELD · 축 — DOC_TYPE(문서종) / FIELD(추출 항목)
`axis_key`UQ	varchar(200)	NOT NULL	축 값 — 문서종 코드 또는 추출 항목 키. 표시명 해석 없이 코드 그대로
`extracted_count`	bigint	NOT NULL	그 축 값의 추출 항목 수(완료율의 분모)
`corrected_count`	bigint	NOT NULL	그 가운데 사용자가 값을 바꾼 항목 수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_extraction_quality (stat_date, customer_company_code, department_code, axis, axis_key)
idx_stat_daily_extraction_quality_axis_date (axis, stat_date, customer_company_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 처리시간 구간 일별 롤업 — 시스템 통계 #16 처리시간 분포·#17 매수 구간 달성률·#23 시간 목표률이 읽는 집계층

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	분류 시작(분석 요청) 시각을 설정 시간대로 자른 날짜 — 생애주기 롤업과 같은 기간 축
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 코드
`department_code`UQ	varchar(30)	NULL	분류 시작 시점 조사자의 부서 코드 스냅샷. 알 수 없으면 NULL(NULL 도 하나의 축 값)
`page_bucket`UQ	integer	NOT NULL	활성 페이지 수를 10쪽 단위로 올림(1000쪽 초과는 1010)
`processing_minute`UQ	integer	NOT NULL	건별 처리시간을 분 단위로 올림(120분 초과는 121)
`case_count`	bigint	NOT NULL	그 칸의 건수
`processing_seconds_sum`	bigint	NOT NULL	그 칸의 처리시간 합(초)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_processing_time (stat_date, customer_company_code, department_code, page_bucket, processing_minute)
idx_stat_daily_processing_time_date (stat_date, customer_company_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 조사자별 이용량 일별 롤업 — 시스템 통계 #26 AI 분석 이용자·#27 보고서 생성 건수가 읽는 집계층

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	분류 시작(분석 요청) 시각을 설정 시간대로 자른 날짜 — 생애주기 롤업과 같은 기간 축
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 코드
`department_code`UQ	varchar(30)	NULL	분류 시작 시점 조사자의 부서 코드 스냅샷. 알 수 없으면 NULL(NULL 도 하나의 축 값)
`investigator_employee_no`UQ	varchar(50)	NOT NULL	담당 조사자 사번
`requested_count`	bigint	NOT NULL	분석 요청 건수
`summarized_count`	bigint	NOT NULL	그중 요약(보고서 생성)이 완료된 건수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_investigator_usage (stat_date, customer_company_code, department_code, investigator_employee_no)
idx_stat_daily_investigator_usage_date (stat_date, customer_company_code)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 통계 적재 실패 기록 — 재시도(backfill)의 입력이 된다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		적재에 실패한 보고서
`transferred_at`	timestamptz	NOT NULL		실패한 적재가 쓰려던 전송 완료 시각. 재시도가 같은 기간 축으로 적재하도록 남긴다
`attempt_count`	integer	NOT NULL	1	재시도 횟수
`last_error`	varchar(1000)	NOT NULL		마지막 실패의 예외 유형·메시지. 개인정보가 섞이지 않도록 보고서번호·키만 쓴다
`last_failed_at`	timestamptz	NOT NULL		마지막 실패 시각
`status`	varchar(20)	NOT NULL	'PENDING'	PENDING · RESOLVED · 처리 상태
`resolved_at`	timestamptz	NULL		해소된 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_fact_load_failures_report (report_no)
idx_stat_fact_load_failures_status (status)

제약 정의 전문 (GitHub)

investigation-core 컬럼 11 생애주기 통계 사실 적재 실패 기록 — 보고서 × 단계당 1행, 재적재 명령의 입력

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		보고서번호(FK 없음 — 파기 후 잔존)
`stage`UQ	varchar(20)	NOT NULL		REQUESTED · SUMMARIZED · TRANSFERRED · 실패한 적재 지점 — REQUESTED·SUMMARIZED·TRANSFERRED
`stage_at`	timestamptz	NOT NULL		그 지점의 이벤트 시각 — 재적재가 같은 시각으로 다시 적재한다
`attempt_count`	integer	NOT NULL	1	실패 횟수
`last_error`	varchar(1000)	NOT NULL		마지막 실패의 예외 유형·메시지(1000자 절단)
`last_failed_at`	timestamptz	NOT NULL		마지막 실패 시각
`status`	varchar(20)	NOT NULL	'PENDING'	PENDING · RESOLVED · PENDING(재적재 대기) / RESOLVED(이후 적재 성공)
`resolved_at`	timestamptz	NULL		닫힌 시각(RESOLVED 일 때만)
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_lifecycle_load_failures_report_stage (report_no, stage)
idx_stat_lifecycle_load_failures_status (status)

제약 정의 전문 (GitHub)

investigation-core 컬럼 11 코드로 바꾸지 못한 값의 대기열 — 관리자가 매핑하면 그 보고서를 다시 적재한다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`dimension`	varchar(20)	NOT NULL		HOSPITAL · DOCTOR · DISEASE · 어느 차원의 값인지
`raw_value`	varchar(500)	NOT NULL		바꾸지 못한 원문 값
`report_no`	varchar(100)	NOT NULL		이 값이 나온 보고서. 처리 후 재적재 대상이다
`reason`	varchar(100)	NOT NULL		왜 바꾸지 못했는지
`status`	varchar(20)	NOT NULL	'PENDING'	PENDING · MAPPED · IGNORED · 처리 상태 — 매핑하면 재적재, 무시하면 통계에서 제외
`mapped_key`	varchar(100)	NULL		매핑한 경우 어느 키로 보냈는지
`resolved_by_employee_no`	varchar(50)	NULL		처리한 사람의 사번
`resolved_at`	timestamptz	NULL		처리 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_stat_unmapped_queue_status_dimension (status, dimension)

제약 정의 전문 (GitHub)

워크플로우 엔진GitHub

workflow-core. 단계 정의를 데이터로 두고 엔진이 해석·실행한다. 도메인 비의존이라 업무 건을 report_no 문자열로만 다루고 investigation_reports 로의 FK 를 두지 않는다.

erDiagram

"public.workflow_steps" }o--|| "public.workflow_definitions" : "workflow_definition_id"
"public.workflow_executions" }o--|| "public.workflow_definitions" : "workflow_definition_id"
"public.workflow_step_executions" }o--|| "public.workflow_executions" : "workflow_execution_id"

"public.workflow_definitions" {}
"public.workflow_steps" {}
"public.workflow_executions" {}
"public.workflow_step_executions" {}

workflow-core 컬럼 7 워크플로우 정의 — 코드+버전 단위. 단계 구성을 코드가 아닌 데이터로 둔다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`definition_code`UQ	varchar(50)	NOT NULL		정의 식별 코드 (예: INVESTIGATION_MAIN)
`definition_version`UQ	integer	NOT NULL		같은 코드의 개정 번호
`active`	boolean	NOT NULL	false	활성 버전 여부. 코드별로 한 벌만 활성이며 유일성은 엔진이 보장한다
`description`	varchar(500)	NULL		정의 설명 — 이 워크플로우가 무엇을 도는지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_workflow_definitions_code_version (definition_code, definition_version)

이 테이블을 참조하는 곳

workflow_executions · workflow_steps

제약 정의 전문 (GitHub)

workflow-core 컬럼 13 단계 정의 — 순서·배치 변경이 이 테이블의 데이터 수정만으로 이뤄진다(코드 변경 없음)

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`workflow_definition_id`UQ	bigint	NOT NULL		→ workflow_definitions.id · 이 단계가 속한 워크플로우 정의
`step_code`	varchar(50)	NOT NULL		단계 코드 (CLASSIFY, EXTRACT, ANALYZE, GENERATE_DRAFT, FINAL_TRANSFER …)
`seq_no`UQ	integer	NOT NULL		정의 안에서의 배치 순서
`handler_bean`	varchar(100)	NOT NULL		실행할 Spring bean 이름 — 같은 핸들러를 여러 정의·위치에서 재사용하는 지점
`entry_statuses`	varchar(300)	NOT NULL		이 단계를 시작할 수 있는 처리 상태 목록(콤마 구분). 단계 탐색은 seq_no+1 이 아니라 이 값의 매칭으로 이뤄진다
`success_status`	varchar(40)	NULL		성공 시 전이할 처리 상태. 비어 있으면 상태를 유지한다
`auto_next`	boolean	NOT NULL	false	성공 시 다음 단계로 자동 진행할지. 거짓이면 사용자 이벤트를 기다린다
`gate_logical_changes`	boolean	NOT NULL	true	시작 전 미반영 논리 변경을 선처리할지
`config`	jsonb	NULL		단계별 파라미터(타임아웃·최대 재시도 등)
`enabled`	boolean	NOT NULL	true	이 단계를 실행 대상에 포함할지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_workflow_steps_definition_seq (workflow_definition_id, seq_no)
idx_workflow_steps_definition (workflow_definition_id, seq_no)

제약 정의 전문 (GitHub)

workflow-core 컬럼 10 보고서별 실행 인스턴스 — 업무 건 하나에 대한 워크플로우 진행 상태

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL	대상 업무 건의 접수번호. 이 모듈은 조사 도메인을 알지 못하므로 FK 를 두지 않는다
`workflow_definition_id`	bigint	NOT NULL	→ workflow_definitions.id · 시작 시점의 활성 정의를 고정한다 — 진행 중 재배치가 기존 실행에 영향을 주지 않는다
`current_step_code`	varchar(50)	NULL	현재 머물러 있는 단계
`execution_status`	varchar(20)	NOT NULL	RUNNING · WAITING_USER · FAILED · COMPLETED · SUPERSEDED · 실행 전체의 진행 상태
`baseline_transfer_id`	uuid	NULL	이 실행이 기준으로 삼은 전송 스냅샷
`started_at`	timestamptz	NOT NULL	실행이 시작된 시각
`finished_at`	timestamptz	NULL	실행이 끝난 시각. 진행 중이면 비어 있다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_workflow_executions_report_status (report_no, execution_status)

이 테이블을 참조하는 곳

workflow_step_executions

제약 정의 전문 (GitHub)

workflow-core 컬럼 11 단계 실행 이력 — 재시도마다 한 행이 쌓인다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`workflow_execution_id`UQ	bigint	NOT NULL		→ workflow_executions.id · 이 시도가 속한 실행 인스턴스
`step_code`UQ	varchar(50)	NOT NULL		실행한 단계 코드
`attempt_no`UQ	integer	NOT NULL	1	같은 단계의 몇 번째 시도인지
`status`	varchar(20)	NOT NULL		RUNNING · SUCCEEDED · FAILED · SKIPPED · 이 시도의 결과 상태
`error_code`	varchar(100)	NULL		실패 갈래 코드
`error_detail`	text	NULL		실패 상세 — 내부용이며 외부 응답에 노출하지 않는다
`started_at`	timestamptz	NOT NULL		이 시도가 시작된 시각
`finished_at`	timestamptz	NULL		이 시도가 끝난 시각. 진행 중이면 비어 있다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_workflow_step_executions_attempt (workflow_execution_id, step_code, attempt_no)
idx_workflow_step_executions_execution (workflow_execution_id)

제약 정의 전문 (GitHub)

참조 컬렉션GitHub

collection-core. RAG 참조 컬렉션과 파일의 메타데이터, 폴더 체계(말단 폴더 = 컬렉션), 등록 안내, 개인 컬렉션이 함께 쓰는 사용자별 Vector Store, 공용 컬렉션이 함께 쓰는 2depth 기준 폴더별 Vector Store. 지식컬렉션 본체는 업스테이지가 보유한다.

erDiagram

"public.collections" |o--o| "public.collection_folders" : "folder_id"
"public.collection_files" }o--|| "public.collections" : "collection_id"
"public.collection_approval_requests" }o--|| "public.collections" : "collection_id"
"public.collection_approval_requests" }o--o| "public.collection_files" : "collection_file_id"
"public.collection_approval_requests" }o--o| "public.collection_folders" : "new_folder_parent_id"
"public.collection_approval_requests" }o--o| "public.collection_folders" : "placed_folder_id"
"public.collection_approval_requests" }o--o| "public.collection_folders" : "target_folder_id"
"public.collection_folders" }o--o| "public.collection_folders" : "parent_id"
"public.collection_approval_request_files" }o--o| "public.collection_files" : "collection_file_id"
"public.collection_approval_request_files" }o--|| "public.collection_approval_requests" : "approval_request_id"
"public.collection_folder_vector_stores" |o--|| "public.collection_folders" : "folder_id"
"public.collection_file_parts" }o--|| "public.collection_files" : "collection_file_id"
"public.collection_file_reference_defaults" }o--|| "public.collection_files" : "collection_file_id"

"public.collections" {}
"public.collection_files" {}
"public.collection_approval_requests" {}
"public.collection_folders" {}
"public.collection_approval_request_files" {}
"public.collection_folder_vector_stores" {}
"public.collection_file_parts" {}
"public.collection_file_reference_defaults" {}

collection-core 컬럼 10 지식컬렉션 폴더 — 공용(최대 3단계)·내 컬렉션(1단계) 트리. 말단 폴더가 곧 컬렉션이다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`space`	varchar(20)	NOT NULL		SHARED · PERSONAL · 폴더 공간 — SHARED(공용 컬렉션, 관리자 관리) / PERSONAL(내 컬렉션, 사용자별)
`owner_employee_no`	varchar(50)	NULL		내 컬렉션 폴더의 소유자 사번. 공용 폴더는 비어 있다
`parent_id`	bigint	NULL		→ collection_folders.id · 상위 폴더. 대분류(1단계)는 비어 있다
`name`	varchar(60)	NOT NULL		폴더 이름. 말단 폴더면 컬렉션 이름이자 파일 메타 정보(폴더 경로)의 마지막 단계
`depth`	integer	NOT NULL		1부터 시작하는 단계(대분류 1 › 중분류 2 › 소분류 3)
`seed_key`UQ	varchar(80)	NULL		시드·구버전 배정 마이그레이션의 멱등 키. 사용자가 만든 폴더는 비어 있다
`sort_order`	integer	NOT NULL	0	같은 부모 아래 표시 순서. 시드는 기획 순서, 사용자 생성은 0
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_collection_folders_seed_key (seed_key)
idx_collection_folders_space_owner (space, owner_employee_no)
idx_collection_folders_parent (parent_id)

이 테이블을 참조하는 곳

collection_approval_requests · collection_folder_vector_stores · collection_folders · collections

제약 정의 전문 (GitHub)

collection-core 컬럼 11 RAG 참조 컬렉션 — 개인은 즉시 사용, 공용은 관리자 승인 후 사용. 파일은 우리 저장소에 두고 임베딩·검색용 벡터 인덱스만 외부 AI 플랫폼이 갖는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`collection_type`	varchar(20)	NOT NULL		PERSONAL · SHARED · 개인/공용 구분. 승인 필요 여부를 가르는 값이다
`scope_code`	varchar(50)	NOT NULL	'COMMON'	적용 범위 — 위탁사 코드, 또는 위탁사 무관을 뜻하는 COMMON
`status`	varchar(20)	NOT NULL		ACTIVE · PENDING_APPROVAL · REJECTED · 승인 관점의 사용 가능 여부. 파일 인덱싱 상태와는 다른 축이다
`owner_employee_no`	varchar(50)	NOT NULL		소유자 사번 — 개인 컬렉션의 주인이자 공용 컬렉션의 등록자
`name`	varchar(200)	NOT NULL		컬렉션 이름
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`vector_collection_id`	varchar(200)	NULL		외부 AI 플랫폼이 발급한 벡터 컬렉션 식별자. 플랫폼 어댑터가 없는 조합에서는 비어 있다
`folder_id`UQ	bigint	NULL		→ collection_folders.id · 이 컬렉션이 놓인 말단 폴더(collection_folders). 폴더당 컬렉션 하나이며 컬렉션 이름은 폴더 이름을 따른다
`vector_store_scope`	varchar(20)	NOT NULL	'COLLECTION'	COLLECTION · OWNER · FOLDER · vector_collection_id 의 Store 를 누가 쓰는지 — COLLECTION: 이 컬렉션만, OWNER: 소유자의 개인 컬렉션 전체(collection_owner_vector_stores), FOLDER: 기준 폴더 아래 공용 컬렉션 전체(collection_folder_vector_stores). COLLECTION 이 아니면 Store 를 컬렉션 단위로 바꾸거나 지우지 않는다

인덱스

idx_collections_owner (owner_employee_no)
idx_collections_type_status (collection_type, status)
uq_collections_folder (folder_id)

이 테이블을 참조하는 곳

collection_approval_requests · collection_files

제약 정의 전문 (GitHub)

collection-core 컬럼 21 컬렉션에 등록된 파일과 그 인덱싱 상태

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`collection_id`	bigint	NOT NULL		→ collections.id · 이 파일이 속한 컬렉션
`file_name`	varchar(300)	NOT NULL		업로드된 원본 파일명. 표시·다운로드에 그대로 쓴다
`content_type`	varchar(150)	NULL		업로드 시 선언된 MIME 타입
`byte_size`	bigint	NOT NULL		파일 크기(byte). 상한은 스키마가 아니라 설정값이다
`sha256`	varchar(64)	NOT NULL		내용 해시. 중복 판정의 재료이며 정책이 미확정이라 UNIQUE 로 강제하지 않는다
`storage_path`	varchar(500)	NOT NULL		저장소 상대 경로. 저장 루트는 설정값(hwss.collection.storage-root)이다
`uploader_employee_no`	varchar(50)	NOT NULL		올린 사람의 사번
`indexing_status`	varchar(20)	NOT NULL	'PENDING'	PENDING · INDEXING · READY · FAILED · 벡터 인덱싱 진행 상태
`indexing_failure_reason`	varchar(1000)	NULL		인덱싱 실패 사유. 실패 상태에서만 채워진다
`vector_document_id`	varchar(200)	NULL		외부 AI 플랫폼이 부여한 문서 식별자
`indexed_at`	timestamptz	NULL		인덱싱이 끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`page_count`	integer	NULL		쪽 수(등록 때 파일 정보 또는 PDF 변환 결과). 알 수 없는 형식이면 비어 있다
`original_deleted_at`	timestamptz	NULL		원본 보관 설정 discard 에서 색인을 마친 로컬 원본을 지운 시각. 비어 있으면 로컬 원본이 있다
`preview_status`	varchar(20)	NULL		READY · UNSUPPORTED · FAILED · 미리보기(앞 N쪽 PDF) 상태 — READY·UNSUPPORTED(PDF 로 바꾸지 않는 형식)·FAILED. 비면 아직 없다
`preview_pages`	integer	NULL		미리보기에 담은 쪽 수
`converted_pdf_stored`	boolean	NOT NULL	false	DocMate 변환 전체 PDF 를 색인 전까지 S3 에 임시 보관 중인지
`indexing_claimed_at`	timestamptz	NULL		색인 작업자가 파일을 선점(PENDING → INDEXING)한 시각 — 준비 중·멈춤 판단 기준
`attach_pending`	boolean	NOT NULL	false	이미 올린 플랫폼 문서를 지금 Store 에 붙이기를 기다리는지 — 공용 전환 승인 뒤 처리 대기 동안만 참

인덱스

idx_collection_files_collection (collection_id)
idx_collection_files_sha256 (sha256)

이 테이블을 참조하는 곳

collection_approval_request_files · collection_approval_requests · collection_file_parts · collection_file_reference_defaults

제약 정의 전문 (GitHub)

collection-core 컬럼 11 분할 단위(기본 500쪽)를 넘어 나눠 올린 컬렉션 파일의 조각. 조각마다 플랫폼 문서 하나

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL		조각 식별자
`collection_file_id`UQ	bigint	NOT NULL		→ collection_files.id · 등록 파일(collection_files.id)
`part_no`UQ	integer	NOT NULL		조각 번호(1부터)
`start_page`	integer	NOT NULL		변환 PDF 기준 시작 쪽(1부터, 포함). 앞 조각과 겹친 쪽을 포함한다
`end_page`	integer	NOT NULL		변환 PDF 기준 끝 쪽(포함)
`indexing_status`	varchar(20)	NOT NULL	'PENDING'	PENDING · INDEXING · READY · FAILED · 조각 색인 상태. base.ai.VectorIndexingStatus 와 1:1
`indexing_failure_reason`	varchar(1000)	NULL		조각 색인 실패 사유. 실패 상태에서만 채운다
`vector_document_id`	varchar(200)	NULL		외부 AI 플랫폼이 부여한 조각 문서 식별자
`indexed_at`	timestamptz	NULL		조각 색인 완료 시각
`created_at`	timestamptz	NOT NULL		생성 시각
`updated_at`	timestamptz	NOT NULL		수정 시각

인덱스

uq_collection_file_parts_part (collection_file_id, part_no)

제약 정의 전문 (GitHub)

collection-core 컬럼 14 지식컬렉션 Studio 문서 삭제 의도와 재시도·완료 기록

컬럼	타입		기본값	키·허용값·설명
`id`PK	uuid	NOT NULL
`target`UQ	varchar(64)	NOT NULL		Studio 제공자·접속 주소·프로젝트 조합의 SHA-256
`store_id`UQ	varchar(200)	NOT NULL		정리할 문서가 연결된 Studio Store 식별자
`document_id`UQ	varchar(200)	NOT NULL		Studio 원본 File 식별자
`operation`UQ	varchar(10)	NOT NULL		REMOVE · DETACH · REMOVE 원본 포함 삭제 또는 DETACH 연결만 제거
`state`	varchar(12)	NOT NULL		PENDING · CLAIMED · PROTECTED · DONE · PENDING 대기·CLAIMED 선점·PROTECTED 사용 중·DONE 정리 완료
`claim_id`	uuid	NULL		현재 삭제 작업 선점 UUID
`claim_until`	timestamptz	NULL		삭제 작업 선점 만료 시각
`attempts`	integer	NOT NULL	0	Studio 삭제 호출 시도 횟수
`retry_at`	timestamptz	NOT NULL		다음 정리 시도 가능 시각
`last_error`	varchar(200)	NULL		마지막 실패 예외 종류
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`gave_up_at`	timestamptz	NULL		재시도 상한을 넘겨 정리를 멈춘 시각 — NULL 이면 진행 중. 새 삭제 의도가 오면 비우고 다시 시도

인덱스

collection_document_cleanup_t_target_store_id_document_id_o_key (target, store_id, document_id, operation)
idx_collection_document_cleanup_due (target, state, retry_at)
idx_collection_document_cleanup_document (target, document_id)

제약 정의 전문 (GitHub)

collection-core 컬럼 23 공용 컬렉션 승인 요청 — 재요청은 같은 행을 되돌리지 않고 새 행을 쌓아 이력이 남는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`request_type`	varchar(40)	NOT NULL		SHARED_COLLECTION_CREATE · PERSONAL_TO_SHARED_CONVERSION · SHARED_FILE_ADDITION · 요청 갈래 — 공용 생성 / 개인→공용 전환 / 공용에 파일 추가
`collection_id`	bigint	NOT NULL		→ collections.id · 승인 대상 컬렉션
`collection_file_id`	bigint	NULL		→ collection_files.id · 승인 대상 파일. 파일 추가 요청일 때만 채워진다
`status`	varchar(20)	NOT NULL	'PENDING'	PENDING · APPROVED · REJECTED · 요청의 처리 상태
`requester_employee_no`	varchar(50)	NOT NULL		요청자 사번
`reviewer_employee_no`	varchar(50)	NULL		승인·반려를 처리한 관리자. 대기 중에는 비어 있다
`rejection_reason`	varchar(1000)	NULL		반려 사유. 반려에는 반드시 붙는다
`requested_at`	timestamptz	NOT NULL		요청 시각
`reviewed_at`	timestamptz	NULL		처리 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`first_reviewer_employee_no`	varchar(50)	NULL		1차 승인을 한 사번. 1차를 거치지 않았거나(1차 레벨 없음·최종 승인자가 바로 처리) 아직이면 비어 있다
`first_reviewed_at`	timestamptz	NULL		1차 승인 시각. 값이 있고 status 가 PENDING 이면 최종 승인 대기다
`target_folder_id`	bigint	NULL		→ collection_folders.id · 전환 요청의 공용 대상 — 기존 공용 폴더. 새 폴더 대상이면 비어 있다. 폴더가 지워지면 비워진다(요청 무효)
`new_folder_parent_id`	bigint	NULL		→ collection_folders.id · 전환 요청의 공용 대상 — 새 폴더를 만들 위치(상위 공용 폴더). 기존 폴더 대상이면 비어 있다. 폴더가 지워지면 비워진다(요청 무효)
`new_folder_name`	varchar(60)	NULL		전환 요청의 공용 대상 — 새 폴더 이름(= 신규 컬렉션 이름)
`placement_mode`	varchar(20)	NULL		NEW_COLLECTION · ADD_FILES · 승인 결과 — NEW_COLLECTION(신규 컬렉션으로 배치) / ADD_FILES(기존 컬렉션에 파일 추가). 승인 전·전환 외 요청은 비어 있다
`placed_folder_id`	bigint	NULL		→ collection_folders.id · 승인 결과 — 컬렉션이 놓인(또는 파일이 편입된 컬렉션의) 공용 폴더
`target_collection_id`	bigint	NULL		승인 결과(ADD_FILES) — 파일이 편입된 기존 공용 컬렉션. collection_id 도 이 값으로 옮겨진다
`collection_name_snapshot`	varchar(200)	NULL		요청 당시 컬렉션 이름. 편입 승인으로 개인 컬렉션 행이 사라진 뒤에도 목록에 보이는 이름
`dismissed_at`	timestamptz	NULL		반려된 전환 요청을 요청자가 거둔(제거·재요청) 시각. 거둔 요청의 파일은 잠금이 풀린다
`version`	bigint	NOT NULL	0	낙관적 잠금 버전 — 갱신마다 1 씩 오른다. 읽은 뒤 값이 바뀌었으면 그 갱신은 거절된다

인덱스

idx_collection_approval_requests_status (status)
idx_collection_approval_requests_collection (collection_id)

이 테이블을 참조하는 곳

collection_approval_request_files

제약 정의 전문 (GitHub)

collection-core 컬럼 5 개인→공용 전환 요청에 실린 파일 — 요청 한 건이 고른 파일 목록(파일 단위 전환)

컬럼	타입		키·허용값·설명
`approval_request_id`PK	bigint	NOT NULL	→ collection_approval_requests.id · 파일이 실린 전환 요청(collection_approval_requests). 요청이 지워지면 함께 지워진다
`file_order`PK	integer	NOT NULL	요청 안 파일 순서(0부터)
`collection_file_id`	bigint	NULL	→ collection_files.id · 요청 파일. 승인으로 옮겨 가면 새 파일 행을 가리키고, 파일 행이 지워지면 비워진다
`file_name`	varchar(300)	NOT NULL	요청 시점 파일명 스냅샷
`byte_size`	bigint	NOT NULL	요청 시점 파일 크기(byte) 스냅샷

인덱스

pk_collection_approval_request_files (approval_request_id, file_order)
idx_collection_approval_request_files_file (collection_file_id)

제약 정의 전문 (GitHub)

collection-core 컬럼 5 지식컬렉션 등록 안내 코멘트(전역 한 벌, id = 1). 사용자 파일 추가 모달의 관리자 안내

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`guide_text`	varchar(2000)	NOT NULL	안내 본문. 줄바꿈마다 항목으로 표시한다. 비어 있으면 안내 박스를 보이지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`updated_by_employee_no`	varchar(50)	NULL	마지막으로 안내를 저장한 관리자 사번. 이 칸 도입 전 저장분은 NULL

제약 정의 전문 (GitHub)

collection-core 컬럼 4 사용자별 개인 컬렉션 공용 플랫폼 컬렉션(Vector Store). 사용자당 한 행

컬럼	타입		키·허용값·설명
`owner_employee_no`PK	varchar(50)	NOT NULL	사번
`vector_collection_id`	varchar(200)	NOT NULL	외부 AI 플랫폼이 발급한 벡터 컬렉션 식별자. 그 사용자의 개인 컬렉션이 함께 쓴다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

제약 정의 전문 (GitHub)

collection-core 컬럼 4 공용 컬렉션 기준 폴더(2depth, 1depth 컬렉션이면 그 폴더)별 플랫폼 컬렉션(Vector Store). 기준 폴더당 한 행

컬럼	타입		키·허용값·설명
`folder_id`PK	bigint	NOT NULL	→ collection_folders.id · 기준 폴더 id
`vector_collection_id`	varchar(200)	NOT NULL	외부 AI 플랫폼이 발급한 벡터 컬렉션 식별자. 기준 폴더 아래 공용 컬렉션이 함께 쓴다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

제약 정의 전문 (GitHub)

collection-core 컬럼 16 지식컬렉션 공용 스토어 설명 — Studio 벡터스토어마다 한 행. 자동 상태면 파일이 바뀔 때 처리 중 파일이 없어진 뒤 생성 API 를 한 번 부르고, 사용자 수정 상태면 부르지 않고 반영 안 된 파일 수만 센다. 개인 컬렉션은 설명이 없다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL	nextval('collection_store_descriptions_id_seq')	식별자
`vector_collection_id`UQ	varchar(200)	NOT NULL		Studio 벡터스토어 id(vs_…, collections.vector_collection_id) — 공용 기준 폴더·옛 컬렉션 단위 스토어
`description`	varchar(2000)	NULL		스토어 설명 — 공용은 Studio 스토어 description 과 같게 유지(생성 결과 또는 사용자 수정), 개인은 우리 DB 에만
`regenerate_needed`	boolean	NOT NULL	false	파일 추가·삭제로 설명을 다시 만들어야 하는지(공용만) — 켜져 있는 동안 화면에 「설명 생성 대기」
`next_attempt_at`	timestamptz	NULL		다음 생성 시도 시각 — 호출 제한(429)·실패 뒤 다시 시도할 때. 비면 바로
`failure_count`	integer	NOT NULL	0	연속 실패 횟수 — 다시 시도 간격(1분·5분·30분·1시간)을 정한다
`generated_at`	timestamptz	NULL		마지막으로 생성 설명을 받은 시각
`user_edited_at`	timestamptz	NULL		사용자가 설명을 마지막으로 고친 시각 — 생성 도중 고쳤으면 사용자 수정을 우선한다
`created_at`	timestamptz	NOT NULL		생성 시각
`updated_at`	timestamptz	NOT NULL		마지막 변경 시각
`user_edited`	boolean	NOT NULL	false	사용자 수정 상태 — 설명 변경으로 한 번이라도 저장하면 켜지고, 켜져 있는 동안 파일이 들어와도 자동 생성하지 않는다. 설명 자동 생성 버튼으로 꺼진다
`unreflected_file_count`	integer	NOT NULL	0	사용자 수정 상태에서 스토어에 들어와 설명에 반영되지 않은 파일 수 — 승인 대기·반려 제외, 삭제해도 줄지 않음. 설명 변경·버튼 생성 때 0
`generation_task_id`	varchar(36)	NULL		현재 설명 생성 또는 Studio 반영을 선점한 작업 UUID
`generation_lease_until`	timestamptz	NULL		설명 생성 작업 선점 만료 시각 — 만료 뒤 다른 작업이 이어받을 수 있음
`change_revision`	bigint	NOT NULL	0	파일 변경·사용자 수정·생성 요청·Studio 재반영 필요 상태의 변경 번호
`studio_sync_needed`	boolean	NOT NULL	false	현재 DB 설명을 Studio 에 다시 반영해야 하는지

인덱스

uq_collection_store_descriptions_store (vector_collection_id)
ix_collection_store_descriptions_due (regenerate_needed, next_attempt_at)

제약 정의 전문 (GitHub)

collection-core 컬럼 5 공용 지식컬렉션 위탁사별 참조 기본값 — 켜진 (파일, 위탁사) 칸만 한 행. 행이 없으면 꺼져 있다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL	식별자
`collection_file_id`UQ	bigint	NOT NULL	→ collection_files.id · 기본 참조로 켠 파일(collection_files.id) — 파일이 지워지면 함께 지운다
`customer_company_code`UQ	varchar(50)	NOT NULL	위탁사 코드(customer_companies.customer_company_code, 다른 모듈이라 FK 없음) — 비활성이 돼도 남긴다
`created_at`	timestamptz	NOT NULL	생성 시각
`updated_at`	timestamptz	NOT NULL	마지막 변경 시각

인덱스

uq_collection_file_reference_defaults (collection_file_id, customer_company_code)
idx_collection_file_reference_defaults_customer (customer_company_code)

제약 정의 전문 (GitHub)

운영 (메일 계정·감사)GitHub

mail-core·audit-core. 발송 계정 암호와 그 변경 이력, 감사 로그, 연동 교환 기록(이미지시스템·Studio 요청/응답 본문 — docs/decisions/20261023-integration-exchange-log.md).

mail-core 컬럼 7 단일 대표 SMTP 계정 설정 및 암호화 비밀번호

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`password_cipher`	text	NULL		AES-256-GCM 암호문; NULL이면 서버 설정 비밀번호 사용
`created_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP
`username`	varchar(255)	NULL		SMTP 인증 계정; NULL이면 서버 설정 사용
`smtp_host`	varchar(255)	NULL		SMTP 서버 주소; NULL이면 서버 설정 사용
`settings_updated_at`	timestamptz	NULL		계정 설정 저장 시각

제약 정의 전문 (GitHub)

mail-core 컬럼 5 SMTP 대표 계정 비밀번호 변경 이력 — 비밀번호 값은 저장하지 않는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`changed_at`	timestamp	NOT NULL		비밀번호를 바꾼 시각 — 화면의 "마지막 변경일·다음 변경 예정·D-day" 가 여기서 나온다
`changed_by_employee_no`	varchar(50)	NULL		변경을 수행한 관리자 사번
`created_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP

인덱스

ix_mail_account_password_history_changed_at (changed_at)

제약 정의 전문 (GitHub)

audit-core 컬럼 13 감사 원장 — 관리자 "전체 로그" 화면의 저장소. 이벤트별 전용 컬럼 없이 행위자·대상·결과만 담는 범용 형태

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`actor_employee_no`	varchar(50)	NULL	행위자 사번. 시스템이 일으킨 행위는 비어 있다
`actor_name`	varchar(100)	NULL	행위 시점의 행위자 이름 스냅샷
`actor_role_code`	varchar(30)	NULL	행위 시점의 권한 레벨 스냅샷
`occurred_at`	timestamptz	NOT NULL	행위가 일어난 시각 (기록 시각이 아니다)
`event_type`	varchar(60)	NOT NULL	이벤트 갈래 — 어휘는 애플리케이션 enum(AuditEventType)이 지킨다. CHECK 없음
`target_type`	varchar(40)	NOT NULL	대상 갈래 (AuditTargetType)
`target_id`	varchar(100)	NOT NULL	대상 식별자 — 갈래마다 의미가 다르다(보고서는 접수번호, 컬렉션은 id)
`outcome`	varchar(20)	NOT NULL	SUCCESS · FAILURE · 행위의 성패. 업무 판단이 아니다 — 반려도 SUCCESS
`details`	text	NULL	이벤트별 부가 정보(JSON 문서). 담기는 키는 갈래마다 다르다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`request_id`	varchar(64)	NULL	그 행위를 일으킨 요청 ID — 도입 전 행과 요청 밖 행위는 NULL

인덱스

ix_audit_logs_occurred_at (occurred_at)
ix_audit_logs_target (target_type, target_id, occurred_at)
ix_audit_logs_event_type (event_type, occurred_at)
ix_audit_logs_request_id (request_id)

제약 정의 전문 (GitHub)

audit-core 컬럼 23 연동 교환 기록 — 이미지시스템·Studio 와 오간 요청·응답(본문 포함, 보관 기간 뒤 정리)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL	식별자
`direction`	varchar(10)	NOT NULL	INBOUND · OUTBOUND · 방향 INBOUND(외부→우리)/OUTBOUND(우리→외부)
`system_code`	varchar(20)	NOT NULL	상대 시스템 IMAGE_SYSTEM/STUDIO (base.integration.ExchangeSystem)
`method`	varchar(10)	NOT NULL	HTTP 메서드
`path`	varchar(500)	NOT NULL	경로(쿼리 제외, 발신은 base-url 뺀 경로)
`report_no`	varchar(100)	NULL	관련 접수번호 — 본문 최상위 reportNo/idx01 또는 경로에서 찾은 값, 없으면 NULL
`external_id`	varchar(200)	NULL	상대 시스템 식별자(Studio Job·File id) — 응답 최상위 id
`correlation_id`	varchar(64)	NULL	우리 요청 상관관계 ID(X-Request-Id)
`idempotency_key`	varchar(64)	NULL	멱등 키 헤더 값
`request_content_type`	varchar(120)	NULL	요청 Content-Type
`request_body`	text	NULL	요청 본문(텍스트·JSON 만, 상한에서 잘림) — 멀티파트·바이너리는 NULL
`request_bytes`	bigint	NULL	요청 본문 크기(바이트)
`response_status`	integer	NULL	HTTP 응답 상태, 응답 없음(전송 오류)이면 NULL
`response_content_type`	varchar(120)	NULL	응답 Content-Type
`response_body`	text	NULL	응답 본문(텍스트·JSON 만, 상한에서 잘림) — 바이너리·이벤트 스트림은 NULL
`response_bytes`	bigint	NULL	응답 본문 크기(바이트)
`outcome`	varchar(10)	NOT NULL	SUCCESS · FAILURE · 성패 SUCCESS/FAILURE — 4xx·5xx, 전송 오류, 봉투 success=false 는 실패
`error_message`	varchar(500)	NULL	응답 없는 실패의 요약(예외 종류·메시지 앞 500자)
`started_at`	timestamptz	NOT NULL	요청 시작 시각
`finished_at`	timestamptz	NOT NULL	응답 수신 또는 실패 시각
`elapsed_ms`	bigint	NOT NULL	소요시간(ms)
`created_at`	timestamptz	NOT NULL	생성 시각
`updated_at`	timestamptz	NOT NULL	수정 시각

인덱스

idx_integration_exchanges_started (started_at, id)
idx_integration_exchanges_report (report_no, started_at)
idx_integration_exchanges_system (system_code, direction, started_at)

제약 정의 전문 (GitHub)

문서 AI 플랫폼 연동GitHub

investigation-core. 문서 AI 플랫폼(업스테이지 Studio 등)에 맡긴 작업의 원장과 올린 낱장 파일 대응표, 검수 보정을 플랫폼 저장 결과에 되돌려 놓는 결과 왕복 원장. 워크플로 단계가 외부 작업을 맡기면 폴러가 이 원장으로 업로드·요청·완료 확인·반영을 이어 간다.

erDiagram

"public.ai_pipeline_document_pages" }o--|| "public.ai_pipeline_documents" : "document_id"
"public.ai_pipeline_job_inputs" }o--|| "public.ai_pipeline_jobs" : "job_id"
"public.summary_group_runs" }o--|| "public.summary_group_batches" : "batch_id"

"public.ai_pipeline_jobs" {}
"public.ai_pipeline_documents" {}
"public.ai_pipeline_document_pages" {}
"public.ai_pipeline_job_inputs" {}
"public.summary_group_batches" {}
"public.summary_group_runs" {}

investigation-core 컬럼 22 문서 AI 플랫폼에 맡긴 작업 원장 — 폴러가 업로드·요청·완료 확인·반영을 이어 간다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL		접수번호
`step_code`UQ	varchar(50)	NOT NULL		작업을 맡긴 워크플로 단계 코드(CLASSIFY 등)
`workflow_execution_id`UQ	bigint	NOT NULL		작업을 맡긴 워크플로 실행 id
`attempt_no`UQ	integer	NOT NULL		작업을 맡긴 단계 시도 번호
`provider`	varchar(30)	NOT NULL		작업을 맡은 플랫폼 구현체 식별자(studio 등)
`status`	varchar(20)	NOT NULL		REQUESTED · SUBMITTED · APPLIED · FAILED · DISCARDED · 작업 상태 — REQUESTED/SUBMITTED/APPLIED/FAILED/DISCARDED
`source_transfer_id`	uuid	NULL		작업 기준 전송(실행의 기준 스냅샷)
`external_job_id`	varchar(200)	NULL		플랫폼이 준 작업 식별자
`input_file_ids`	text	NULL		작업 요청에 실은 플랫폼 파일 식별자(줄바꿈 구분, 요청 순서)
`next_check_at`	timestamptz	NOT NULL		폴러가 다음에 이 작업을 확인할 시각
`check_count`	integer	NOT NULL	0	플랫폼 상태를 확인한 횟수
`transient_error_count`	integer	NOT NULL	0	연속된 일시 오류 횟수
`lease_until`	timestamptz	NULL		폴러 임대 만료 시각 — 이 시각 전에는 다른 서버가 잡지 않는다
`error_code`	varchar(100)	NULL		실패·폐기 사유 코드
`error_detail`	varchar(2000)	NULL		실패 내부 진단 상세
`requested_at`	timestamptz	NOT NULL		단계가 작업을 맡긴 시각
`submitted_at`	timestamptz	NULL		플랫폼에 작업을 요청한 시각
`finished_at`	timestamptz	NULL		작업이 반영·실패·폐기로 끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`idempotency_key`	varchar(100)	NULL		플랫폼 작업 요청의 Idempotency-Key. 맡길 때 무작위로 만들어 같은 시도의 재요청에 그대로 쓴다. 옛 행은 NULL

인덱스

uq_ai_pipeline_jobs_attempt (workflow_execution_id, step_code, attempt_no)
idx_ai_pipeline_jobs_due (status, next_check_at)
idx_ai_pipeline_jobs_report (report_no, created_at)

이 테이블을 참조하는 곳

ai_pipeline_job_inputs · report_draft_llm_tabs

제약 정의 전문 (GitHub)

investigation-core 컬럼 9 문서 AI 분류 요청 당시의 낱장 순서·파일명·플랫폼 파일 식별자 원장

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`job_id`UQ	bigint	NOT NULL	→ ai_pipeline_jobs.id · 해당 파일을 모델에 보낸 AI 파이프라인 작업 id
`transaction_id`	varchar(100)	NOT NULL	요청 재시도에도 유지하는 모델 거래 식별자
`input_order`UQ	integer	NOT NULL	모델에 전달한 전체 파일 순서(1부터)
`source_page_id`	varchar(100)	NOT NULL	이 파일이 덮는 첫 낱장의 이미지시스템 식별자 — 쪽별 대응은 ai_pipeline_document_pages
`file_name`	varchar(255)	NOT NULL	모델에 보낸 파일의 요청 당시 파일명
`external_file_id`UQ	varchar(200)	NOT NULL	문서 AI 플랫폼이 발급한 파일 식별자
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_ai_pipeline_job_inputs_order (job_id, input_order)
uq_ai_pipeline_job_inputs_file (job_id, external_file_id)
idx_ai_pipeline_job_inputs_transaction (transaction_id, input_order)

제약 정의 전문 (GitHub)

investigation-core 컬럼 10 문서 AI 플랫폼에 올린 낱장 파일 대응표

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	접수번호
`source_page_id`UQ	varchar(100)	NOT NULL	이미지시스템 페이지 식별자
`sha256`UQ	varchar(64)	NOT NULL	올린 파일 내용의 SHA-256 — 내용이 바뀌면 새로 올린다
`provider`UQ	varchar(30)	NOT NULL	파일을 맡은 플랫폼 구현체 식별자
`external_file_id`	varchar(200)	NOT NULL	플랫폼이 준 파일 식별자
`status`	varchar(20)	NOT NULL	PROCESSING · READY · FAILED · 플랫폼 준비 상태 — PROCESSING/READY/FAILED
`failure_reason`	varchar(500)	NULL	플랫폼이 거절한 사유
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_ai_pipeline_files_page (provider, report_no, source_page_id, sha256)
idx_ai_pipeline_files_external (provider, external_file_id)

제약 정의 전문 (GitHub)

investigation-core 컬럼 13 활성 스캔 낱장을 문서함 순서대로 묶은 사건 단위 여러 쪽 PDF를 문서 AI 플랫폼에 올린 원장(묶음 전환 전 행은 낱장별 한 쪽 PDF)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	접수번호
`snapshot_hash`UQ	varchar(64)	NOT NULL	sourcePageId·내용 해시·순서를 합친 활성 스냅샷 SHA-256
`part_no`UQ	integer	NOT NULL	묶음 PDF 순번(1부터) — 쪽 상한을 넘어 나눈 순서
`first_page`	integer	NOT NULL	스냅샷 전체 활성 낱장 기준 이 PDF의 첫 쪽 번호(1부터)
`page_count`	integer	NOT NULL	PDF 쪽 수 — 묶은 낱장 수
`provider`UQ	varchar(30)	NOT NULL	파일을 맡은 문서 AI 플랫폼 식별자
`external_file_id`	varchar(200)	NOT NULL	문서 AI 플랫폼이 발급한 파일 식별자
`status`	varchar(20)	NOT NULL	PROCESSING · READY · FAILED · 플랫폼 파일 준비 상태 — PROCESSING/READY/FAILED
`failure_reason`	varchar(500)	NULL	플랫폼이 파일 처리를 거절한 사유
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`source_sha256`	varchar(64)	NULL	낱장별 한 쪽 PDF를 만든 원본 낱장의 SHA-256. 여러 낱장을 묶은 PDF는 NULL

인덱스

uq_ai_pipeline_documents_snapshot (provider, report_no, snapshot_hash, part_no)
idx_ai_pipeline_documents_external (provider, external_file_id)

이 테이블을 참조하는 곳

ai_pipeline_document_pages

제약 정의 전문 (GitHub)

investigation-core 컬럼 5 묶음 PDF 쪽과 이미지시스템 sourcePageId 대응표

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`document_id`UQ	bigint	NOT NULL	→ ai_pipeline_documents.id · 묶음 PDF 원장 id
`global_page_no`UQ	integer	NOT NULL	전체 활성 낱장 기준 쪽 번호(1부터)
`page_in_part`UQ	integer	NOT NULL	이 PDF 안의 쪽 번호(1부터)
`source_page_id`	varchar(100)	NOT NULL	이미지시스템 페이지 식별자

인덱스

uq_ai_pipeline_document_pages_global (document_id, global_page_no)
uq_ai_pipeline_document_pages_part (document_id, page_in_part)

제약 정의 전문 (GitHub)

investigation-core 컬럼 27 검수 보정을 플랫폼 저장 결과에 되돌려 놓는 결과 왕복 원장 — 왕복 1회 = 1행, 추가만

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL	접수번호
`provider`	varchar(30)	NOT NULL	플랫폼 구현체 식별자(studio 등)
`target_step_code`	varchar(50)	NOT NULL	이 왕복이 준비하는 워크플로 단계(EXTRACT/ANALYZE)
`pipeline_job_id`	bigint	NOT NULL	준비 대상 작업(ai_pipeline_jobs.id)
`source_result_kind`	varchar(20)	NOT NULL	CLASSIFICATION · EXTRACTION · 덮어쓴 원천 결과 종류 — CLASSIFICATION/EXTRACTION
`source_result_id`	bigint	NOT NULL	덮어쓴 원천 결과 id(classification_results / extraction_results)
`source_external_job_id`	varchar(200)	NOT NULL	덮어쓸 원 Job 의 플랫폼 작업 식별자
`source_file_ids`	text	NOT NULL	원 Job 의 입력 파일 식별자(줄바꿈 구분, 순서)
`corrections_through_id`	bigint	NOT NULL	이 왕복에 담은 마지막 보정 원장 id
`collection_ref`	varchar(200)	NOT NULL	결과 저장소 참조(플랫폼 Collection)
`phase`	varchar(30)	NOT NULL	EXPORT_REQUESTED · EXPORT_READY · IMPORT_UPLOADED · IMPORT_COMMITTED · IMPORT_READY · RESOLVED · FAILED · 왕복 진행 — EXPORT_REQUESTED/EXPORT_READY/IMPORT_UPLOADED/IMPORT_COMMITTED/IMPORT_READY/RESOLVED/FAILED
`idempotency_key`	varchar(100)	NOT NULL	왕복 재시도용 무작위 키
`export_ref`	varchar(200)	NULL	플랫폼 내보내기 참조
`download_ref`	text	NULL	내보낸 결과를 내려받는 참조(서명된 URL 등)
`import_ref`	varchar(200)	NULL	플랫폼 업로드 참조 — 보정 원장의 external_reference 와 같은 값
`resolved_source_job_id`	varchar(200)	NULL	교체로 생긴 갱신 Job — 이어 실행의 source_job_id
`resolved_file_ids`	text	NULL	갱신 Job 의 파일 식별자(줄바꿈 구분, 원 Job 과 같은 순서)
`sent_payload_sha256`	varchar(64)	NULL	올린 본문의 SHA-256
`sent_item_count`	integer	NULL	실제로 덮어쓴 항목 수
`error_code`	varchar(100)	NULL	실패 사유 코드
`error_detail`	varchar(2000)	NULL	실패 내부 진단 상세(값을 담지 않는다)
`requested_at`	timestamptz	NOT NULL	왕복을 시작한 시각
`resolved_at`	timestamptz	NULL	갱신 Job 을 찾은 시각
`finished_at`	timestamptz	NULL	왕복이 끝난(RESOLVED/FAILED) 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_ai_pipeline_result_syncs_job (pipeline_job_id)
idx_ai_pipeline_result_syncs_source (source_result_kind, source_result_id, phase)
idx_ai_pipeline_result_syncs_report (report_no, phase)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 16 요약 그룹 묶음 — 분류 Job 하나에 대한 그룹 요약 한 번(파이프라인 v2 곁가지)

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`	varchar(100)	NOT NULL		보고서 번호
`source_job_id`	varchar(2000)	NOT NULL		문서를 고를 분류 작업 식별자(검수 반영된 Job)
`provider`	varchar(30)	NOT NULL		맡긴 문서 AI 플랫폼 인스턴스 식별자
`status`	varchar(20)	NOT NULL		REQUESTED · RUNNING · COMPLETED · FAILED · SUPERSEDED · REQUESTED(구조 읽기 전)·RUNNING(그룹 진행 중)·COMPLETED·FAILED(그룹 하나라도 실패)·SUPERSEDED(새 분류로 대체)
`structure_version`	integer	NULL		읽은 분류 작업 검수 구조 버전. 읽기 전이면 NULL
`next_check_at`	timestamptz	NOT NULL		다음에 진행시킬 시각
`check_count`	integer	NOT NULL	0	진행 확인 횟수(대기 간격 계산용)
`transient_error_count`	integer	NOT NULL	0	구조 읽기 연속 일시 오류 횟수
`lease_until`	timestamptz	NULL		한 서버만 진행시키는 임대 만료 시각
`error_code`	varchar(100)	NULL		실패 코드
`error_detail`	varchar(2000)	NULL		실패 진단 상세(플랫폼 코드·그룹 코드만)
`requested_at`	timestamptz	NOT NULL		묶음을 만든 시각
`finished_at`	timestamptz	NULL		완료·실패·대체로 닫힌 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_summary_group_batches_report (report_no, id)
idx_summary_group_batches_due (status, next_check_at)

이 테이블을 참조하는 곳

summary_group_runs

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 27 요약 그룹 호출 — 묶음(summary_group_batches) 아래 요약 그룹마다 한 행. 그룹 요약 결과(본문·출처)도 담는다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`batch_id`UQ	bigint	NOT NULL		→ summary_group_batches.id · 이 그룹 호출이 속한 묶음
`report_no`	varchar(100)	NOT NULL		보고서 번호
`group_code`UQ	varchar(100)	NOT NULL		요약 그룹 코드(summary_groups.group_code)
`group_name`	varchar(200)	NOT NULL		호출 시점의 그룹 이름 — 요약 탭 구획 머리말
`display_order`	integer	NOT NULL		호출 시점의 구획 순서
`document_type_codes`	text	NOT NULL		이 건에서 분류된 그룹 문서종 코드(줄바꿈 구분, 그룹 순서) — 참고 문서종 칩
`source_job_id`	varchar(2000)	NOT NULL		문서를 고른 분류 작업 식별자
`structure_version`	integer	NOT NULL		고를 때 읽은 분류 작업의 검수 구조 버전
`document_ids`	text	NOT NULL		고른 플랫폼 문서 식별자(rdoc_…, 줄바꿈 구분, 문서 순서)
`document_labels`	text	NOT NULL		고른 문서의 분류 라벨(document_ids 와 같은 순서, 줄바꿈 구분)
`prompt`	text	NOT NULL		보낸 그룹 프롬프트(input_text)
`fingerprint`	varchar(64)	NOT NULL		분류 작업·구조 버전·문서·프롬프트의 SHA-256 — 같은 값으로 성공한 이전 결과를 다시 쓴다
`status`	varchar(20)	NOT NULL		PENDING · SUBMITTED · SUCCEEDED · REUSED · FAILED · PENDING(요청 전)·SUBMITTED(요청함)·SUCCEEDED(결과 받음)·REUSED(이전 성공 결과 재사용)·FAILED
`idempotency_key`	varchar(100)	NOT NULL		플랫폼 작업 요청 중복 방지 키 — 이 행의 재요청에 같은 값
`external_job_id`	varchar(200)	NULL		플랫폼 요약 작업 식별자. 요청 전·재사용이면 NULL
`result_text`	text	NULL		그룹 요약 본문(플랫폼 Instruct 출력, 인용 표식 제거)
`citations_json`	text	NULL		출처 배열 JSON — additional_values.citations(문서 요소·쪽·좌표)
`output_count`	integer	NULL		결과 원소 수 — 그룹당 1개가 기대값, 문서별로 나뉘어 오면 그 수
`reused_from_run_id`	bigint	NULL		REUSED 일 때 결과를 가져온 이전 행
`transient_error_count`	integer	NOT NULL	0	연속 일시 오류 횟수
`error_code`	varchar(100)	NULL		실패·마지막 일시 오류 코드
`error_detail`	varchar(2000)	NULL		실패 진단 상세(플랫폼 코드·요청 ID 만)
`submitted_at`	timestamptz	NULL		플랫폼에 요청한 시각
`finished_at`	timestamptz	NULL		성공·재사용·실패로 끝난 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_summary_group_runs_batch_group (batch_id, group_code)
idx_summary_group_runs_report_fingerprint (report_no, fingerprint)

제약 정의 전문 (GitHub)

investigation-core2일 전 · #2113 컬럼 11 분류 결과 한 벌 — 버전으로 쌓는다. 재분류가 이전 결과를 지우지 않아야 무엇이 달라졌는지 볼 수 있다

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL		→ investigation_reports.report_no · 대상 보고서의 접수번호
`classification_version`UQ	integer	NOT NULL		보고서 안에서의 분류 회차
`source_transfer_id`	uuid	NOT NULL		이 결과를 산출한 기준 전송
`finalized_at`	timestamptz	NULL		외부 반영을 확정한 시각
`pushed_at`	timestamptz	NULL		이미지 시스템에 역반영한 시각
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`external_job_id`	varchar(200)	NULL		외부 실행(Studio Job) 참조. 레줌 재실행이 이 값을 필요로 한다
`provenance`	varchar(10)	NOT NULL	'STUB'	STUB · LIVE · 결과의 근원 — 실제 에이전트 응답인지 스텁인지
`source_job_ids`	varchar(2000)	NULL		이 결과를 만든 분류 Job 들(분류 차수 순, 쉼표 구분). 증분으로 합친 결과만 채운다 — 비어 있으면 external_job_id 하나

인덱스

uq_classification_results_version (report_no, classification_version)

이 테이블을 참조하는 곳

classification_corrections · classification_result_pages · image_system_outbound_requests

제약 정의 전문 (GitHub)

에이전트 채팅GitHub

chat-core. 범용 에이전트 채팅과 사고조사 챗봇의 대화 세션·주고받은 줄·답변 근거·첨부. 두 챗봇은 같은 표를 쓰고 chat_sessions.chat_kind 로 가른다 — 사고조사 대화는 report_no 를 갖고 (보고서, 사람)마다 하나다 (docs/decisions/20261023-investigation-chat-session-structure.md). report_no 는 조사 모듈 표로 FK 를 걸지 않는다. 대화의 배경지식 컬렉션은 대화 중에 바꿀 수 있고(다음 질문부터), 근거는 우리 식별자와 이름 스냅샷으로 남는다 (컬렉션·파일이 지워져도 지난 대화의 근거 표기가 비지 않게 — FK 를 걸지 않는 이유다). 통계 대시보드 「챗봇 질의 건수」·「질의 답변 응답 속도」의 일별 롤업 2종도 이 모듈에 있다(질문 저장과 같은 트랜잭션 증분).

erDiagram

"public.chat_session_collections" }o--|| "public.chat_sessions" : "chat_session_id"
"public.chat_messages" }o--|| "public.chat_sessions" : "chat_session_id"
"public.chat_message_sources" }o--|| "public.chat_messages" : "chat_message_id"
"public.chat_attachments" }o--o| "public.chat_sessions" : "chat_session_id"
"public.chat_attachments" }o--o| "public.chat_messages" : "chat_message_id"
"public.chat_session_files" }o--|| "public.chat_sessions" : "chat_session_id"
"public.chat_attachment_sets" }o--|| "public.chat_sessions" : "chat_session_id"
"public.chat_attachment_sets" |o--|| "public.chat_messages" : "chat_message_id"
"public.chat_attachment_set_items" }o--|| "public.chat_attachments" : "attachment_id"
"public.chat_attachment_set_items" }o--|| "public.chat_attachment_sets" : "attachment_set_id"
"public.chat_session_retired_conversations" }o--|| "public.chat_sessions" : "chat_session_id"

"public.chat_sessions" {}
"public.chat_session_collections" {}
"public.chat_messages" {}
"public.chat_message_sources" {}
"public.chat_attachments" {}
"public.chat_session_files" {}
"public.chat_attachment_sets" {}
"public.chat_attachment_set_items" {}
"public.chat_session_retired_conversations" {}

chat-core 컬럼 10 에이전트 채팅 대화 세션 — 범용 에이전트 채팅(GENERAL)과 사고조사 챗봇(INVESTIGATION, 보고서·사람마다 하나)

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`owner_employee_no`	varchar(20)	NOT NULL		소유자 사번 — 조회·전송 권한의 기준
`title`	varchar(200)	NOT NULL		대화 제목 — 첫 질문을 자른 값(생성 규칙 회신 대기)
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL
`external_conversation_id`	varchar(100)	NULL		플랫폼(Studio) 대화 식별자(conv_…) — 후속 질문을 같은 플랫폼 대화에 잇는다. 플랫폼이 아직 대화를 열지 않았으면 NULL
`chat_kind`	varchar(20)	NOT NULL	'GENERAL'	GENERAL · INVESTIGATION · 대화 종류 — GENERAL(범용 에이전트 채팅, /api/v1/chat-sessions) / INVESTIGATION(사고조사 챗봇, 보고서 아래 경로). 범용 API 는 GENERAL 만 다룬다
`report_no`	varchar(100)	NULL		사고조사 대화의 보고서번호 — 범용은 NULL. 조사 모듈 표로 FK 를 걸지 않는다
`busy_since`	timestamp	NULL		질문 답변·보고서 반영이 진행 중이면 시작 시각 — 그동안 대화 삭제를 거절한다. 진행 중이 아니면 NULL
`context_segment`	integer	NOT NULL	1	지금 맥락 구획. 이어 가기를 누를 때마다 1 늘어난다

인덱스

idx_chat_sessions_owner (owner_employee_no, id)
uq_chat_sessions_investigation_owner (report_no, owner_employee_no)

이 테이블을 참조하는 곳

chat_attachment_sets · chat_attachments · chat_messages · chat_session_collections · chat_session_files · chat_session_retired_conversations

제약 정의 전문 (GitHub)

chat-core 컬럼 6 대화가 지금 배경지식으로 쓰는 지식컬렉션 (대화 중 변경 가능 — 다음 질문부터 적용)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`chat_session_id`UQ	bigint	NOT NULL	→ chat_sessions.id · 대화 세션
`collection_id`UQ	bigint	NOT NULL	지식컬렉션 — 컬렉션이 지워져도 대화는 남으므로 FK 를 걸지 않는다
`display_order`	integer	NOT NULL	선택 순서
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL

인덱스

uq_chat_session_collections (chat_session_id, collection_id)
idx_chat_session_collections_session (chat_session_id, display_order)

제약 정의 전문 (GitHub)

chat-core 컬럼 6 대화가 지금 배경지식으로 좁혀 쓰는 지식컬렉션 문서 (대화 중 변경 가능 — 비어 있으면 컬렉션 전체)

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`chat_session_id`UQ	bigint	NOT NULL	→ chat_sessions.id · 대화 세션
`file_id`UQ	bigint	NOT NULL	지식컬렉션 파일 — 파일이 지워져도 대화는 남으므로 FK 를 걸지 않는다
`display_order`	integer	NOT NULL	선택 순서
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL

인덱스

uq_chat_session_files (chat_session_id, file_id)
idx_chat_session_files_session (chat_session_id, display_order)

제약 정의 전문 (GitHub)

chat-core 컬럼 2 구분선으로 끝난 구획의 Studio 대화. 대화 삭제·보관 파기 때 함께 지운다

컬럼	타입		기본값	키·허용값·설명
`chat_session_id`PK	bigint	NOT NULL		→ chat_sessions.id · 대화 식별자
`external_conversation_id`PK	varchar(100)	NOT NULL		끝난 구획의 Studio 대화 식별자

제약 정의 전문 (GitHub)

chat-core 컬럼 20 대화 한 줄 — 질문과 답변이 각각 한 행

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`chat_session_id`UQ	bigint	NOT NULL		→ chat_sessions.id · 대화 세션
`role`	varchar(10)	NOT NULL		화자 USER(질문)/AGENT(답변)
`body`	text	NOT NULL		본문
`answer_origin`	varchar(10)	NULL		답변 출처 STUB/LIVE — 질문 행은 NULL
`sequence_no`UQ	integer	NOT NULL		대화 안 표시 순서 — 같은 트랜잭션의 두 행을 가른다
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL
`response_millis`	bigint	NULL		답변 응답 소요시간(ms) — 지식 검색 시작부터 모델 답 수신까지. 질문 행·컬럼 추가 전 답변 행은 NULL
`department_code`	varchar(30)	NULL		질문한 때 질문자의 부서 코드 스냅샷 — 통계 조직 축. 찾지 못했거나 컬럼 추가 전 행은 NULL
`prompt_key`	varchar(60)	NULL		답변에 쓴 지시문 이름 — 2026-11-05 전 사고조사 답변 줄만(그 뒤는 prompt_versions)
`prompt_version_no`	integer	NULL		답변에 쓴 지시문 판 번호 — 2026-11-05 전 사고조사 답변 줄만(그 뒤는 prompt_versions). 기본 문구면 0
`reflection_grounded`	boolean	NULL		사고조사 답변이 AI 보고서 반영 버튼의 근거 조건(인용 출처 + 참조 탭 ≥ 1)을 만족했는지 — 버튼은 이 값과 지금의 반영 권한을 함께 본다. 범용은 NULL
`turn_scope`	text	NULL		사고조사 질문 줄의 그 턴 검색 범위 JSON {collectionIds, fileIds, caseDocuments}. 범용 줄·답변 줄·이전 줄은 NULL
`studio_response_id`	varchar(100)	NULL		답변 줄을 만든 Studio 응답 id — 마지막 질문 삭제 때 그 턴을 지운다. 질문 줄·스텁·이전 답변은 NULL
`reflected_at`	timestamp	NULL		사고조사 답변을 AI 보고서에 반영한 시각. 반영하지 않았거나 범용 줄이면 NULL
`input_tokens`	bigint	NULL		답변 턴의 입력 토큰(Studio usage). 질문 줄·스텁·이전 답변은 NULL
`output_tokens`	bigint	NULL		답변 턴의 출력 토큰(Studio usage). 질문 줄·스텁·이전 답변은 NULL
`context_segment`	integer	NOT NULL	1	이 줄의 맥락 구획. 대화의 지금 구획보다 작으면 구분선 위 줄로 답변에 쓰지 않는다
`prompt_versions`	text	NULL		답변에 쓴 지시문 판 — {지시문 이름: 판 번호} JSON(기본 문구면 0). 사고조사는 INVESTIGATION_ROLE·INVESTIGATION_ANSWER_RULES·CHAT_INTENT_RULES, 범용은 CHAT_INTENT_RULES. 질문 줄과 2026-11-05 전 답변 줄은 NULL

인덱스

uq_chat_messages_sequence (chat_session_id, sequence_no)
idx_chat_messages_session (chat_session_id, sequence_no)

이 테이블을 참조하는 곳

chat_attachment_sets · chat_attachments · chat_message_sources

제약 정의 전문 (GitHub)

chat-core 컬럼 17 답변 근거 — 우리 식별자 + 이름 스냅샷

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`chat_message_id`	bigint	NOT NULL		→ chat_messages.id · 근거가 붙는 답변 줄
`collection_id`	bigint	NULL		지식컬렉션 — 원본이 지워질 수 있어 FK 를 걸지 않는다
`collection_name`	varchar(200)	NULL		컬렉션 이름 스냅샷 — 원본 삭제로 근거 표기가 비지 않게 한다
`collection_file_id`	bigint	NULL		컬렉션 파일
`file_name`	varchar(500)	NOT NULL		파일명 스냅샷
`snippet`	text	NULL		근거 문구
`score`	float8	NULL		관련도 — 판정은 플랫폼의 몫이라 다시 정렬하지 않는다
`display_order`	integer	NOT NULL		근거 표시 순서
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL
`source_kind`	varchar(20)	NOT NULL	'COLLECTION'	COLLECTION · ATTACHMENT · CASE_DOCUMENT · REPORT_SECTION · 출처 종류 — COLLECTION(지식컬렉션 파일) / ATTACHMENT(이번 턴 첨부) / CASE_DOCUMENT(사건 서류 낱장) / REPORT_SECTION(보고서 탭)
`chat_attachment_id`	bigint	NULL		첨부 출처의 첨부(chat_attachments.id) — 원장이 지워질 수 있어 FK 를 걸지 않는다
`page_number`	integer	NULL		쪽 번호(Studio page_number) — 없으면 NULL
`case_page_id`	varchar(100)	NULL		사건 서류 근거의 이미지시스템 낱장 식별자(report_pages.source_page_id) — 플랫폼 파일이 다시 올라가도 같은 낱장을 연다. FK 를 걸지 않는다
`report_tab_number`	integer	NULL		보고서 섹션 근거의 탭 번호(1부터) — 탭 이름은 file_name 에 스냅샷
`regions_json`	text	NULL		근거의 쪽 안 위치 JSON — [{x, y, width, height}] 쪽 왼쪽 위 원점 0~1 비율 상자. 첨부 인용은 문장 단위, 지식컬렉션·사건 서류 검색 근거는 청크(쪽) 단위. 없으면 NULL

인덱스

idx_chat_message_sources_message (chat_message_id, display_order)

제약 정의 전문 (GitHub)

chat-core 컬럼 14 챗봇 첨부 준비 이력 — 메시지 연결 전 PDF 변환 및 외부 파일 업로드 결과

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`owner_employee_no`	varchar(20)	NOT NULL	첨부를 올린 사용자 사번
`original_file_name`	varchar(500)	NOT NULL	사용자가 올린 원본 파일명
`original_content_type`	varchar(200)	NULL	사용자가 올린 원본 MIME 형식
`page_count`	integer	NOT NULL	DocMate file/info로 확인한 원본 쪽 수
`source_sha256`	varchar(64)	NOT NULL	원본 내용 SHA-256 식별값
`provider`	varchar(30)	NOT NULL	외부 파일 저장소 구현 식별자
`external_file_id`UQ	varchar(200)	NULL	외부 파일 저장소가 반환한 파일 식별자
`status`	varchar(20)	NOT NULL	PROCESSING · READY · FAILED · 외부 파일 상태 PROCESSING/READY/FAILED
`failure_reason`	varchar(500)	NULL	외부 업로드 실패 시 사용자 노출 가능한 요약
`created_at`	timestamp	NOT NULL
`updated_at`	timestamp	NOT NULL
`chat_message_id`	bigint	NULL	→ chat_messages.id · 첨부를 소비한 USER 질문 메시지 — NULL은 아직 질문에 사용하지 않음
`chat_session_id`	bigint	NULL	→ chat_sessions.id · 올릴 때부터 묶인 대화 — 사고조사 첨부만. NULL 은 범용 첨부(질문에 쓰일 때 chat_message_id 로만 묶인다)

인덱스

uq_chat_attachments_external_file (external_file_id)
idx_chat_attachments_owner_created (owner_employee_no, created_at)
idx_chat_attachments_message (chat_message_id)
idx_chat_attachments_session (chat_session_id)

이 테이블을 참조하는 곳

chat_attachment_set_items

제약 정의 전문 (GitHub)

chat-core 컬럼 7 채팅 세션에서 마지막으로 선택한 첨부 묶음 이력

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL	nextval('chat_attachment_sets_id_seq')
`chat_session_id`	bigint	NOT NULL		→ chat_sessions.id · 첨부 묶음을 사용하는 채팅 세션 식별자
`chat_message_id`UQ	bigint	NOT NULL		→ chat_messages.id · 이 첨부 묶음을 처음 선택한 질문 메시지 식별자
`total_pages`	integer	NOT NULL		첨부 묶음에 포함된 파일 페이지 수 합계
`created_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP
`context_segment`	integer	NOT NULL	1	첨부셋을 보낸 때의 맥락 구획. 지금 구획의 첨부셋만 싣고 쪽수를 센다

인덱스

uq_chat_attachment_sets_message (chat_message_id)
idx_chat_attachment_sets_session_latest (chat_session_id, id)

이 테이블을 참조하는 곳

chat_attachment_set_items

제약 정의 전문 (GitHub)

chat-core 컬럼 6 첨부 묶음에 포함된 파일과 전달 순서

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL	nextval('chat_attachment_set_items_id_seq')
`attachment_set_id`UQ	bigint	NOT NULL		→ chat_attachment_sets.id · 소속 첨부 묶음 식별자
`attachment_id`UQ	bigint	NOT NULL		→ chat_attachments.id · Studio 파일과 연결된 채팅 첨부 식별자
`display_order`UQ	integer	NOT NULL		Studio에 전달할 첨부 순서(0부터 시작)
`created_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamptz	NOT NULL	CURRENT_TIMESTAMP

인덱스

uq_chat_attachment_set_items_attachment (attachment_set_id, attachment_id)
uq_chat_attachment_set_items_order (attachment_set_id, display_order)

제약 정의 전문 (GitHub)

chat-core 컬럼 8 챗봇 질의 건수의 일별 롤업 — 시스템 통계 「챗봇 질의 건수」(시트 29행)가 읽는 집계층

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	질문이 저장된 시각을 설정 시간대로 자른 날짜
`employee_no`UQ	varchar(20)	NOT NULL	질문자 사번
`department_code`UQ	varchar(30)	NULL	질문한 때 질문자의 부서 코드 스냅샷. 모르면 NULL(NULL 도 하나의 축 값)
`chat_kind`UQ	varchar(20)	NOT NULL	GENERAL · INVESTIGATION · 챗봇 구분 — GENERAL(범용) / INVESTIGATION(사고조사)
`question_count`	bigint	NOT NULL	답변까지 저장된 사용자 질문 수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_chat_questions (stat_date, employee_no, department_code, chat_kind)
idx_stat_daily_chat_questions_date (stat_date)

제약 정의 전문 (GitHub)

chat-core 컬럼 7 질의 답변 응답 소요시간의 일별 롤업 — 시스템 통계 「질의 답변 응답 속도」(시트 30행)가 읽는 집계층

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`stat_date`UQ	date	NOT NULL	답변이 저장된 시각을 설정 시간대로 자른 날짜
`department_code`UQ	varchar(30)	NULL	질문한 때 질문자의 부서 코드 스냅샷. 모르면 NULL
`response_second`UQ	integer	NOT NULL	응답 소요시간을 초 단위로 올린 값(0~3600). 3601 은 1시간 초과를 모은 칸
`answer_count`	bigint	NOT NULL	그 초에 응답한 답변 수
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_stat_daily_chat_response_time (stat_date, department_code, response_second)
idx_stat_daily_chat_response_time_date (stat_date)

제약 정의 전문 (GitHub)

스마트심사 제공 뷰

스마트심사가 제공하는 읽기 전용 뷰입니다 — 우리가 만든 스키마가 아니라 Oracle 19.11.0.0.0 의 SMART 스키마에 있고, 실제 접속해야만 무엇이 있는지 알 수 있습니다. 여기 보이는 것은 2026-11-11 기준 스냅샷(실제 접속으로 뜬 값)이며, 어댑터가 읽는 뷰·컬럼이 이 목록에 있는지는 SmartReviewViewContractTest 가 지킵니다 · 명세서.

23,992행 컬럼 2 질병코드 마스터

질병코드와 병명의 마스터. 2026-09-16 실측에서 처음 나타났고 같은 날 스마트심사 확인으로 용도가 정해졌다 — 뷰 정의서(v1.5)에는 아직 실려 있지 않다. 통계 차원 dim_diseases(코드 + 표준 병명)를 채울 원천이 될 수 있다. 코드 체계(KCD 차수 등)와 갱신 주기는 아직 확인되지 않았다. 2026-10-28 실측 0행(9/16 은 23,938행)은 스마트심사 테스트 중 삭제 — 같은 날 재적재 완료 회신. 2026-10-29 재실측 2,110행, 2026-11-11 재실측 23,992행으로 9/16 수준 회복.

컬럼	타입			설명
`DSAS_CODE`	VARCHAR2(16)	NULL		질병코드
`DSAS_NAME`	VARCHAR2(200)	NULL		질병명

5행 컬럼 3 파기정보 (대외)

DES_CO_DATE 에 맞춰 파기(날짜 지정형). 조회 범위는 조회일 기준 과거 30일.

컬럼	타입		설명
`CONU_SQNO`	VARCHAR2(50)	NOT NULL	보고서번호
`EXT_CMPN_DVCD`	VARCHAR2(10)	NULL	대외사 코드
`DES_CO_DATE`	VARCHAR2(8)	NULL	파기완료일자

150,468행 컬럼 14 병원정보 마스터

병원코드·병원명·주소·지역 코드의 마스터(오브젝트정의서 v1.7 신규, v1.9 2026-11-11 에 HSPL_FULL_ADDR 추가·HSPL_ADDR 를 시군구만으로 변경). 갱신은 한화생명 배치(신규 병원은 다음 날, 2026-10-28 회신). 2026-11-11 스마트심사 1차 가공 — 이름에 테스트 포함·약국·주소 공란 제외, 같은 이름+같은 시군구 중복 제외 → 150,468행(코드 유일). 이름 표기 차이·주소 표기 차이로 남은 중복은 스마트심사가 제거 불가로 회신했다.

컬럼	타입		설명
`HSPL_CODE`	VARCHAR2(10)	NOT NULL	병원코드 — 마스터 키 (2026-11-11 실측 코드 유일)
`HSPL_NM`	VARCHAR2(150)	NULL	병원명
`HSDR_NM`	VARCHAR2(150)	NULL	병원장명
`HSPL_TLNO`	VARCHAR2(20)	NULL	병원전화번호
`HSPL_PSCD`	VARCHAR2(10)	NULL	병원우편번호
`HSPL_ADDR`	VARCHAR2(1005)	NULL	병원주소(시군구) — 「시도 시군구」 두 낱말만(예: 경기 분당구). 정의서 길이 500, 실측 타입 1005
`HSPL_FULL_ADDR`	VARCHAR2(500)	NULL	병원주소(전체) — 원본 전체 주소(v1.9 신규). 적재의 지역 파생 원천
`CTPR_DVSN_CODE`	VARCHAR2(10)	NULL	시도구분코드 (정의서 v1.9 — A 서울 ~ S 제주로 보인다, 코드표 미제공)
`HSPL_ASCF_DVSN_CODE`	VARCHAR2(10)	NULL	병원종별구분코드 (코드표 미제공)
`CRNO`	VARCHAR2(10)	NULL	사업자등록번호
`RCPR_ORGN_NO`	VARCHAR2(8)	NULL	요양기관번호
`HSPL_CNTY_CODE`	VARCHAR2(10)	NULL	병원국가코드 (정의서 v1.9 — 대부분 KR, 시군구 코드 아님)
`RCPR_ORGN_VRFC_YN`	VARCHAR2(1)	NULL	요양기관검증여부
`ROAD_NM_ADDR_YN`	VARCHAR2(1)	NULL	도로명주소여부

11,871행 컬럼 2 파기정보 (대내)

LAST_PRCS_DATE + 90일 경과 시 파기(기간 계산형). 2026-10-28 실측 0행(9/16 은 53,533행)은 스마트심사 테스트 중 삭제 — 같은 날 재적재 완료 회신.

컬럼	타입			설명
`CSNL_SQNO`	VARCHAR2(12)	NULL		보고서번호 (이 뷰만 CSNL_SQNO 표기)
`LAST_PRCS_DATE`	VARCHAR2(8)	NULL		손해사정결재일자. 수령분 라벨은 최종결재일자

37,921행 컬럼 7 조사 건 계약 메타

계약 수만큼 다행. 보고서번호 실형식은 AIyyyymmddNNNN.

컬럼	타입		설명
`CONU_SQNO`	VARCHAR2(50)	NULL	조사 건 번호(보고서번호). 정의서 표기는 COINU_SQNO — 표기 불일치 미해소
`EXT_CMPN_DVCD`	VARCHAR2(10)	NULL	대외사(위탁사) 코드. 명칭은 공통코드 뷰로 해석. NULL 5,377건
`INVR_MPNO`	VARCHAR2(8)	NULL	조사자 사번 (실데이터 7자리)
`ACCI_NAME`	VARCHAR2(100)	NULL	사고자명 (피보험자명이 아니다 — 정의서 v1.5 확정) 개인정보
`POLY_NO`	VARCHAR2(50)	NULL	증권번호
`IRKD_CODE_NAME`	VARCHAR2(200)	NULL	보험종류(상품)명
`CNTT_DATE`	VARCHAR2(8)	NULL	계약일자 yyyymmdd

11행 컬럼 7 알림톡 발송

조회용이 아니라 발송 큐로 보인다 — 행을 INSERT 해 알림톡을 트리거하는 대상. 용도 확인 필요.

컬럼	타입		설명
`MT_PR`	NUMBER(11)	NOT NULL	고유 키 (SQ_ATA_MMT_TRAN_01 시퀀스)
`DATE_CLIENT_REQ`	TIMESTAMP(6)	NOT NULL	전송예약시간
`SENDER_KEY`	VARCHAR2(40)	NOT NULL	발신 프로필 키. 정의서 길이(8)와 고정값 예시(40자) 불일치 — 확인 필요
`CALLBACK`	VARCHAR2(25)	NOT NULL	발신자 전화번호
`TEMPLATE_CODE`	VARCHAR2(40)	NULL	템플릿 코드 (고정값 IMG00001)
`CONTENT`	VARCHAR2(4000)	NOT NULL	전송 메시지 (고정 템플릿)
`RECIPIENT_NUM`	VARCHAR2(25)	NULL	수신자 전화번호 개인정보

80행 컬럼 6 공통코드

공통 뷰 + 코드 구분 방식. 그룹 3종 — EXT_CMPN_DVCD(위탁사)·DUTY_CODE(직책)·RNKS_CODE(직급).

컬럼	타입		설명
`CMPN_DVCD`	VARCHAR2(10)	NOT NULL	회사 구분 (실측 전부 0000)
`CODE_ID`	VARCHAR2(20)	NOT NULL	코드 그룹
`CODE_VAL`	VARCHAR2(30)	NOT NULL	코드 값
`CODE_IDNM`	VARCHAR2(200)	NULL	코드 그룹 명
`CODE_NAME`	VARCHAR2(4000)	NULL	코드 명
`OUTP_ORDR`	NUMBER(22)	NULL	표시 순서

95행 컬럼 9 조직도 (정의서 공식명: 부서정보)

컬럼	타입		설명
`ORGN_CODE`	VARCHAR2(20)	NOT NULL	조직 코드 (정의서 용어: 기관코드)
`ORGN_NAME`	VARCHAR2(50)	NULL	조직 명
`PRCD_ORGN`	VARCHAR2(40)	NULL	상위 조직 코드 (재귀 구조)
`PRCD_NAME`	VARCHAR2(50)	NULL	상위 조직 명
`USE_YN`	VARCHAR2(1)	NULL	사용 여부
`ORGN_CRTN_DATE`	VARCHAR2(8)	NULL	개설일
`ORGN_CLOS_DATE`	VARCHAR2(8)	NULL	폐쇄일
`ORGN_LV`	NUMBER(3)	NULL	조직 레벨 (실측 1~4). 정의서는 VARCHAR2(3) 로 표기 — 타입 불일치 미해소
`HOD_NO`	VARCHAR2(8)	NULL	부서장 사번

1,898행 컬럼 9 사용자

로그인 신원·세션 정보의 라이브 원천.

컬럼	타입		설명
`EMPL_NO`	VARCHAR2(8)	NOT NULL	사번 (세션 기준키)
`NAME`	VARCHAR2(50)	NULL	성명 개인정보
`CONN_PSYN`	VARCHAR2(1)	NULL	접속가능여부 — 계정 활성 여부로 쓴다(N 이면 비활성: 로그인 거절·조직도 기본 제외, 결정 20261012)
`DUTY_CODE`	VARCHAR2(10)	NULL	직책 코드 (공통코드 뷰로 해석)
`RNKS_CODE`	VARCHAR2(10)	NULL	직급 코드 (공통코드 뷰로 해석)
`WORK_PSTN_OGCD`	VARCHAR2(20)	NULL	근무 조직 코드 — 대부분 단·팀. 센터 코드가 없거나 폐쇄면 소속
`ORIG_PSTN_OGCD`	VARCHAR2(20)	NULL	원소속 조직 코드 (미사용 — 대부분 근무 조직 코드와 같다)
`WORK_PSTN_CECD`	VARCHAR2(20)	NULL	근무소속센터코드 — 사용 중이면 소속(부서장 지정 다음 순위)
`ENTR_DATE`	VARCHAR2(8)	NULL	입사일

251행 컬럼 2 사용자이력정보

사원별 최종 인사 변경일시 — 근무소속기관·센터 코드, 직책, 직급이 바뀔 때만 갱신된다(스마트심사 정의서 2026-10-19). 사번당 한 행이고 한 번도 바뀌지 않은 사원은 행이 없다. 2026-10-22 읽기 전용 조회로 컬럼·건수를 실측해 이 항목만 더했다(스냅샷 스크립트 재실행 아님 — 다음 --json 갱신 때 덮어써도 같다). 조직도 「변경 대상자」의 원천(결정 20260827).

컬럼	타입			설명
`EMPL_NO`	VARCHAR2(8)	NOT NULL		사원번호
`LAST_CHNG_DTTM`	DATE	NOT NULL		최종변경일시

스키마가 바뀌면 ./scripts/db-docs.sh 로 docs/db/ 를 다시 만들어 마이그레이션과 함께 커밋합니다 — 빠뜨리면 db-docs-check 워크플로가 PR 에서 막습니다. 테이블·컬럼 설명은 마이그레이션의 COMMENT ON 에서 옵니다.

조직·사용자·권한GitHub이슈

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

인덱스

마스터 데이터GitHub이슈

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

보고서 접수·이미지 연동GitHub이슈

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

인덱스

인덱스

인덱스

문서 분석 (분류·추출·요약)GitHub이슈

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

이 테이블을 참조하는 곳

인덱스

분석 요청·보고서 산출GitHub이슈

인덱스

이 테이블을 참조하는 곳

인덱스

인덱스

이 테이블을 참조하는 곳

인덱스

조직·사용자·권한GitHub

마스터 데이터GitHub

보고서 접수·이미지 연동GitHub

문서 분석 (분류·추출·요약)GitHub

분석 요청·보고서 산출GitHub

업무 데이터 통계GitHub

워크플로우 엔진GitHub

참조 컬렉션GitHub