docs/db · tbls 생성 · 커밋 19f08289 · 2026-09-16 13:54 KST 빌드

HWSS DB 스키마

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

66테이블

645컬럼

37관계

60마이그레이션

변경 추적

최근 변경

최근 14일 · PR 5건

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

#506	09/16 · 오늘	제목은 로그인 후 표시 external/smartreview-views.md
#505	09/16 · 오늘	제목은 로그인 후 표시 external/smartreview-views.md
#503	09/16 · 오늘	제목은 로그인 후 표시 README.mdpublic.collections.mdpublic.departments.mdpublic.investigations.mdpublic.users.mdschema.jsonviewpoint-0.mdviewpoint-2.md+1
#501	09/16 · 오늘	제목은 로그인 후 표시 external/smartreview-views.md
#500	09/16 · 오늘	제목은 로그인 후 표시 README.mdpublic.agent_document_types.mdpublic.analysis_request_collections.mdpublic.analysis_request_contract_items.mdpublic.analysis_request_contracts.mdpublic.analysis_request_forms.mdpublic.analysis_requests.mdpublic.audit_logs.md+69

조직·사용자·권한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-core오늘 · #503 컬럼 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-core오늘 · #503 컬럼 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-core오늘 · #500 컬럼 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-core오늘 · #500 컬럼 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	화면에 보이는 레벨 이름
`level_order`UQ	integer	NOT NULL	권한 매트릭스 화면의 열 순서 (1=IT 슈퍼관리자 … 5=일반사용자)
`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-core오늘 · #500 컬럼 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-core오늘 · #500 컬럼 11 권한 레벨 × 메뉴 사용 권한 — 메뉴 카탈로그(코드·라벨·콘솔·순서)를 따로 두지 않고 여기에 동봉한다

컬럼	타입		키·허용값·설명
`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	사이드바 표시 순서
`allowed`	boolean	NOT NULL	이 레벨이 이 메뉴를 쓸 수 있는지
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`menu_group_label`	varchar(100)	NULL	사이드바 상위 묶음 라벨
`menu_section_label`	varchar(100)	NULL	사이드바 구역 라벨

인덱스

uq_role_menu_permissions_role_menu (role_code, menu_code)
idx_role_menu_permissions_role (role_code)

제약 정의 전문 (GitHub)

organization-core오늘 · #500 컬럼 4 임시 비밀번호 해시 — 신원은 스마트심사 뷰가 원천이고 비밀번호만 우리가 보관한다. SSO 전환 시 사라질 자리

컬럼	타입		기본값	키·허용값·설명
`employee_no`PK	varchar(50)	NOT NULL		대상 사용자 사번
`password_hash`	varchar(100)	NOT NULL		bcrypt 해시. 평문은 저장하지 않는다
`created_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP

제약 정의 전문 (GitHub)

organization-core오늘 · #500 컬럼 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)

마스터 데이터GitHub

classification-core·code-core. 위탁사와 문서종 분류체계, 폴더 매핑, 공통코드.

erDiagram

"public.common_code_details" }o--|| "public.common_codes" : "common_code_id"
"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.common_codes" {}
"public.common_code_details" {}
"public.customer_companies" {}
"public.document_types" {}
"public.agent_document_types" {}
"public.folder_classification_mappings" {}

classification-core오늘 · #500 컬럼 7 위탁사 마스터 — 이미지 시스템에서 동기화(API-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

인덱스

uq_customer_companies_code (customer_company_code)

이 테이블을 참조하는 곳

document_types

제약 정의 전문 (GitHub)

classification-core오늘 · #500 컬럼 11 위탁사별 이미지시스템 폴더 분류 체계 — 에이전트 분류와 다른 체계다

컬럼	타입		기본값	키·허용값·설명
`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

인덱스

uq_document_types_company_code (customer_company_code, document_type_code)
idx_document_types_company (customer_company_code)

이 테이블을 참조하는 곳

folder_classification_mappings

제약 정의 전문 (GitHub)

classification-core오늘 · #500 컬럼 6 낱장 단위 에이전트 분류 체계 마스터 — 위탁사와 무관한 공통 체계

컬럼	타입		기본값	키·허용값·설명
`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

인덱스

uq_agent_document_types_code (agent_document_type_code)

이 테이블을 참조하는 곳

folder_classification_mappings

제약 정의 전문 (GitHub)

classification-core오늘 · #500 컬럼 7 위탁사별 "폴더 분류 ↔ 에이전트 분류" 매핑 — 미분류 낱장을 어느 폴더에 넣을지 결정하는 기준

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`customer_company_code`UQ	varchar(50)	NOT NULL		→ document_types.customer_company_code · 이 매핑이 적용되는 위탁사
`document_type_code`	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

인덱스

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

제약 정의 전문 (GitHub)

code-core오늘 · #500 컬럼 7 공통코드 그룹 — 코드 체계의 상위 분류

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`code`UQ	varchar(30)	NOT NULL		코드 그룹 식별자
`name`	varchar(100)	NOT NULL		코드 그룹 표시명
`description`	varchar(200)	NULL		코드 그룹 용도 설명
`active`	boolean	NOT NULL	true	사용 여부. 비활성 그룹은 선택 목록에 나오지 않는다
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_common_codes_code (code)

이 테이블을 참조하는 곳

common_code_details

제약 정의 전문 (GitHub)

code-core오늘 · #500 컬럼 8 공통코드 상세 — 그룹에 속한 개별 코드값

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`common_code_id`UQ	bigint	NOT NULL		→ common_codes.id · 속한 코드 그룹
`code_value`UQ	varchar(50)	NOT NULL		코드값. 그룹 안에서 유일하다
`code_name`	varchar(100)	NOT NULL		코드값 표시명
`sort_order`	integer	NOT NULL	0	선택 목록에서의 정렬 순서
`active`	boolean	NOT NULL	true	사용 여부
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_common_code_details_value (common_code_id, code_value)
idx_common_code_details_common_code_id (common_code_id)

제약 정의 전문 (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.investigation_reports" {}
"public.image_transfers" {}
"public.transfer_pages" {}
"public.report_pages" {}

investigation-core오늘 · #503 컬럼 6 조사 건 — 제목·설명·상태 코드를 갖는 최소 형태. 상태 코드는 공통코드(INVESTIGATION_STATUS 그룹)를 가리키지만 도메인 분리로 FK 를 두지 않고 애플리케이션이 검증한다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`title`	varchar(200)	NOT NULL	조사 제목
`description`	varchar(2000)	NULL	조사 내용
`status_code`	varchar(50)	NOT NULL	진행 상태 코드
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

idx_investigations_status_code (status_code)

제약 정의 전문 (GitHub)

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

컬럼	타입		기본값	키·허용값·설명
`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 · 보고서 초안 생성·확정 상태
`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 검증 중에 들어온 확정 요청을 기억해 두는 자리. 검증이 끝나면 이어서 처리한다

인덱스

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)

이 테이블을 참조하는 곳

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

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 18 이미지 시스템에서 받은 전송 묶음 — 접수 이력이다. 현재 문서함은 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

인덱스

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오늘 · #500 컬럼 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-core오늘 · #500 컬럼 16 보고서의 현재 문서함 — 전송들을 반영한 결과의 구체화 뷰. 화면이 보는 것은 이 표다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`report_no`UQ	varchar(100)	NOT NULL	→ investigation_reports.report_no · 이 낱장이 속한 보고서의 접수번호
`source_page_id`UQ	varchar(100)	NOT NULL	이미지 시스템의 불변 낱장 식별자. 접수번호와 함께 이 낱장을 찾는 키다
`page_no`	integer	NOT NULL	문서함에서의 낱장 순서
`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

인덱스

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

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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)

문서 분석 (분류·추출·요약)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_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.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" {}

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

컬럼	타입		기본값	키·허용값·설명
`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 · 결과의 근원 — 실제 에이전트 응답인지 스텁인지

인덱스

uq_classification_results_version (report_no, classification_version)

이 테이블을 참조하는 곳

classification_corrections · classification_result_pages

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 11 낱장별 분류 결과 — 분류 결과 한 벌에 속한 행들

컬럼	타입		키·허용값·설명
`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

인덱스

uq_classification_result_pages_page (classification_result_id, source_page_id)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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-core오늘 · #500 컬럼 7 추출 결과 한 벌 — 분류와 같은 이유로 버전을 둔다

컬럼	타입		기본값	키·허용값·설명
`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 · 결과의 근원 — 실제 에이전트 응답인지 스텁인지

인덱스

uq_extraction_results_version (report_no, extraction_version)

이 테이블을 참조하는 곳

extraction_field_corrections · extraction_result_fields

제약 정의 전문 (GitHub)

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

컬럼	타입		키·허용값·설명
`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

인덱스

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오늘 · #500 컬럼 13 추출값 수정 이력 — 분류 보정 원장과 같은 형태. 항목이 지워지면 이력도 함께 지워진다

컬럼	타입		키·허용값·설명
`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

인덱스

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

제약 정의 전문 (GitHub)

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

컬럼	타입		기본값	키·허용값·설명
`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 · 결과의 근원 — 실제 에이전트 응답인지 스텁인지

인덱스

uq_summary_results_version (report_no, summary_version)

이 테이블을 참조하는 곳

summary_cards

제약 정의 전문 (GitHub)

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

컬럼	타입		키·허용값·설명
`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

인덱스

idx_summary_cards_result_order (summary_result_id, display_order)

이 테이블을 참조하는 곳

summary_items

제약 정의 전문 (GitHub)

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

컬럼	타입		기본값	키·허용값·설명
`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		반영을 체크한 사람의 사번

인덱스

uq_summary_items_key (summary_card_id, item_key)

이 테이블을 참조하는 곳

summary_item_sources

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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. 분석 요청 입력값과 보고서 초안·양식·메일 발송.

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.analysis_requests" {}
"public.analysis_request_forms" {}
"public.analysis_request_contracts" {}
"public.analysis_request_contract_items" {}
"public.analysis_request_collections" {}
"public.report_templates" {}
"public.report_template_variables" {}

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

컬럼	타입		키·허용값·설명
`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

인덱스

uq_analysis_requests_version (report_no, request_version)

이 테이블을 참조하는 곳

analysis_request_collections · analysis_request_contracts · analysis_request_forms

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 6 요청이 고른 보고서 양식 — 복수 선택할 수 있고 하위 항목 활성화에 영향을 준다

컬럼	타입		키·허용값·설명
`id`PK	bigint	NOT NULL
`analysis_request_id`UQ	bigint	NOT NULL	→ analysis_requests.id · 이 선택이 속한 분석 요청
`report_form_code`UQ	varchar(100)	NOT NULL	보고서 양식 코드 (report_templates.template_code)
`display_order`	integer	NOT NULL	표시 순서
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL

인덱스

uq_analysis_request_forms (analysis_request_id, report_form_code)

제약 정의 전문 (GitHub)

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

컬럼	타입		키·허용값·설명
`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

인덱스

uq_analysis_request_contracts (analysis_request_id, sequence_no)

이 테이블을 참조하는 곳

analysis_request_contract_items

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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		초안 본문 전체
`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)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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오늘 · #500 컬럼 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-core오늘 · #500 컬럼 12 보고서 메일 발송 기록 — 무엇을 누구에게 언제 보냈는지

컬럼	타입		키·허용값·설명
`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

인덱스

idx_report_mail_dispatches_report (report_no, dispatched_at)

제약 정의 전문 (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_facts" {}
"public.report_stat_fact_details" {}

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

컬럼	타입		키·허용값·설명
`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

인덱스

uq_dim_hospitals_key (hospital_key)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 6 표기 차이 흡수용 별칭 사전 — 원문 표기 하나가 차원 키 하나로. 세 차원이 같은 형태라 한 표에 둔다

컬럼	타입		키·허용값·설명
`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

인덱스

uq_stat_dim_aliases (dimension, alias)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 16 업무 데이터 통계의 보고서당 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

인덱스

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

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 10 보고서 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

인덱스

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-core오늘 · #500 컬럼 21 시스템 통계의 보고서당 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

인덱스

uq_report_lifecycle_facts_report (report_no)
idx_report_lifecycle_facts_requested_company (requested_at, customer_company_code)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 16 일별 롤업 — 시스템 통계의 화면 조회용 집계층. 합계와 모수를 함께 두어 평균을 조회 시점에 나눈다

컬럼	타입		키·허용값·설명
`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

인덱스

uq_stat_daily_lifecycle (stat_date, customer_company_code, department_code)

제약 정의 전문 (GitHub)

investigation-core오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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오늘 · #500 컬럼 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 참조 컬렉션과 파일의 메타데이터. 지식컬렉션 본체는 업스테이지가 보유한다.

erDiagram

"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.collections" {}
"public.collection_files" {}
"public.collection_approval_requests" {}

collection-core오늘 · #503 컬럼 10 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		컬렉션 이름
`description`	varchar(500)	NULL		등록자가 남기는 용도·출처·주의사항
`created_at`	timestamptz	NOT NULL
`updated_at`	timestamptz	NOT NULL
`vector_collection_id`	varchar(200)	NULL		외부 AI 플랫폼이 발급한 벡터 컬렉션 식별자. 플랫폼 어댑터가 없는 조합에서는 비어 있다

인덱스

idx_collections_owner (owner_employee_no)
idx_collections_type_status (collection_type, status)

이 테이블을 참조하는 곳

collection_approval_requests · collection_files

제약 정의 전문 (GitHub)

collection-core오늘 · #500 컬럼 14 컬렉션에 등록된 파일과 그 인덱싱 상태

컬럼	타입		기본값	키·허용값·설명
`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

인덱스

idx_collection_files_collection (collection_id)
idx_collection_files_sha256 (sha256)

이 테이블을 참조하는 곳

collection_approval_requests

제약 정의 전문 (GitHub)

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

컬럼	타입		기본값	키·허용값·설명
`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

인덱스

idx_collection_approval_requests_status (status)
idx_collection_approval_requests_collection (collection_id)

제약 정의 전문 (GitHub)

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

mail-core·audit-core. 발송 계정 암호와 그 변경 이력, 감사 로그.

mail-core오늘 · #500 컬럼 4 SMTP 대표 계정 비밀번호(AES-256-GCM 암호문) — 단일 행

컬럼	타입		기본값	키·허용값·설명
`id`PK	bigint	NOT NULL
`password_cipher`	text	NOT NULL		AES-256-GCM 암호문. 평문은 어디에도 남기지 않는다
`created_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP
`updated_at`	timestamp	NOT NULL	CURRENT_TIMESTAMP

제약 정의 전문 (GitHub)

mail-core오늘 · #500 컬럼 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오늘 · #500 컬럼 12 감사 원장 — 관리자 "전체 로그" 화면의 저장소. 이벤트별 전용 컬럼 없이 행위자·대상·결과만 담는 범용 형태

컬럼	타입		키·허용값·설명
`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

인덱스

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)

제약 정의 전문 (GitHub)

스마트심사 제공 뷰

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

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

질병코드와 병명의 마스터. 2026-09-16 실측에서 처음 나타났고 같은 날 스마트심사 확인으로 용도가 정해졌다 — 뷰 정의서(v1.5)에는 아직 실려 있지 않다. 통계 차원 dim_diseases(코드 + 표준 병명)를 채울 원천이 될 수 있다. 코드 체계(KCD 차수 등)와 갱신 주기는 아직 확인되지 않았다.

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

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

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

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

53,533행 컬럼 2 파기정보 (대내)

LAST_PRCS_DATE + 90일 경과 시 파기(기간 계산형).

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

27,751행 컬럼 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

0행 컬럼 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	표시 순서

93행 컬럼 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,912행 컬럼 9 사용자

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

컬럼	타입		설명
`EMPL_NO`	VARCHAR2(8)	NOT NULL	사번 (세션 기준키)
`NAME`	VARCHAR2(50)	NULL	성명 개인정보
`CONN_PSYN`	VARCHAR2(1)	NULL	접속가능여부. 로그인 판별에는 아직 반영하지 않았다 — 정책 결정 필요
`DUTY_CODE`	VARCHAR2(10)	NULL	직책 코드 (공통코드 뷰로 해석)
`RNKS_CODE`	VARCHAR2(10)	NULL	직급 코드 (공통코드 뷰로 해석)
`WORK_PSTN_OGCD`	VARCHAR2(20)	NULL	근무 조직 코드 (세션 departmentCode)
`ORIG_PSTN_OGCD`	VARCHAR2(20)	NULL	원소속 조직 코드
`WORK_PSTN_CECD`	VARCHAR2(20)	NULL	근무소속센터코드
`ENTR_DATE`	VARCHAR2(8)	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

워크플로우 엔진GitHub

참조 컬렉션GitHub

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

스마트심사 제공 뷰