15

ERD 설계 실수 Top 3

Day 4: 이 테이블 설계 누가 했어요? - ERD 패턴

학습 목표

ERD 설계 시 흔한 실수를 피한다 문서화의 중요성을 인식한다

실수 1: ERD를 안 그림

"코드 보면 되지, 문서가 왜 필요해?"

6개월 후:

"이 테이블 관계가 뭐였지?" "새 팀원이 왔는데 설명하려니 나도 헷갈리네"

반드시 ERD 그리자!

  • 최소한 dbdiagram.io 코드라도 Git에 저장
  • 변경 시 ERD도 같이 업데이트

실수 2: 명명 불일치

에디터 로딩 중...

한 프로젝트에서 하나의 규칙! 팀에서 합의하고, 문서화하고, 지키자.


실수 3: FK 없이 "알아서 JOIN"

에디터 로딩 중...

FK 제약조건으로 명시적 관계!

에디터 로딩 중...

ERD 작성 팁

  1. 도구 선택: dbdiagram.io (코드 기반, 버전 관리)
  2. Git에 저장: docs/erd.dbml
  3. PR에 ERD 변경 포함: 테이블 변경 시 ERD도 업데이트
  4. 자동 생성 활용: DBeaver, pgAdmin 등에서 역공학
에디터 로딩 중...

ERD 체크리스트

체크항목
[ ]모든 테이블에 PK 있음?
[ ]FK 제약조건 명시됨?
[ ]명명 규칙 일관성?
[ ]ERD 파일 Git에 있음?
[ ]최근 변경이 반영됨?