5인팀_고객계ERD_문수현

테이블 (13)

개인관계자 (party_person)

  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] PK + FK → party.party_id
  • 주민등록번호 (rrn_encrypted) — VARCHAR(255) — AES-256 암호화. 13자리 주민등록번호
  • CI값 (ci_value) — VARCHAR(88) — 본인확인기관 발급 연계정보
  • 내외국인구분코드 (nationality_type_code) — VARCHAR(10) — DOMESTIC/FOREIGN (FK→cust_code_master[NATIONALITY_TYPE])
  • 국적코드 (nationality_code) — CHAR(3) — ISO 3166 국가코드
  • 생년월일 (birth_date) — CHAR(8) — 생년월일. KYC 신원확인 및 미성년자 판별 기준
  • 성별코드 (gender_code) — CHAR(1) — M/F/U (FK→cust_code_master[GENDER])
  • 혼인상태코드 (marital_status_code) — VARCHAR(10) — SINGLE/MARRIED/DIVORCED/WIDOWED (FK→cust_code_master[MARITAL_STATUS])
  • 부양가족수 (dependent_count) — INT — 부양가족 수. 신용평가 및 세제 혜택 산정 기준
  • 직업코드 (occupation_code) — VARCHAR(10) — 외부 표준(통계청 KSCO 한국표준직업분류코드)
  • 직업명 (occupation_name) — VARCHAR(100) — 실제 직업명 자유 텍스트. KSCO 코드의 보완
  • 직장명 (workplace_name) — VARCHAR(200) — 실제 직장명 자유 텍스트. 소득증빙 보완용
  • 연소득금액 (annual_income_amount) — BIGINT — KRW(원) 단위
  • 소득증빙코드 (income_proof_code) — VARCHAR(10) — SALARY/BUSINESS/RENTAL/PENSION/OTHER (FK→cust_code_master[INCOME_PROOF])
  • 제한능력자유형코드 (capacity_limit_type_code) — VARCHAR(20) — NORMAL/MINOR/LIMITED_GUARDIAN/ADULT_GUARDIAN. 민법상 행위능력 제한 유형. NORMAL이 아닌 경우 거래 시 법정대리인 동반 필요 (FK→cust_code_master[CAPAC…
  • PEP해당여부 (is_pep_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 정치적 주요인물 해당 여부. 자연인 본인의 신분
  • PEP유형코드 (pep_type_code) — VARCHAR(10) — [is_pep_yn=TRUE 시 NOT NULL] SELF/FAMILY/CLOSE_ASSOC. (FK→cust_code_master[PEP_TYPE])
  • PEP해당국가코드 (pep_country_code) — CHAR(3) — [is_pep_yn=TRUE 시 NOT NULL] ISO 3166 국가코드. PEP 지위 부여 국가
  • PEP직위 (pep_position) — VARCHAR(200) — [is_pep_yn=TRUE 시 NOT NULL] PEP 직위·역할 자유 텍스트
  • 사망일자 (death_date) — CHAR(8) — 사망 시 관련 역할(party_role) 자동 종료 트리거
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

고객 (customer)

  • 고객ID (customer_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] (FK → party.party_id)
  • 고객등급코드 (customer_grade_code) — VARCHAR(10) — [NOT NULL] NORMAL/VIP/PB (FK→cust_code_master[CUSTOMER_GRADE])
  • 고객상태코드 (customer_status_code) — VARCHAR(20) — NOT NULL — [NOT NULL] ACTIVE/DORMANT/CLOSED (FK→cust_code_master[CUSTOMER_STATUS])
  • 주거래여부 (main_customer_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 주거래 고객 여부. 우대 혜택 적용 기준
  • 신용등급코드 (credit_rating_code) — VARCHAR(10) — AAA/AA/A/BBB/BB/B/CCC/CC/C/D (FK→cust_code_master[CREDIT_RATING])
  • 신용평가일자 (credit_evaluation_date) — CHAR(8) — 신용평가 수행일
  • 신용평가기관코드 (credit_agency_code) — VARCHAR(10) — KCB/NICE/INTERNAL 등 (FK→cust_code_master[CREDIT_AGENCY])
  • 선호언어코드 (preferred_language_code) — CHAR(2) — 외부 표준(ISO 639-1). 외국인 고객 알림·문서 발송 언어
  • SMS수신여부 (sms_receive_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 마케팅·알림 SMS 수신 동의
  • 이메일수신여부 (email_receive_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 마케팅·알림 이메일 수신 동의
  • 우편물수신여부 (postal_receive_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 우편물 수신 동의
  • 알림수단코드 (notification_method_code) — VARCHAR(10) — SMS/EMAIL/KAKAO/APP 등. 주 알림 수단 (FK→cust_code_master[NOTIFICATION_METHOD])
  • 이메일 (email) — VARCHAR(255)
  • 전화번호 (phone) — VARCHAR(20)
  • 우편번호 (zip_code) — VARCHAR(10)
  • 주소 (address) — VARCHAR(255)
  • 상세주소 (address_detail) — VARCHAR(255)
  • 가입채널코드 (join_channel_code) — VARCHAR(20) — BRANCH/ONLINE/MOBILE/CALL/AGENT (FK→cust_code_master[JOIN_CHANNEL])
  • 최초가입일자 (first_join_date) — CHAR(8) — 동일 party의 최초 고객 등록일. 재가입 시에도 변하지 않음
  • 가입일시 (joined_at) — TIMESTAMPTZ(3) — NOT NULL — [NOT NULL, DEFAULT CURRENT_TIMESTAMP(3)] 현재 활성 고객 관계 시작 일시
  • 최종거래일시 (last_transaction_at) — TIMESTAMPTZ(3) — 최근 거래 발생 일시. 휴면 전환 판단 기준
  • 휴면전환일시 (dormant_at) — TIMESTAMPTZ(3) — [customer__status_code=DORMANT 시 NOT NULL] 휴면 상태 전환된 일시
  • 해지일시 (closed_at) — TIMESTAMPTZ(3) — [customer_status_code=CLOSED 시 NOT NULL] 해지 처리 일시
  • 해지사유코드 (close_reason_code) — VARCHAR(20) — [customer_status_code=CLOSED 시 NOT NULL] CUST_REQ/EXPIRY/DEATH/BIZ_CLOSE/NATURAL_END/TRANSFER/REVOKED/OTHER (FK→cust_co…
  • 개인정보유효기간일자 (privacy_expiry_date) — CHAR(8) — 보유기간 만료일. 해지일(closed_at) + 5년 자동 계산. 만료 시 개인정보 파기 또는 분리 보관 처리
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

고객등급이력 (customer_grade_history)

  • 고객등급이력ID (customer_grade_history_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 직전고객등급이력번호 (previous_customer_grade_history_id) — BIGINT — 외래 키 → 고객등급이력.고객등급이력ID — 직전 이력번호 (최초 등록은 NULL) (FK → customer_grade.customer_grade_history_id (자기참조))
  • 고객ID (customer_id) — BIGINT — 외래 키 → 고객.고객ID — NOT NULL — [NOT NULL] FK → customer.customer_id
  • 고객등급코드 (customer_grade_code) — VARCHAR(10) — NOT NULL — [NOT NULL] NORMAL/VIP/PB. 변경 후 등급 (FK→cust_code_master[CUSTOMER_GRADE])
  • 직전고객등급코드 (previous_customer_grade_code) — VARCHAR(10) — 변경 전 등급 (최초 등록은 NULL) (FK→cust_code_master[CUSTOMER_GRADE])
  • 고객등급변경사유코드 (customer_grade_change_reason_code) — VARCHAR(20) — NOT NULL — [NOT NULL] INITIAL/PROMOTION/DEMOTION/MANUAL/PERIODIC (FK→cust_code_master[GRADE_CHANGE_REASON])
  • 고객등급변경상세사유 (customer_grade_change_detail) — VARCHAR(500) — 변경 상세 사유 (자유 텍스트)
  • 고객등급발효일자 (customer_grade_effective_start_date) — CHAR(8) — NOT NULL — [NOT NULL] 이 등급이 적용되기 시작한 일자
  • 고객등급종료일자 (customer_grade_effective_end_date) — CHAR(8) — 이 등급이 종료된 일자. 활성 이력은 NULL
  • 고객등급평가일시 (customer_grade_evaluated_at) — TIMESTAMPTZ(3) — [NOT NULL] 등급 평가가 수행된 시점
  • 시스템자동전환여부 (system_auto_triggered_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 시스템 자동 평가 여부 (정기 평가·기준 충족 자동 승급 등)
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT

고객상태이력 (customer_status_history)

  • 고객상태이력ID (customer_status_history_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 직전고객상태이력번호 (previous_customer_status_history_id) — BIGINT — 외래 키 → 고객상태이력.고객상태이력ID — 직전 이력 ID (최초 등록은 NULL) (FK → customer_status_history.customer_status_history_id (자기참조))
  • 고객ID (customer_id) — BIGINT — 외래 키 → 고객.고객ID — NOT NULL — [NOT NULL] FK → customer.customer_id
  • 고객상태코드 (customer_status_code) — VARCHAR(20) — NOT NULL — [NOT NULL] ACTIVE/DORMANT/CLOSED. 변경 후 상태 (FK→cust_code_master[CUSTOMER_STATUS])
  • 직전고객상태코드 (previous_customer_status_code) — VARCHAR(20) — 변경 전 상태 (최초 등록은 NULL) (FK→cust_code_master[CUSTOMER_STATUS])
  • 고객상태변경사유코드 (customer_status_change_reason_code) — VARCHAR(20) — NOT NULL — [NOT NULL] JOIN/INACTIVITY/CUST_REQ/REACTIVATE/DEATH/BIZ_CLOSE/REGULATORY/OTHER (FK→cust_code_master[STATUS_CHANGE_REAS…
  • 고객상태변경상세사유 (customer_status_change_reason_detail) — VARCHAR(500) — 변경 상세 사유 (자유 텍스트)
  • 고객상태발효일시 (customer_status_effective_start_at) — TIMESTAMPTZ(3) — NOT NULL — [NOT NULL] 이 상태가 발효된 시점
  • 고객상태종료일시 (customer_status_effective_end_at) — TIMESTAMPTZ(3) — 이 상태가 종료된 시점. 활성 이력은 NULL
  • 시스템자동전환여부 (system_auto_triggered_yn) — CHAR(1) — NOT NULL — [NOT NULL, DEFAULT FALSE] 시스템 자동 전환 여부 (휴면·사망 자동 종료 등)
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT

고객코드마스터 (cust_code_master)

  • 코드그룹ID (code_group_id) — VARCHAR(30) — 기본 키 — NOT NULL — [NOT NULL] PK 1/2. 코드 그룹 식별자 (예: END_REASON, ROLE_TYPE)
  • 코드값 (code_value) — VARCHAR(20) — 기본 키 — NOT NULL — [NOT NULL] PK 2/2. 그룹 내 코드값 (예: DEATH, CUST_REQ)
  • 코드명 (code_name) — VARCHAR(100) — NOT NULL — [NOT NULL] 화면 표시용 한글명
  • 코드설명 (description) — VARCHAR(500) — 코드 상세 설명. 업무 정의
  • 정렬순서 (sort_order) — INT — 화면 정렬 순서. 작을수록 상위
  • 유효시작일자 (effective_start_date) — CHAR(8) — NOT NULL — [NOT NULL] 코드 유효 시작일
  • 유효종료일자 (effective_end_date) — CHAR(8) — 폐기 시 입력. 현재 유효 = NULL
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

관계자 (party)

  • 관계자ID (party_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 관계자유형코드 (party_type_code) — VARCHAR(20) — NOT NULL — [NOT NULL] PERSONAL/ORGANIZATION (FK→cust_code_master[PARTY_TYPE])
  • 관계자명 (party_name) — VARCHAR(100) — NOT NULL — [NOT NULL] 관계자명. 개인 실명 또는 법인 정식 한글명
  • 관계자영문명 (party_english_name) — VARCHAR(200) — [권장] 관계자 영문명. SWIFT·국제 거래용. 개인=영문 실명, 법인=등기상 영문명
  • 관계자상태코드 (party_status_code) — VARCHAR(20) — NOT NULL — [NOT NULL] ACTIVE/SUSPENDED/CLOSED (FK→cust_code_master[PARTY_STATUS])
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

관계자_관계 (party_relation)

  • 관계ID (relation_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 시작_관계자ID (from_party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] 관계 시작 주체 (대표자·실소유자·대리인·가족 중 능동적 측). to_party_id와 달라야 함 (FK → party.party_id)
  • 대상_관계자ID (to_party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] 관계 대상 (법인·피대리자·배우자 등 수동적 측) (FK → party.party_id)
  • 관계유형코드 (relation_type_code) — VARCHAR(10) — NOT NULL — [NOT NULL] REP/UBO/LGAR/FAM/AGT (FK→cust_code_master[RELATION_TYPE])
  • 관계세부코드 (relation_detail_code) — VARCHAR(10) — [relation_type_code 값에 따라 그룹 분기. REP→REP_DETAIL, FAM→FAM_DETAIL, UBO→UBO_DETAIL, AGT→AGT_DETAIL] (FK→cust_code_master[*…
  • 지분율 (equity_ratio_bps) — INT — [relation_type_code=UBO 시 NOT NULL] bps 단위, 10000=100%. UBO 기준 25%=2500 bps
  • 대리권범위 (representation_scope) — VARCHAR(200) — [relation_type_code=UBO 시 NOT NULL] 대리권·대표권 행사 범위 자유 텍스트 (예: 보증·계약 권한)
  • 근거서류URL (proof_url) — VARCHAR(500) — 관계 증빙 서류 URL (UBO 지분증명·위임장 등). 파일 스토리지
  • 관계시작일자 (relation_start_date) — CHAR(8) — NOT NULL — [NOT NULL] 관계가 시작된 일자
  • 관계종료일자 (relation_end_date) — CHAR(8) — 관계가 실제 종료된 일자. 진행 중 관계는 NULL
  • 관계종료사유코드 (relation_end_reason_code) — VARCHAR(20) — [relation_end_date IS NOT NULL 시 필수] CUST_REQ/EXPIRY/DEATH/BIZ_CLOSE/NATURAL_END/TRANSFER/REVOKED/OTHER (FK→cust_code_m…
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

관계자_역할 (party_role)

  • 역할ID (role_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] FK → party.party_id
  • 역할유형코드 (role_type_code) — VARCHAR(20) — [NOT NULL] CUST/GRT/UBO/LGAR/EMP/BEN/FAM/PROSP/AGT (FK→cust_code_master[ROLE_TYPE])
  • 역할상태코드 (role_status_code) — VARCHAR(20) — NOT NULL — [NOT NULL] ACTIVE/SUSPENDED/CLOSED (FK→cust_code_master[ROLE_STATUS])
  • 역할시작일자 (role_start_date) — CHAR(8) — NOT NULL — [NOT NULL] 역할이 시작된 일자
  • 역할종료일자 (role_end_date) — CHAR(8) — [role_status_code=CLOSED 시 NOT NULL]
  • 역할종료사유코드 (role_end_reason_code) — VARCHAR(20) — [role_status_code=CLOSED 시 NOT NULL] CUST_REQ/EXPIRY/DEATH/BIZ_CLOSE/NATURAL_END/TRANSFER/REVOKED/OTHER (FK→cust_code_m…
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

기업관계자 (party_organization)

  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] PK + FK → party.party_id
  • 조직세부유형코드 (org_subtype_code) — VARCHAR(20) — [NOT NULL] CORPORATION/NON_CORPORATION. 법인/비법인 구분 (FK→cust_code_master[ORG_SUBTYPE])
  • 법인등록번호 (corp_reg_no) — CHAR(14) — [org_subtype_code=CORPORATION 시 NOT NULL] 법인등기부 등록번호. 법인만 보유. 형식: 13자리 숫자 + 하이픈
  • 법인정식명 (corp_formal_name) — VARCHAR(200) — [org_subtype_code=CORPORATION 시 NOT NULL] 법인등기상 정식 한글명. 표시용 이름은 party.party_name
  • 법인영문정식명 (corp_formal_english_name) — VARCHAR(400) — [org_subtype_code=CORPORATION 시 권장] 법인등기상 정식 영문명. SWIFT·국제 송금용.
  • 본점국가코드 (hq_country_code) — CHAR(3) — ISO 3166 국가코드. 법인 본점 소재 국가. 국내 법인=KOR, 외국 법인=해당 국가 코드
  • 외국법인등록번호 (foreign_corp_reg_no_encrypted) — VARCHAR(255) — [hq_country_code≠KOR 시 NOT NULL] AES-256 암호화. 외국 본점 등록번호.
  • 법인유형코드 (corp_type_code) — VARCHAR(20) — [org_subtype_code=CORPORATION 시 NOT NULL] STOCK/LIMITED/LLC/GENERAL/LIMITED_PT/COOPERATIVE/NPO. (FK→cust_code_master[CO…
  • 비법인유형코드 (non_corp_type_code) — VARCHAR(10) — [org_subtype_code=NON_CORPORATION 시 NOT NULL] RELIGION/VOLUNTARY/AUTONOMY/CLUB. (FK→cust_code_master[NON_CORP_TYPE])
  • 소유형태코드 (ownership_type_code) — VARCHAR(10) — COLLECTIVE/JOINT/COMMON/INDIVIDUAL. 자산·지분 소유 형태 (FK→cust_code_master[OWNERSHIP_TYPE])
  • 대표체제구분코드 (representative_type_code) — VARCHAR(10) — SINGLE/JOINT/COMMITTEE. 대표 체제 구분. 구체적 대표자 정보는 party_relation에서 relation_type=REP로 조회 (FK→cust_code_master[REP_TYPE])
  • 설립일자 (establishment_date) — CHAR(8) — 법인 설립일 또는 단체 결성일
  • 해산일자 (dissolution_date) — CHAR(8) — 해산 시 관련 역할(party_role) 자동 종료 트리거
  • 자본금액 (capital_amount) — BIGINT — [org_subtype_code=CORPORATION 시 NOT NULL] KRW(원) 단위. 법인의 자본금 또는 출자금(협동조합).
  • 결산월 (fiscal_month) — SMALLINT — [org_subtype_code=CORPORATION 시 NOT NULL] 1-12.
  • 설립목적 (establishment_purpose) — VARCHAR(500) — 법인·단체 설립 목적 자유 텍스트
  • 구성원수 (member_count) — INT — [org_subtype_code=NON_CORPORATION 시 NOT NULL] 비법인단체 구성원 수.
  • 정관규약URL (charter_url) — VARCHAR(500) — 정관·규약 문서 파일 스토리지 URL
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

납세거주정보 (tax_residency_info)

  • 납세거주정보ID (tax_residency_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] FK → party.party_id
  • 거주자유형코드 (resident_type_code) — VARCHAR(20) — NOT NULL — [NOT NULL] RESIDENT/NON_RESIDENT (FK→cust_code_master[RESIDENT_TYPE])
  • 납세거주국코드 (tax_country_code) — CHAR(3) — ISO 3166 국가코드. 납세 의무 국가
  • 외국납세자식별번호 (foreign_tin) — VARCHAR(50) — [resident_type_code=NON_RESIDENT 또는 tax_country_code≠KOR 시 NOT NULL] Foreign TIN. 외국 납세자 식별번호 (US SSN/EIN, 일본 마이넘버 등)
  • 원천징수율 (withholding_rate_bps) — INT — [bps 단위, 10000=100%] 원천징수율. 예: 14% = 1400 bps
  • 납세거주확인일자 (tax_residency_confirm_date) — CHAR(8) — [NOT NULL] 납세거주상태확인일
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

사업자정보 (business_info)

  • 사업자정보ID (business_info_id) — BIGINT — 기본 키 — NOT NULL — [NOT NULL] PK
  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] FK → party.party_id
  • 사업자등록번호 (biz_reg_no) — CHAR(12) — NOT NULL — [NOT NULL] 국세청 사업자등록번호. 형식: NNN-NN-NNNNN
  • 사업자상태코드 (biz_status_code) — VARCHAR(20) — NOT NULL — [NOT NULL] CONTINUE/SUSPEND/CLOSE. 계속/휴업/폐업 (FK→cust_code_master[BIZ_STATUS])
  • 상호명 (trade_name) — VARCHAR(200) — NOT NULL — [NOT NULL] 사업자등록상 정식 한글 상호명
  • 영문상호명 (english_trade_name) — VARCHAR(400) — [권장] 사업자등록상 영문 상호명. SWIFT용
  • 개업일자 (opening_date) — CHAR(8) — [NOT NULL] 사업자등록증상 개업일
  • 폐업일자 (closing_date) — CHAR(8) — [biz_status_code=CLOSE 시 NOT NULL] 사업자등록증상 폐업일
  • 국세청업종코드 (nts_industry_code) — CHAR(6) — [NOT NULL] 외부표준(국세청 업종분류 코드)
  • 한국표준산업분류코드 (ksic_code) — CHAR(5) — [NOT NULL] 외부표준(통계청 한국표준산업분류 코드)
  • 업태코드 (biz_type_code) — VARCHAR(10) — [NOT NULL] (외부표준) 업태 분류. 사업자등록증 기준
  • 종목코드 (biz_item_code) — VARCHAR(10) — [NOT NULL] (외부표준) 종목 분류. 사업자등록증 기준
  • 과세유형코드 (tax_type_code) — VARCHAR(10) — [NOT NULL] GENERAL/SIMPLIFIED/EXEMPT. 일반/간이/면세 (FK→cust_code_master[TAX_TYPE])
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

외국인정보 (foreigner_info)

  • 관계자ID (party_id) — BIGINT — 외래 키 → 개인관계자.관계자ID — NOT NULL — [NOT NULL] PK
  • 외국인등록번호 (foreigner_no_encrypted) — VARCHAR(255) — AES-256 암호화. 13자리 외국인등록번호
  • 여권번호 (passport_no) — VARCHAR(20) — 여권 번호. 자유 텍스트 형식. 평문 저장, 화면 마스킹
  • 여권발급국가코드 (passport_country_code) — CHAR(3) — ISO 3166 국가코드
  • 여권만료일자 (passport_expiry_date) — CHAR(8)
  • 체류자격코드 (stay_qualification_code) — VARCHAR(10) — F2/F4/F5/E7/H2 (FK→cust_code_master[STAY_QUALIFICATION])
  • 체류만료일자 (stay_expiry_date) — CHAR(8)
  • 최근입국일자 (recent_entry_date) — CHAR(8)
  • 체류지주소 (stay_address) — VARCHAR(500) — 국내 체류지 주소 (한국 내 거주지)
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT

컴플라이언스정보 (compliance_info)

  • 관계자ID (party_id) — BIGINT — 외래 키 → 관계자.관계자ID — NOT NULL — [NOT NULL] PK
  • AML위험등급코드 (aml_risk_level_code) — VARCHAR(20) — [NOT NULL] LOW/MED/HIGH. FATF 기반 자금세탁 위험등급. 개인·법인·단체 모두 적용 (FK→cust_code_master[AML_RISK])
  • AML최종평가일시 (aml_last_assessed_at) — TIMESTAMPTZ(3) — 최근 AML 등급 평가 시점
  • AML차기평가예정일 (aml_next_review_date) — CHAR(8) — 정기 재평가 예정일
  • 제재대상여부 (is_sanctioned_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE, GENERATED] 제재 등재 여부 요약. is_ofac/un/eu/kr_sanctioned_yn 중 하나라도 TRUE면 TRUE 자동 계산. 현재 추적 대상: OFA…
  • OFAC제재대상여부 (is_ofac_sanctioned_yn) — CHAR(1) — [NOT NULL , DEFAULT FALSE] 미국 OFAC SDN 리스트 등재 여부
  • UN제재대상여부 (is_un_sanctioned_yn) — CHAR(1) — [NOT NULL , DEFAULT FALSE] UN 안전보장이사회 제재 리스트 등재 여부
  • EU제재대상여부 (is_eu_sanctioned_yn) — CHAR(1) — [NOT NULL , DEFAULT FALSE] EU 통합 제재 리스트 등재 여부
  • 한국제재대상여부 (is_kr_sanctioned_yn) — CHAR(1) — [NOT NULL , DEFAULT FALSE] 한국 제재 리스트 등재 여부 (외환거래법 등)
  • 제재최종스크리닝일시 (sanction_last_screened_at) — TIMESTAMPTZ(3) — 마지막 제재 리스트 스크리닝 시점
  • 제재차기스크리닝예정일 (sanction_next_screen_date) — CHAR(8) — 차기 정기 스크리닝 예정일
  • KYC상태코드 (kyc_status_code) — VARCHAR(20) — [NOT NULL] PENDING/COMPLETED/EXPIRED/FAILED. 법인은 KYB 포함 (FK→cust_code_master[KYC_STATUS])
  • KYC완료일시 (kyc_completed_at) — TIMESTAMPTZ(3) — 최초 KYC/KYB 완료 시점
  • KYC만료일 (kyc_expiry_date) — CHAR(8) — KYC 효력 만료일. 위험등급별 주기(고위험 1년·중위험 3년·저위험 5년)
  • KYC차기재인증예정일 (kyc_next_review_date) — CHAR(8) — 정기 재인증 예정일
  • 본인확인수단코드 (identity_verification_method_code) — VARCHAR(10) — NICE/KCB/BANK/CERT/ARS 등. KYC 본인확인 수행 수단 (FK→cust_code_master[ID_VERIFICATION_METHOD])
  • CDD수준코드 (cdd_level_code) — VARCHAR(20) — [NOT NULL] SIMPLE/STANDARD/ENHANCED (FK→cust_code_master[CDD_LEVEL])
  • CDD최종검토일시 (cdd_last_reviewed_at) — TIMESTAMPTZ(3) — 최근 CDD 검토 시점
  • CDD차기검토예정일 (cdd_next_review_date) — CHAR(8) — 정기 재검토 예정일
  • EDD발동여부 (edd_required_yn) — CHAR(1) — [NOT NULL , DEFAULT FALSE] EDD 케이스 존재 여부 요약
  • EDD최종검토일시 (edd_last_reviewed_at) — TIMESTAMPTZ(3) — [edd_required_yn=TRUE 시 NOT NULL] 최근 EDD 검토 시점
  • EDD차기검토예정일 (edd_next_review_date) — CHAR(8) — EDD 차기 재검토 예정일 (일반 CDD보다 짧은 주기)
  • FATCA신고상태코드 (fatca_status_code) — VARCHAR(20) — [NOT NULL] US_PERSON/NON_US/ACTIVE_NFFE/PASSIVE_NFFE/EXEMPT/RECALCITRANT (FK→cust_code_master[FATCA_STATUS])
  • FATCA최종점검일시 (fatca_last_reviewed_at) — TIMESTAMPTZ(3) — 최근 FATCA 분류 점검 시점
  • FATCA자기점검예정일 (fatca_next_review_date) — CHAR(8) — 차기 정기 점검 예정일
  • FATCA보고대상여부 (fatca_reportable_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] IRS 보고 대상 여부
  • CRS신고상태코드 (crs_status_code) — VARCHAR(20) — [NOT NULL] REPORTABLE/NON_REPORTABLE/ACTIVE_NFE/PASSIVE_NFE/EXEMPT (FK→cust_code_master[CRS_STATUS])
  • CRS최종점검일시 (crs_last_reviewed_at) — TIMESTAMPTZ(3) — 최근 CRS 분류 점검 시점
  • CRS자기점검예정일 (crs_next_review_date) — CHAR(8) — 차기 정기 점검 예정일
  • CRS보고대상여부 (crs_reportable_yn) — CHAR(1) — [NOT NULL, DEFAULT FALSE] 자동정보교환 보고 대상 여부
  • 최초등록일시 (created_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최초등록자ID (created_by) — BIGINT
  • 최종수정일시 (updated_at) — TIMESTAMPTZ(3) — NOT NULL
  • 최종수정자ID (updated_by) — BIGINT
  • 삭제일시 (deleted_at) — TIMESTAMPTZ(3)
  • 삭제자ID (deleted_by) — BIGINT