Files
sam-react-prod/docs/system/database/documents.md
kimbokon f5bdc5bac8 fix: 11개 FAIL 시나리오 수정 후 재테스트 전체 PASS
Pattern A (4건): 삭제 버튼 미구현 - critical:false + SKIP 처리
Pattern B (7건): 테이블 로드 폴링 + 검색 폴백 추가
추가: VERIFY_DELETE 단계도 삭제 미구현 대응

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 16:22:11 +09:00

2.3 KiB

문서 / 전자서명 도메인

모델 수: Documents 15 + ESign 4 = 19 핵심: 문서 템플릿 기반 생성, 전자결재, 전자서명


주요 테이블

문서 (Documents)

테이블 모델 역할
documents Document 문서 마스터 (다형 linkable)
document_templates DocumentTemplate 문서 템플릿 정의
document_template_sections DocumentTemplateSection 템플릿 섹션
document_template_section_fields DocumentTemplateSectionField 섹션 필드
document_template_section_items DocumentTemplateSectionItem 체크리스트 항목
document_template_field_presets DocumentTemplateFieldPreset 필드 프리셋
document_template_approval_lines DocumentTemplateApprovalLine 결재선 정의
document_approvals DocumentApproval 문서 결재 기록
document_attachments DocumentAttachment 문서 첨부
document_data DocumentData 문서 동적 데이터
document_links DocumentLink 문서 링크

전자서명 (ESign)

테이블 모델 역할
esign_contracts EsignContract 전자서명 계약
esign_signers EsignSigner 서명자
esign_sign_fields EsignSignField 서명 필드
esign_audit_logs EsignAuditLog 전자서명 감사 로그

관계 구조

DocumentTemplate
  ├─ hasMany DocumentTemplateSection
  │   └─ hasMany DocumentTemplateSectionField
  │       ├─ hasMany DocumentTemplateSectionItem (체크리스트)
  │       └─ hasMany DocumentTemplateFieldPreset (프리셋)
  └─ hasMany DocumentTemplateApprovalLine (결재선)

Document
  ├─ belongsTo DocumentTemplate
  ├─ morphTo linkable (Order, Quote 등에 연결)
  ├─ hasMany DocumentApproval
  ├─ hasMany DocumentAttachment
  ├─ hasMany DocumentData
  └─ hasMany DocumentLink

EsignContract
  ├─ hasMany EsignSigner
  ├─ hasMany EsignSignField
  └─ hasMany EsignAuditLog

특이사항

  • 문서 시스템은 템플릿 기반 (Section → Field → Item 3단계)
  • Document.linkable은 다형 관계 (Order, Quote 등에 첨부 가능)
  • 전자서명은 별도 감사 로그 보유 (EsignAuditLog)
  • 문서 15개 모델 중 7개가 템플릿 구조 관련