sw아키텍처-전자결재erd

테이블 (16)

감사 로그 (audit_logs)

  • id (감사 로그 ID) — BIGINT — 기본 키 — NOT NULL
  • action (행위 종류) — VARCHAR(50)
  • detail (상세 변경 내용) — TEXT
  • created_at (기록 일시) — TIMESTAMP
  • user_id (행위자) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • document_id (연관된 문서) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

개인 커스텀 폴더 (custom_folders)

  • id (커스텀 폴더 고유 ID) — BIGINT — 기본 키 — NOT NULL
  • user_id (폴더 소유자 (사용자)) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • name (폴더명) — VARCHAR(100)
  • created_at (생성 일시) — TIMESTAMP

결재 문서 (approval_documents)

  • id (결재 문서 ID) — BIGINT — 기본 키 — NOT NULL
  • writer_id (기안자) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • form_id (사용된 결재 양식) — BIGINT — 외래 키 → 결재 양식.id — NOT NULL
  • document_no (문서 번호) — VARCHAR(50)
  • title (문서 제목) — VARCHAR(200)
  • document_data (양식 필드에 기안자가 실제 입력한 데이터 (Key-Value 구조). 추후 데이터 집계, 검색 및 외부 시스템 연동용) — JSON
  • content (기안 완료 시 빈 서식(template_html)과 입력 데이터(document_data)가 병합된 최종 스냅샷 HTML. (보안: XSS 필터링/Sanitization 적용 후 저장 필수)) — TEXT
  • status (DRAFT / IN_PROGRESS / APPROVED / REJECTED / WITHDRAWN) — VARCHAR(30)
  • risk_level (NORMAL / HIGH) — VARCHAR(20)
  • current_step (현재 결재 단계) — INT
  • version (문서 버전) — INT
  • submitted_at (상신 일시) — TIMESTAMP
  • completed_at (최종 완료(승인/반려) 일시) — TIMESTAMP
  • created_at (데이터 생성 일시) — TIMESTAMP
  • updated_at (데이터 수정 일시) — TIMESTAMP

결재 양식 (approval_forms)

  • id (결재 양식 ID) — BIGINT — 기본 키 — NOT NULL
  • name (양식명) — VARCHAR(100)
  • description (양식 설명) — TEXT
  • form_schema (양식 내 입력 필드(Input)의 속성 및 구조를 정의한 데이터) — JSON
  • template_html (웹 에디터에 렌더링할 빈 문서 레이아웃 HTML 서식 (표, 폰트 스타일, 회사 로고 등 디자인 영역)) — TEXT
  • risk_default (NORMAL / HIGH) — VARCHAR(20)
  • is_active (사용 여부) — BOOLEAN
  • created_at (생성 일시) — TIMESTAMP
  • updated_at (수정 일시) — TIMESTAMP
  • department_id (양식 소유 부서) — BIGINT — 외래 키 → 부서.id — NOT NULL
  • created_by (생성한 부서 관리자) — BIGINT — 외래 키 → 사용자.id — NOT NULL

결재선 (approval_lines)

  • id (결재선 ID) — BIGINT — 기본 키 — NOT NULL
  • step_order (결재 순서) — INT
  • line_type (APPROVER / AGREEMENT / REFERENCE) — VARCHAR(20)
  • approval_method (SEQUENTIAL / PARALLEL) — VARCHAR(20)
  • status (WAITING / APPROVED / REJECTED / SKIPPED) — VARCHAR(20)
  • first_viewed_at (최초 열람 일시) — TIMESTAMP
  • acted_at (실제 처리(승인/반려) 일시) — TIMESTAMP
  • approver_id (지정된 결재자/합의자/참조자 ID) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • document_id (대상 결재 문서 ID) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

결재선 템플릿 (approval_line_templates)

  • id (결재선 템플릿 ID) — BIGINT — 기본 키 — NOT NULL
  • step_order (결재 단계) — INT
  • required_position (요구 직위) — VARCHAR(50)
  • required_job_title (요구 직책) — VARCHAR(50)
  • line_type (APPROVER / AGREEMENT / REFERENCE) — VARCHAR(20)
  • approval_method (SEQUENTIAL / PARALLEL) — VARCHAR(20)
  • is_required (필수 여부) — BOOLEAN
  • form_id (결재 양식 ID) — BIGINT — 외래 키 → 결재 양식.id — NOT NULL

리스크 규칙 (risk_rules)

  • id (리스크 규칙 ID) — BIGINT — 기본 키 — NOT NULL
  • condition_type (AMOUNT / DOCUMENT_TYPE / KEYWORD) — VARCHAR(50)
  • condition_operator (GREATER_THAN / CONTAINS / EQUALS) — VARCHAR(20)
  • condition_value (예: 1000000, 외주계약, 인사발령) — VARCHAR(100)
  • risk_level (NORMAL / HIGH) — VARCHAR(20)
  • created_at (생성 일시) — TIMESTAMP
  • updated_att (수정 일시) — TIMESTAMP
  • department_id (적용 부서) — BIGINT — 외래 키 → 부서.id — NOT NULL
  • form_id (적용 양식) — BIGINT — 외래 키 → 결재 양식.id — NOT NULL
  • created_by (생성한 부서 관리자) — BIGINT — 외래 키 → 사용자.id — NOT NULL

문서 버전 (document_versions)

  • id (문서 버전 ID) — BIGINT — 기본 키 — NOT NULL
  • version_no (버전 번호) — INT
  • title_snapshot (수정 당시 제목) — VARCHAR(200)
  • content_snapshot (수정 당시 본문) — TEXT
  • change_reason (수정 사유) — TEXT
  • created_at (생성 일시) — TIMESTAMP
  • changed_by (수정한 사람 (기안자)) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • document_id (대상 결재 문서 ID) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

부서 (departments)

  • id (부서ID) — BIGINT — 기본 키 — NOT NULL
  • parent_id (상위 부서 ID) — BIGINT — 외래 키 → 부서.id — NOT NULL
  • name (부서명) — VARCHAR(100)
  • created_at (생성일시) — TIMESTAMP
  • created_at (수정 일시) — TIMESTAMP

사용자 (users)

  • id (사용자ID) — BIGINT — 기본 키 — NOT NULL
  • department_id (소속 부서) — BIGINT — 외래 키 → 부서.id — NOT NULL
  • email (사내 이메일) — VARCHAR(100)
  • password_hash (비밀번호 해시) — VARCHAR(255)
  • fido_key (생체/간편 인증 키) — VARCHAR(255)
  • name (사용자 이름) — VARCHAR(50)
  • position (직위) — VARCHAR(50)
  • job_title (직책) — VARCHAR(50)
  • status (ACTIVE / LOCKED / INACTIVE) — VARCHAR(20)
  • created_at (생성 일시) — TIMESTAMP
  • updated_at (수정 일시) — TIMESTAMP
  • otp_secret_key (2FA(TOTP) 인증을 위한 사용자별 고유 시크릿 키) — VARCHAR(255)

사용자역할 (user_roles)

  • role_id (역할ID) — BIGINT — 외래 키 → 역할.id — NOT NULL
  • user_id (사용자ID) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • department_id (부서ID) — BIGINT — 외래 키 → 부서.id — NOT NULL
  • created_at (권한 일시 부여) — TIMESTAMP

알림 (notifications)

  • id (알림 ID) — BIGINT — 기본 키 — NOT NULL
  • type (APPROVAL_REQUEST / APPROVED / REJECTED / WITHDRAWN) — VARCHAR(30)
  • message (알림 내용) — VARCHAR(255)
  • is_read (읽음 여부) — BOOLEAN
  • created_at (생성 일시) — TIMESTAMP
  • user_id (수신자) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • document_id (연관된 결재 문서) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

역할 (roles)

  • id (역할ID) — BIGINT — 기본 키 — NOT NULL
  • code (SYSTEM_ADMIN / DEPARTMENT_ADMIN / USER) — VARCHAR(50)
  • name (역할명) — VARCHAR(100)
  • description (설명) — TEXT

처리 이력 (approval_actions)

  • id (처리 이력 ID) — BIGINT — 기본 키 — NOT NULL
  • action_type (APPROVE / REJECT / WITHDRAW / DELEGATE) — VARCHAR(30)
  • reason (반려 또는 회수 사유) — TEXT
  • auth_required (추가 인증 요구 여부) — BOOLEAN
  • auth_result (SUCCESS / FAILED) — VARCHAR(20)
  • created_at (처리 완료 일시) — TIMESTAMP
  • actor_id (실제 행위자 (승인/반려/회수자)) — BIGINT — 외래 키 → 사용자.id — NOT NULL
  • document_id (대상 결재 문서 ID) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

첨부파일 (attachments)

  • id (첨부파일 ID) — BIGINT — 기본 키 — NOT NULL
  • file_name (파일명) — VARCHAR(255)
  • file_path (저장 경로) — VARCHAR(500)
  • file_type (파일 형식) — VARCHAR(50)
  • ocr_status (PENDING / DONE / FAILED) — VARCHAR(20)
  • ocr_text (OCR 추출 텍스트) — TEXT
  • uploaded_at (업로드 일시) — TIMESTAMP
  • document_id (대상 결재 문서 ID) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL

커스텀 폴더 - 문서 매핑 (custom_folder_documents)

  • folder_id (분류할 커스텀 폴더 ID) — BIGINT — 외래 키 → 개인 커스텀 폴더.id — NOT NULL
  • document_id (분류된 결재 문서 ID) — BIGINT — 외래 키 → 결재 문서.id — NOT NULL
  • created_at (폴더에 추가된 일시) — TIMESTAMP