ORGG
Tables (10)
account
- account_id — BIGINT — Primary key — NOT NULL — 계좌 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — NOT NULL — 연결된 사업장
- bank_code — VARCHAR(3) — NOT NULL — 금융기관 식별 코드
- account_no — VARCHAR(16) — NOT NULL — 금융망 계좌번호. 시연 한정 평문 저장이며 운영 전 보호 방식 전환이 필요합니다.
- purpose — VARCHAR(20) — NOT NULL — 계좌 용도: V1은 OPERATING(운영) 또는 BUFFER(버퍼)
- status — VARCHAR(20) — NOT NULL — 계좌 연결 상태
- currency — CHAR(3) — NOT NULL — 계좌 통화 코드(예: KRW)
- creation_idempotency_key — VARCHAR(100) — 계좌 생성 요청 중복 방지 키
- last_transaction_synced_at — TIMESTAMPTZ — 마지막으로 거래 동기화에 성공한 시각. NULL이면 성공 이력이 없습니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
business
- business_id — BIGINT — Primary key — NOT NULL — 연결된 사업장
- name — VARCHAR(100) — NOT NULL — 사업장에 표시할 이름
- address — VARCHAR(255) — 사업장 소재지 주소
- opened_at — DATE — 사업장 개업일
- employee_count — INTEGER — 사업장 종사자 수
- market_area_code — VARCHAR(20) — 매출 예측에 연결할 상권 코드
- business_registration_no — VARCHAR(10) — 사업자등록번호 10자리. 민감정보이므로 로그에 남기지 않습니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
card
- card_id — BIGINT — Primary key — NOT NULL — 카드 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — NOT NULL — 연결된 사업장
- card_fingerprint — BYTEA — NOT NULL — HMAC 기반 카드 식별값. 중복 연결 확인용이며 응답·로그에 노출하지 않습니다.
- last4 — VARCHAR(4) — NOT NULL — 화면 표시용 카드번호 마지막 4자리
- card_issuer_code — VARCHAR(4) — NOT NULL — 카드사 식별 코드
- card_name — VARCHAR(100) — NOT NULL — 화면 표시용 카드 상품명
- status — VARCHAR(10) — NOT NULL — 카드 연결 상태: ACTIVE 또는 INACTIVE
- card_no — VARCHAR(19) — 카드번호 원문. 시연 한정 평문 저장 컬럼이며 민감정보로 취급합니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
card_transaction
- card_transaction_id — BIGINT — Primary key — NOT NULL — 카드 거래 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — NOT NULL — 연결된 사업장
- card_id — BIGINT — Foreign key → card.card_id — NOT NULL — 거래가 발생한 연결 카드
- external_transaction_no — BIGINT — NOT NULL — 금융망 카드 거래 식별 번호. 카드 내 중복 확인에 사용합니다.
- txn_date — DATE — NOT NULL — 카드 사용 일자. 지출은 사용월에 집계합니다.
- txn_time — TIME — NOT NULL — 카드 사용 시각
- amount — BIGINT — NOT NULL — 카드 사용 금액(원, 양수)
- merchant_name — VARCHAR(200) — NOT NULL — 카드 거래처 표시명
- card_status — VARCHAR(20) — NOT NULL — 금융망 원문 카드 거래 상태값
- major_category — VARCHAR(30) — NOT NULL — 서비스가 저장한 거래 대분류
- minor_category — VARCHAR(30) — NOT NULL — 서비스가 저장한 거래 소분류
- classification_source — VARCHAR(30) — NOT NULL — 분류 출처: 자동분류, 사용자 확정, 미분류 등
- classification_confidence — VARCHAR(20) — NOT NULL — 분류 확신도: CERTAIN 또는 UNCERTAIN
- suggested_major_category — VARCHAR(30) — 확신이 낮을 때 제안한 대분류. 두 suggested 값은 함께 저장하거나 함께 비웁니다.
- suggested_minor_category — VARCHAR(30) — 확신이 낮을 때 제안한 소분류. 두 suggested 값은 함께 저장하거나 함께 비웁니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
delivery_settlement
- delivery_settlement_id — BIGINT — Primary key — NOT NULL — 배달 정산 명세서 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — NOT NULL — 연결된 사업장
- settled_date — DATE — NOT NULL — 배달 플랫폼 정산일이며 계좌 입금일과 매칭하는 날짜
- sale_from_date — DATE — NOT NULL — 이 정산에 포함된 매출 기간의 시작일
- sale_to_date — DATE — NOT NULL — 이 정산에 포함된 매출 기간의 종료일
- order_amount — BIGINT — NOT NULL — 주문 총액. 매출로 집계합니다(원).
- brokerage_amount — BIGINT — NOT NULL — 중개 이용료(원)
- payment_fee_amount — BIGINT — NOT NULL — 결제 정산 수수료(원)
- vat_amount — BIGINT — NOT NULL — 공제 항목 부가세(원)
- delivery_amount — BIGINT — NOT NULL — 배달비 공제액(원)
- deduction_amount — BIGINT — NOT NULL — 공제 합계(원). 중개료·결제 수수료·부가세·배달비 합계입니다.
- settlement_amount — BIGINT — NOT NULL — 공제 후 실제 정산 입금액(원). 정산일과 함께 계좌 입금에 매칭합니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
financial_transaction
- financial_transaction_id — BIGINT — Primary key — NOT NULL — 계좌 거래 내부 식별자(PK)
- business_id — BIGINT — Foreign key → account.business_id — NOT NULL — 연결된 사업장
- account_id — BIGINT — Foreign key → account.account_id — NOT NULL — 거래가 발생한 사업자 계좌
- external_transaction_no — BIGINT — NOT NULL — 금융망 거래 식별 번호. 계좌 내 거래 중복 확인에 사용합니다.
- txn_date — DATE — NOT NULL — 거래 일자
- txn_time — TIME(0) — NOT NULL — 거래 시각(시간대 미포함)
- amount — BIGINT — NOT NULL — 거래 금액(원, 양수)
- inflow — BOOLEAN — NOT NULL — 입금이면 true, 출금이면 false
- external_transaction_type — VARCHAR(1) — NOT NULL — 금융망 원문 거래 구분 코드
- external_transaction_type_name — VARCHAR(10) — NOT NULL — 금융망 원문 거래 구분명
- balance_after_amount — BIGINT — NOT NULL — 거래 직후 계좌 잔액(원)
- counterparty — VARCHAR(200) — NOT NULL — 거래 상대방 표시명. transaction_summary → transaction_memo → '미상' 순으로 만듭니다.
- transaction_summary — VARCHAR(255) — 금융망 거래 요약 원문
- transaction_memo — VARCHAR(255) — 금융망 거래 메모 원문
- major_category — VARCHAR(30) — NOT NULL — 서비스가 저장한 거래 대분류
- minor_category — VARCHAR(30) — NOT NULL — 서비스가 저장한 거래 소분류. OTHER_OPEX 아래에서만 세부 분류를 사용합니다.
- classification_source — VARCHAR(30) — NOT NULL — 분류 출처: 자동분류, 사용자 확정, 미분류 등
- classification_confidence — VARCHAR(20) — NOT NULL — 분류 확신도: CERTAIN 또는 UNCERTAIN
- suggested_major_category — VARCHAR(30) — 확신이 낮을 때 제안한 대분류. 두 suggested 값은 함께 저장하거나 함께 비웁니다.
- suggested_minor_category — VARCHAR(30) — 확신이 낮을 때 제안한 소분류. 두 suggested 값은 함께 저장하거나 함께 비웁니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
merchant_rule
- merchant_rule_id — BIGINT — Primary key — NOT NULL — 거래처 분류 규칙 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — 사업장 범위 규칙의 소유 사업장. GLOBAL 규칙이면 NULL입니다.
- rule_scope — VARCHAR(20) — NOT NULL — 규칙 범위: 전체 공통 GLOBAL 또는 사업장별 BUSINESS
- pattern — VARCHAR(200) — NOT NULL — 거래처 자동 분류에 사용할 원문 패턴
- normalized_pattern — VARCHAR(200) — NOT NULL — 공백·표기 등을 정규화한 비교 패턴
- major_category — VARCHAR(30) — NOT NULL — 패턴에 매칭된 거래의 대분류
- minor_category — VARCHAR(30) — NOT NULL — 패턴에 매칭된 거래의 소분류
- hit_count — INTEGER — NOT NULL — 이 규칙이 거래 분류에 적용된 횟수
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
notification_log
- notification_log_id — BIGINT — Primary key — NOT NULL — 알림 이력 내부 식별자(PK)
- business_id — BIGINT — Foreign key → business.business_id — NOT NULL — 연결된 사업장
- type — VARCHAR(40) — NOT NULL — 알림 종류 코드
- title — VARCHAR(100) — NOT NULL — 알림 제목
- body — VARCHAR(500) — NOT NULL — 알림 본문
- sent_on — DATE — NOT NULL — 알림 발송일
- delivered — BOOLEAN — NOT NULL — 알림 전달 성공 여부
- reference_key — VARCHAR(100) — 같은 알림 중복 방지와 대상 참조에 쓰는 키
- target_type — VARCHAR(30) — 알림에서 이동할 대상 종류. 이동 대상이 없으면 NULL입니다.
- target_id — BIGINT — 알림에서 이동할 대상 식별자. 이동 대상이 없으면 NULL입니다.
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
transfer_reservation
- transfer_reservation_id — BIGINT — Primary key — NOT NULL — 예약이체 내부 식별자(PK)
- business_id — BIGINT — Foreign key → account.business_id — NOT NULL — 예약이체를 소유한 사업장
- source_account_id — BIGINT — Foreign key → account.account_id — NOT NULL — 예약이체 출금 계좌
- destination_account_id — BIGINT — Foreign key → account.account_id — NOT NULL — 예약이체 입금 계좌
- external_reservation_id — VARCHAR(20) — NOT NULL — 금융망 예약이체 식별자
- mode — VARCHAR(10) — NOT NULL — 이체 방식: FIXED(정액) 또는 RATIO(비율)
- transfer_ratio_bps — SMALLINT — RATIO 방식의 이체 비율(1bp=0.01%). 순이익 기준입니다.
- configured_fixed_amount — BIGINT — FIXED 방식에 설정한 월 이체액(원)
- last_synced_external_amount — BIGINT — NOT NULL — 금융망에 마지막으로 성공 반영한 이체액(원)
- status — VARCHAR(20) — NOT NULL — 금융망 예약이체의 마지막 확인 상태
- transfer_day — SMALLINT — NOT NULL — 매월 이체 실행일(1~31일)
- last_amount_synced_at — TIMESTAMPTZ — NOT NULL — 이체 금액을 금융망에 마지막으로 동기화한 시각
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각
virtual_account
- virtual_account_id — BIGINT — Primary key — NOT NULL — 가상계좌 연결 내부 식별자(PK)
- account_id — BIGINT — Foreign key → account.account_id — NOT NULL — 가상계좌가 연결된 사업자 계좌
- external_virtual_account_id — VARCHAR(20) — NOT NULL — 금융망이 발급한 가상계좌 식별자
- status — VARCHAR(20) — NOT NULL — 금융망에서 마지막으로 확인한 가상계좌 상태
- expires_on — DATE — NOT NULL — 가상계좌 만료일
- created_at — TIMESTAMPTZ — NOT NULL — 레코드를 처음 생성한 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 레코드를 마지막으로 수정한 시각