ERD 사용 가이드
ERD는 프로젝트의 요구사항과 결정을 데이터 구조로 구체화할 때 사용하는 전문 산출물입니다. 먼저 Markdown 기준 문서에서 목표와 범위를 확인한 뒤 필요한 데이터 모델을 만드세요.
시작하기 전에
ERD를 만들기 전에 다음 내용을 확인합니다.
- 어떤 사용자 흐름을 지원하는가
- 어떤 정보가 저장되는가
- 상태와 권한 규칙은 무엇인가
- 기존 시스템이나 API와 연결되는가
- 아직 결정되지 않은 질문은 무엇인가
프로젝트 기준 문서를 읽고 필요한 데이터 구조를 ERD 초안으로 만들어줘.
처음부터 모든 테이블을 완성하기보다 핵심 흐름에 필요한 범위부터 시작합니다.
Agent로 구조 변경하기
Agent는 테이블, 컬럼, 인덱스, 관계, Enum과 테이블 그룹의 생성·수정·삭제를 하나의 변경 요청으로 적용할 수 있습니다. 관련된 변경을 따로 실행해 중간 상태를 만들기보다 전체 의도를 설명하고 적용 후 구조를 다시 확인합니다.
사용자, 권한과 초대 요구사항을 기준으로 필요한 테이블·컬럼·관계·인덱스를 한 번에 제안하고, 적용 전에 변경 목록을 보여줘.
대량 삭제, 컬럼 타입 변경과 관계 변경은 데이터 손실과 구현 영향이 있으므로 실행 전에 대상을 확인합니다.
캔버스 사용하기
캔버스에서 테이블을 배치하고 관계를 연결해 구조를 확인합니다. 확대·축소, 이동, 필터와 그룹을 사용해 복잡한 모델을 필요한 범위로 나눠 볼 수 있습니다.
스티키 노트에는 설계 이유, 확인할 질문과 검토 메모를 남깁니다. 확정된 결정은 노트에만 두지 않고 프로젝트 기준 Markdown에도 반영하세요.
테이블과 컬럼
테이블에는 업무에서 사용하는 개체를, 컬럼에는 저장할 값을 정의합니다.
검토할 내용:
- 이름이 프로젝트 용어와 일치하는가
- 기본 키가 분명한가
- 필수 값과 선택 값이 구분되는가
- 데이터 타입과 기본값이 실제 사용 방식에 맞는가
- 민감한 데이터가 드러나는가
관계와 외래 키
관계는 테이블 간 연결과 데이터의 소유 방향을 나타냅니다.
- 일대일, 일대다와 다대다 중 실제 규칙에 맞는가
- 외래 키가 올바른 테이블에 있는가
- 삭제와 변경 시 데이터가 어떻게 처리되는가
- 선택 관계와 필수 관계가 구분되는가
현재 ERD의 관계와 외래 키를 검토하고 누락되거나 충돌하는 부분을 알려줘.
Enum·인덱스·테이블 그룹
Enum은 제한된 상태나 유형 값을 명시할 때 사용합니다. 값이 자주 바뀌거나 별도 속성이 필요하면 테이블이 더 적절한지 검토하세요.
인덱스는 실제 조회와 정렬 조건을 기준으로 설계합니다. 모든 컬럼에 무조건 추가하지 말고 중복과 쓰기 비용을 함께 확인합니다.
테이블 그룹은 큰 ERD를 업무 영역별로 나누어 이해할 때 사용합니다. 그룹 이름은 프로젝트의 도메인 용어와 맞춥니다.
편집 기능
- 필터: 현재 검토할 테이블과 컬럼에 집중합니다.
- Copy & Paste: 반복 구조를 빠르게 만들되 이름과 관계를 다시 확인합니다.
- Undo & Redo: 편집 과정의 변경을 되돌리거나 다시 적용합니다.
- 키보드 단축키: 현재 화면에서 제공하는 단축키를 확인해 사용합니다.
여러 변경을 한 뒤에는 테이블, 컬럼과 관계가 의도한 상태인지 다시 확인하세요.
내장 AI와 외부 Agent
ERD 화면의 내장 AI는 현재 ERD 편집에 집중합니다. 연결된 외부 Agent는 프로젝트의 Markdown, 자료와 다른 산출물을 함께 읽고 ERD 작업을 요청받을 수 있습니다.
둘 중 무엇을 사용하더라도 결과가 자동으로 공식 기준이 되는 것은 아닙니다. 사람이 검토한 결정은 프로젝트 기준 문서에 다시 남깁니다.
구조 확인과 배치
Agent는 ERD의 테이블, 관계, Enum과 그룹을 목록 또는 개별 항목으로 읽고 테이블 배치를 정리할 수 있습니다. 화면 배치는 이해를 돕지만 데이터 모델의 의미를 대신하지 않습니다.
함께 검토할 문서
ERD를 요구사항, 화면, 권한 정책과 OpenAPI 명세와 비교하세요. 데이터 구조가 바뀌면 영향받는 API와 프로젝트 기준도 함께 확인합니다.
외부 스키마를 가져오거나 결과를 전달해야 한다면 ERD 가져오기·내보내기와 변경 관리로 이어가세요.