SamProject/sam-react-prod
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f5bdc5bac8c076b74430cfcc8ceab2900d3e727e
sam-react-prod/docs/system/database/commons.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.5 KiB
Raw Blame History

공통 / 게시판 / 감사 도메인

모델 수: Commons 10 + Boards 5 + Audit 2 = 17 핵심: 범용 분류, 파일 관리, 게시판 시스템, 감사 로그

주요 테이블

공통 (Commons)

테이블 모델 역할
categories Category 범용 계층 분류 (parent_id, self-reference)
category_fields CategoryField 카테고리 동적 필드 (EAV)
category_templates CategoryTemplate 카테고리 필드 스냅샷 (버전)
category_logs CategoryLog 카테고리 변경 로그
classifications Classification 분류 체계
files File 파일 첨부 (다형: morphMany)
menus Menu 메뉴 체계
tags Tag 태그 시스템
holidays Holiday 공휴일
common_codes CommonCode 공통 코드

게시판 (Boards)

테이블 모델 역할
boards Board 게시판 정의
posts Post 게시글
board_settings BoardSetting 게시판 동적 필드 정의
post_custom_field_values PostCustomFieldValue 게시글 커스텀 필드 값 (EAV)
board_comments BoardComment 댓글

감사 (Audit)

테이블 모델 역할
audit_logs AuditLog 변경 감사 로그 (불변)
trigger_audit_logs TriggerAuditLog DB 트리거 감사 로그

관계 구조

Category (계층 분류)
  ├─ belongsTo Category (parent_id → self)
  ├─ hasMany Category (children)
  ├─ hasMany CategoryField (EAV 동적 필드)
  ├─ hasMany CategoryTemplate (필드 버전 스냅샷)
  ├─ hasMany Product
  └─ belongsToMany File via tags

Board (게시판)
  ├─ hasMany Post
  │   ├─ hasMany PostCustomFieldValue (EAV)
  │   └─ hasMany BoardComment
  └─ hasMany BoardSetting (동적 필드 정의)

File (범용 첨부)
  └─ morphTo fileable (어떤 모델에든 첨부 가능)

EAV 패턴

게시판과 카테고리 모두 EAV(Entity-Attribute-Value) 패턴 사용:

Board → BoardSetting (필드 정의: field_name, field_type)
Post → PostCustomFieldValue (필드 값: board_setting_id, value)

Category → CategoryField (필드 정의: field_name, field_type)

특이사항

  • File은 다형(morphMany) 관계 — 모든 모델에서 파일 첨부 가능
  • AuditLog는 불변 (timestamps 없음, SoftDeletes 없음)
  • 감사 로그 보존 정책: 13개월
  • 게시판 시스템: EAV 패턴으로 동적 필드 지원 (노션 스타일 전환 계획 중)