A305

테이블 (21)

P1-1(2) 소셜 로그인 (social_auth)

  • 소셜 로그인 번호 (social_seq) — int — 기본 키 — NOT NULL — PK
  • 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 사용자를 식별하기 위한 식별자
  • 소셜 로그인 제공자 (provider) — varchar — KAKAO, NAVER, GOOGLE 등
  • 소셜 고유 ID (provider_user_id) — varchar — 해당 업체에서 주는 고유 ID
  • 연결 일자 (connected_dttm) — datetime

P1-1. 사용자 (users)

  • 사용자 번호 (user_seq) — int — 기본 키 — NOT NULL — PK, 사용자를 식별하기 위한 ID
  • 이메일 (email) — varchar — 이메일
  • 전화번호 (phone) — varchar — 전화번호
  • 싸피 유저 키 (ssafy_user_key) — varchar — SSAFY 금융망 안에서 계좌/거래의 주인이 누구인지를 추적
  • 사용자 상태 (state) — varchar — (PENDING / ACTIVE / DELETED / BLOCKED) 약관동의 안함, 활성, 탈퇴, 밴
  • 생성 일자 (created_dttm) — datetime — 회원 가입 일자
  • 수정 일자 (updated_dttm) — datetime — 회원 수정 일자
  • 탈퇴 일자 (deleted_dttm) — datetime — 회원 탈퇴 일자

P1-10. 전자서명 (signature)

  • 서명 번호 (signature_seq) — int — 기본 키 — NOT NULL — PK, 서명 고유 식별자
  • 인증키식별자 (key_seq) — int — 외래 키 → 기기 공개키 저장소.인증키식별자 — NOT NULL — PK
  • 문서 번호 (document_seq) — int — 외래 키 → P1-9. IText 7로 생성된 문서 관리.문서 번호 — NOT NULL — FK, 서명 대상 문서
  • 서명한 유저 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 서명한 사용자
  • 서명 역할 (role) — enum — (CREDITOR / DEBTOR)
  • 서명 수단 (method) — varchar — (BIOMETRIC=생체인증 / PATTERN=패턴 / DEVICE_ID=기기ID)
  • 기기 식별자 해시값 (device_id_hash) — varchar
  • 생체인증 통과 여부 (biometric_verified) — boolean
  • 서명 시 IP 주소 (ip_address) — varchar
  • 서명 시 기기/앱 정보 (user_agent) — varchar
  • 서명 원본 데이터 (signature_payload) — json
  • 서명 완료 일시 (signed_dttm) — datetime
  • 서명 데이터 (signature_value) — text — 기기 내의 개인키로 암호화된 Base64

P1-11. 상환 계획 (repayment_schedule)

  • 상환 회차 번호 (schedule_seq) — int — 기본 키 — NOT NULL — PK, 회차 고유 식별자
  • 소속 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 계약 고유 식별자
  • 몇 번째 상환 회차인지 (installment_no) — int
  • 상환 예정일 (due_dt) — date — D-7/D-3/D-1, 상환 마감일, 당일 자정 기준
  • 해당 회차 납부 원금 (principal_due) — decimal(15, 2)
  • 해당 회차 납부 이자 (interest_due) — decimal(15, 2)
  • 해당 회차 총 납부액 (total_due) — decimal(15, 2)
  • 상환 후 남은 잔액 (remaining_balance_after) — decimal(15, 2) — 타임라인 표시용
  • 회차 상태 (status) — varchar — (NONPAID=미납 / PAID=납부완료 / MANUAL_PAID=상환처리 / OVERDUE=연체)
  • 실제 납부 완료 일시 (paid_dttm) — datetime
  • 회차 생성 일시 (created_dttm) — datetime

P1-12. 실제 상환 행위 (repayment_event)

  • 이벤트 번호 (event_seq) — bigint — 기본 키 — NOT NULL — PK, 이벤트 고유 식별자
  • 상환 회차 번호 (schedule_seq) — int — 외래 키 → P1-11. 상환 계획.상환 회차 번호 — NOT NULL — FK, 연결된 상환 회차
  • 소속 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 소속 계약
  • 증빙 등급 (evidence_grade) — varchar — (BRONZE=현금 / SILVER=수동이체 / GOLD=자동이체 / WAIVER=면제)
  • 실제 납부 금액 (amount_paid) — decimal(15,2)
  • 상환 신고한 사용자 번호 (reported_by_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 주로 채무자
  • 상환 확인한 사용자 번호 (confirmed_by_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 주로 채권자
  • 처리 상태 (status) — varchar — (처리 상태: REQUESTED=요청됨 / CONFIRMED=채권자확인완료 / REJECTED=거절 / AUTO_CONFIRMED=자동이체감지로자동확정 / FAILED)
  • 비고 (note) — varchar — "이체 증빙 없음" 등 화면 표시 문구
  • 상환 신고 일시 (requested_dttm) — datetime — 상환 신고 일시
  • 채권자 확인 일시 (confirmed_dttm) — datetime — 미확인이면 NULL
  • 거래 번호 (tx_seq) — bigint — 외래 키 → P1-13. 거래내역 원본.거래 번호 — FK, 거래 고유 식별자
  • 자동이체 아닌 경우 증빙 자료 (Field)

P1-13. 거래내역 원본 (bank_transaction)

  • 거래 번호 (tx_seq) — bigint — 기본 키 — NOT NULL — PK, 거래 고유 식별자
  • API 제공사 (provider) — varchar — API 제공사: SSAFY_FIN_API
  • 조회된 계좌 번호 (account_seq) — int — 외래 키 → P1-4. 계좌 정보.계좌 식별자 — NOT NULL — FK
  • 거래 발생 일시 (tx_dttm) — datetime — 거래 데이터는 금융 거래 시각이 중요하므로 datetime 채택
  • 거래 금액 (amount) — decimal(15,2)
  • 거래 방향 (direction) — enum — (IN=입금 / OUT=출금)
  • 거래 상대방 이름 (counterparty_name) — varchar
  • 이체 메모 (memo) — varchar — P2 메모 자동 감지에 활용
  • API 원본 응답 전체 (raw_payload) — json — 재처리/감사 대비 보존
  • 고유 해시 (hash) — varchar — 거래 중복 수집 방지용
  • 매칭된 상환 회차 번호 (matched_schedule_seq) — int — 외래 키 → P1-11. 상환 계획.상환 회차 번호 — FK, 미매칭이면 null
  • 매칭 신뢰도 (match_confidence) — decimal(5,4) — 0~1, 낮으면 수동 검토 필요
  • 매칭 상태 (match_status) — varchar — (UNMATCHED=미매칭 / MATCHED=매칭완료 / IGNORED=무시 / PENDING_REVIEW=신뢰도낮아수동검토필요)

P1-14. 앱 푸시 알림을 위한 FCM 토큰 저장 (fcm_token)

  • 토큰 번호 (token_seq) — bigint — 기본 키 — NOT NULL — PK, FCM 토큰을 식별하기 위한 ID
  • 토큰 소유 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 토큰 소유 사용자
  • FCM token (token) — varchar — 앱 내부의 Firebase SDK가 FCM 서버로부터 받은 고유한 토큰
  • 토큰 활성 여부 (is_active) — boolean — 무효화 시 false
  • 마지막 사용 일시 (last_used_dttm) — datetime — 90일 미사용 토큰 정리용
  • 토큰 등록 일시 (created_dttm) — datetime
  • 토큰 무효화 일시 (invalidated_dttm) — datetime — null이면 유효

P1-15. 푸시 알림 발송 이력 (notification_log)

  • 알림 번호 (notification_seq) — bigint — 기본 키 — NOT NULL — PK, 알림 고유 식별자
  • 알림 수신 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK
  • 알림 유형 키 (event_key) — varchar — (REPAYMENT_D7/D3/D1=상환예정알림 / SIGN_COMPLETE=서명완료 / CONTRACT_SHARED=계약공유 / CONTRACT_MODIFIED=수정요청 / CONTRACT_AGREED=합의완료…
  • 연관 상환 회차 번호 (schedule_seq) — int — 외래 키 → P1-11. 상환 계획.상환 회차 번호 — NOT NULL — FK
  • 푸시 알림 제목 (title) — varchar
  • 푸시 알림 본문 (message) — text
  • 사용자 읽음 여부 (is_read) — boolean
  • 발송 결과 (status) — varchar — (SENT=성공 / FAILED=실패)
  • FCM 서버 응답 메세지 ID (fcm_message_id) — varchar — 발송 추적용
  • 발송 일지 (sent_dttm) — datetime
  • 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 계약 고유 식별자

P1-2(3). 통합 약관 관리 (terms_master)

  • 약관 번호 (terms_seq) — int — 기본 키 — NOT NULL
  • 약관 식별 키 (terms_key) — varchar — NOT NULL — (SERVICE, PRIVACY, FIN_API, MARKETING)
  • 필수/선택 약관 여부 (terms_type) — enum — NOT NULL — (mandatory/optional)
  • 약관 내용 (terms_content) — text — NOT NULL
  • 약관 버전 (terms_version) — varchar — NOT NULL — ex) 1.0.0
  • 약관 생성일자 (created_dttm) — datetime — NOT NULL

P1-2. 사용자 프로필 (user_profile)

  • 사용자 프로필 번호 (user_profile_seq) — int — 기본 키 — NOT NULL — PK
  • 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 사용자를 식별하기 위한 ID
  • 주민등록번호 앞자리 (rrn) — varchar — NOT NULL
  • 실명 (real_name) — varchar — 실명, 프로필 등록 완료 전엔 NULL
  • 휴대폰 인증 (phone_verified) — boolean — 휴대폰 인증 여부
  • 프로필 등록 완료 일자 (profile_completed_dt) — date — 프로필 등록 완료 일자, NULL이면 미완성
  • 앱 잠금 활성화 여부 (lock_enabled) — boolean — 앱 잠금 활성화 여부
  • 잠금 방식 (lock_type) — varchar — (BIOMETRIC / PATTERN / NONE)
  • 패턴 잠금 해시값 (pattern_hash) — varchar — 패턴 잠금 해시값, BIOMETRIC이면 NULL
  • 제때 상환 횟수 (on_time_count) — int — (신뢰 배지 산정 기준) DEFAULT 0
  • 연체 횟수 (overdue_count) — int
  • 연체 후 해결 횟수 (resolved_count) — int
  • 평균 지연 일수 (avg_delay_days) — decimal(5,2)
  • 신뢰 배지 등급 (badge_level) — varchar — (BRONZE / SILVER / GOLD / PLATINUM)
  • 배지 공개 여부 (badge_is_public) — boolean — 상대방에게만 공개
  • 수정 일자 (updated_dttm) — datetime — 최종 수정 일자(시간)

P1-3. 사용자 약관 동의 (user_consent)

  • 사용자 약관 동의 번호 (consent_seq) — int — 기본 키 — NOT NULL — PK
  • 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 사용자를 식별하기 위한 식별자
  • 약관 동의 번호 (terms_seq) — int — 외래 키 → P1-2(3). 통합 약관 관리.약관 번호 — NOT NULL — FK, 동의한 약관 원본 식별자
  • 동의 여부 (is_agreed) — boolean — NOT NULL
  • 동의 시각 (agreed_dttm) — datetime — NOT NULL — 동의/철회 시각

P1-4. 계좌 정보 (bank_account)

  • 계좌 식별자 (account_seq) — int — 기본 키 — NOT NULL — PK, 계좌 고유 식별자
  • 유저 식별자 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — FK, 사용자를 식별하기 위한 ID, 연결된 유저 없을 시 NULL
  • 금융 API 제공사 (provider) — varchar
  • 금융상품 고유번호 (account_type_unique_no) — varchar — NOT NULL — SSAFY 금융상품 고유번호. 계좌 생성 시 요청에 사용 (예: 001-1-ffa4253081d540)
  • 계좌 번호 (account_no) — varchar — SSAFY가 발급한 실제 계좌번호 16자리
  • 마스킹 처리된 계좌번호 (account_no_masked) — varchar — UI 표시용
  • 대표 계좌 여부 (is_primary) — boolean
  • 계좌 연동 일시 (linked_dttm) — datetime — 계좌 연결 시점은 이벤트성 액션이라 시각 단위가 의미가 있음
  • 계좌 해지 일시 (closed_dttm) — datetime — 계좌 해지 일시. 해지 전엔 NULL
  • 계좌 상태 (status) — enum — NOT NULL — (PENDING_VERIFICATION, ACTIVE, CLOSED, SUSPENDED) 계좌 생성됐지만 1원 인증 대기중 / 1원 인증 완료, 정상 사용 가능 / 계좌 해지 / 계좌 정지

P1-5. 계약 (contract)

  • 계약 번호 (contract_seq) — int — 기본 키 — NOT NULL — PK, 계약 고유 식별자
  • 계약 고유번호 (contract_id) — varchar — NOT NULL — pdf 및 해시에 삽입되는 코드
  • 선택한 템플릿 (is_family) — boolean — 가족 여부를 구분하는 boolean값
  • 채권자 번호 (creditor_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 채권자를 식별하기 위한 ID
  • 채무자 번호 (debtor_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 채무자를 식별하기 위한 ID
  • 원금 (principal_amount) — decimal(15,2)
  • 연 이자율 (interest_rate) — decimal(5,4) — 0.046 = 4.6% / 4.6% 미만 시 세무 경고 대상
  • 상환 방식 (repayment_method) — varchar — (LUMP_SUM =일시상환/ MONTHLY =1달마다/ QUARTERLY=3개월마다 / SEMI_ANNUAL=6개월마다 / ANNUAL=1년마다)
  • 총 상환 회차 (total_installments) — int — 일시상환이면 NULL
  • 대출 시작일 (start_dt) — date — 대출 시작일, 시각 무의미
  • 만기일 (end_dt) — date — 대출 종료일, 시각 무의미
  • 계약 상태 (status) — varchar — (DRAFT /NEGOTIATING/ SIGNED / OVERDUE / CLOSED ) 계약의 생명주기 추가될 가능성 높음
  • AI생성 차용증 초안 (ai_draft_content) — json — LLM이 생성한 차용증 초안, 스텝폼 완료 즉시 저장
  • 계약 생성 일시 (created_dttm) — datetime
  • 최종 수정 일시 (updated_dttm) — datetime
  • 상호 서명 완료 일시 (signed_dttm) — datetime

P1-6. 계약서 조항 (contract_clause)

  • 조항 번호 (clause_seq) — int — 기본 키 — NOT NULL — PK, 조항 고유 식별자
  • 소속 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK
  • 조항 식별 ID (clause_id) — varchar — (INTEREST / REPAYMENT_DATE / PENALTY)
  • 조항 제목 (title) — varchar
  • 현재 합의된 조항 (content) — text
  • 조항 표시 순서 (order_no) — int
  • 조항 생성 일시 (created_dttm) — datetime
  • 조항 최종 수정 일시 (updated_dttm) — datetime

P1-7. 조항별 수정 요청/협의 이력 (clause_negotiation)

  • 협의요청 번호 (negotiation_seq) — int — 기본 키 — NOT NULL — PK
  • 조항 번호 (clause_seq) — int — 외래 키 → P1-6. 계약서 조항.조항 번호 — NOT NULL — FK, 협의 대상 조항
  • 수정 요청한 사용자 번호 (requested_by_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 주로 채무자
  • 제안하는 수정 내용 (proposed_content) — text
  • 수정 요청 사유 (comment) — text
  • 협의 상태 (status) — varchar — (IN_PROGRESS=협의중(노랑) / AGREED=합의(초록) / REJECTED=거부(빨강))
  • 협의 요청 일시 (created_dttm) — datetime
  • 협의 완료 일시 (resolved_dttm) — datetime

P1-8. 자동이체 설정 정보 (auto_transfer_registration)

  • 등록 번호 (registration_seq) — int — 기본 키 — NOT NULL — PK, 등록 고유 식별자
  • 소속 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 소속계약
  • 출금 계좌 번호 (debtor_account_seq) — int — 외래 키 → P1-4. 계좌 정보.계좌 식별자 — NOT NULL — FK, 채무자 계좌
  • 입금 계좌 번호 (creditor_account_seq) — int — 외래 키 → P1-4. 계좌 정보.계좌 식별자 — NOT NULL — FK, 채권자 계좌
  • 매 회 이체 금액 (amount) — decimal(15,2)
  • 매월 이체일 (transfer_day) — int — 1~31
  • 자동이체 활성 여부 (is_active) — boolean
  • 등록 일시 (registered_dttm) — datetime
  • 해지 일시 (canceled_dttm) — datetime

P1-9. IText 7로 생성된 문서 관리 (document)

  • 문서 번호 (document_seq) — int — 기본 키 — NOT NULL — PK. 문서 고유 식별자
  • 소속 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 계약 고유 식별자
  • 문서 유형 (doc_type) — varchar — (CONTRACT_ORIGINAL=서명완료차용증 / WAIVER_AGREEMENT=면제합의서 / EARLY_SETTLEMENT=중도상환합의서(P3) / TAX_PACKAGE=세무패키지(P3)) 추가 가능성 있음
  • 문서 버전 (version) — int — 문서 버전, 재생성 시 증가하여 이전 버전 보존
  • 파일 경로 (file_url) — varchar — 스토리지 저장 경로, 앱 푸시 사본 링크에 사용
  • 문서 해시값 (sha256_hash) — varchar — 문서 SHA-256해시값, 차후 변조 검증용
  • 생성 주체 (generated_by) — varchar — ( SYSTEM=자동생성 / USER=수동요청)
  • 생성 일자 (generated_dttm) — datetime — 문서 생성 일시
  • 원본 (doc_content_json) — json — NOT NULL — 원본 문서

P2-1. 이자 소득세 계산 내역 (tax_calculation)

  • 세금 계산 번호 (tax_seq) — int — 기본 키 — NOT NULL — PK
  • 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 세금 계산 대상이 되는 계약 식별자
  • 이벤트 번호 (event_seq) — bigint — 외래 키 → P1-12. 실제 상환 행위.이벤트 번호 — NOT NULL — FK, 어떤 상환 이벤트에 대한 세금인지
  • 계산된 이자소득 (interest_income) — decimal(15,2)
  • 원천징수세액 (withholding_tax) — decimal(15,2) — 27.5%
  • 계약 기준 누적 원천징수세액 (cumulative_tax) — decimal(15,2)
  • 계산 일시 (calculated_ymd) — varchar

P3-1. 소액 약속 알림 (promise_reminder)

  • 약속 알림 번호 (reminder_seq) — int — 기본 키 — NOT NULL — PK
  • 생성자 번호 (creator_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 약속 알림을 등록한 사용자 식별자
  • 대상자 번호 (target_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 약속 알림의 대상이 되는 사용자 식별자
  • 약속 내용 (content) — text — 약속 또는 금전 거래에 대한 설명 내용
  • 금액 (amount) — decimal(15,2) — 약속된 금액 또는 상환 예정 금액
  • 약속 기한 (due_dttm) — datetime — 약속이 이행되기로 한 기준 시점
  • 알림 예정 시각 (remind_dttm) — datetime — 사용자에게 알림을 발송할 예정 시각
  • 완료 여부 (is_completed) — boolean
  • 생성 일시 (created_dttm) — datetime — 약속 알림이 등록된 시각

P3-2. 중도 상환 합의 (early_settlement)

  • 중도상환합의 번호 (settlement_seq) — int — 기본 키 — NOT NULL — PK
  • 계약 번호 (contract_seq) — int — 외래 키 → P1-5. 계약.계약 번호 — NOT NULL — FK, 중도상환 합의가 연결된 원본 차용 계약 식별자
  • 중도상환 요청자 번호 (requested_by_user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — FK, 중도 상환을 요청한 사용자 식별자
  • 잔여 원금 (remaining_principal) — decimal(15,2) — 중도 상환 시점에서 아직 상환되지 않은 원금
  • 잔여 이자 (remaining_interest) — decimal(15,2) — 중도 상환 시점에서 아직 정산되지 않은 이자
  • 최종 정산 금액 (settlement_amount) — decimal(15,2) — 잔여 원금과 잔여 이자를 바탕으로 당사자 간 최종 합의된 중도상환 금액
  • 합의 상태 (status) — varchar — (REQUESTED: 요청됨 / AGREED: 합의 완료 / REJECTED: 거절)
  • 문서 번호 (document_seq) — int — 외래 키 → P1-9. IText 7로 생성된 문서 관리.문서 번호 — NOT NULL — FK. 합의 문서 고유 식별자
  • 요청 일시 (created_dttm) — datetime — 중도 상환이 처음 요청된 시각
  • 처리 완료 일시 (resolved_dttm) — datetime — 중도상환 요청이 합의 또는 거절로 최종 처리된 시각

기기 공개키 저장소 (user_device_key)

  • 인증키식별자 (key_seq) — int — 기본 키 — NOT NULL — PK
  • 사용자 번호 (user_seq) — int — 외래 키 → P1-1. 사용자.사용자 번호 — NOT NULL — PK, 사용자를 식별하기 위한 ID
  • 기기 고유 해시값 (device_id_hash) — varchar(255) — NOT NULL — 클라이언트가 서명 시 보내는 기기 고유 식별값과 대조용
  • 기기공개키_PEM (public_key_pem) — text — NOT NULL — 기기(TEE/StrongBox)에서 생성되어 전송된 공개키 원본(PEM/Base64 텍스트)
  • 활성화여부 (is_active) — boolean — NOT NULL — 새 기기에 로그인하면 이전 기기의 키는 False로 비활성화. (삭제는 안 함)
  • 등록 일시 (registered_dttm) — datetime — NOT NULL
  • 폐기 일시 (revoked_dttm) — datetime — 기기 교체나 분실 신고로 인해 키가 만료된 시각 (현재 활성 키면 NULL)