Feature #1521
closed[T05] 전체 DB ERD 및 테이블 계약 확정
100%
Description
제목: [T05] 전체 DB ERD 및 테이블 계약 확정
목표 및 사용자 시나리오: 46개 테이블 후보를 T04 기능 판정에 맞춰 확정·제외·추가하고, 모든 컬럼의 형식/NULL/PK/FK/삭제정책/인덱스/보안등급/보존기간을 명시
범위/비범위: ERD·데이터 사전·요구사항→테이블 매핑. 실제 Migration SQL(T08·T09), Staging 적용(T12)은 비범위. DDL 자동 적용 금지
담당자: 이상재 (GitHub: sangjae-lee97)
선행조건: T04 (#1495, PR #13 머지)
관련 화면/API/DB: database/FULL_DATABASE_MODEL.md, docs/API_CONTRACT.md, docs/requirements/FEATURE_BASELINE.md
완료조건(테스트·증빙 포함): FULL_DATABASE_MODEL.md 업데이트, 전체 ERD, 데이터 사전, 요구사항→테이블 매핑 100%, 일회용 PostgreSQL 검증 결과, FK/유니크/권한 정책 리뷰 승인
예상 일정: 2026-11-06 ~
브랜치 / PR / Merge SHA: task/t05-erd-data-dictionary / https://github.com/ai-career-platform/ai-career-platform/pull/17 / a004efb259822c1eaddd02088b6036ca030ff99e
Staging 검증 결과: 해당 없음 (Staging DB 변경 없음)
링크
- 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/work-orders/initial-30/T05.md
- 선행 T04: https://sulfite-footbath-next.ngrok-free.dev/issues/1495 / https://github.com/ai-career-platform/ai-career-platform/pull/13
- 현재 DB 모델 초안: https://github.com/ai-career-platform/ai-career-platform/blob/main/database/FULL_DATABASE_MODEL.md
- 후행 일감: T06, T07, T08, T09, T10
Subtasks
상이 Updated by 상재 이 11 days ago
- Description updated (diff)
- % Done changed from 10 to 90
PR 생성 + 리뷰 요청(GilbertMoon), CI PASS
https://github.com/ai-career-platform/ai-career-platform/pull/17
산출물: database/DATA_DICTIONARY.md, database/ERD.md, database/FULL_DATABASE_MODEL.md v0.2 (T05_STATUS=PARTIAL)
Updated by Anonymous 11 days ago
- Precedes Feature #1548: [T35] 목표 직무 관리 API added
Updated by Anonymous 11 days ago
- Precedes Feature #1551: [T37] 개인 경력·프로젝트 이력 API added
Updated by Anonymous 11 days ago
- Precedes Feature #1553: [T39] 관심 채용공고 북마크 API added
상이 Updated by 상재 이 11 days ago
T04 기준선(PR #13 머지) 반영 커밋 ae8acbc 푸시, PR 본문 갱신, Crasnec 리뷰 요청 — 진척도 90% 유지
https://github.com/ai-career-platform/ai-career-platform/pull/17
- 테이블별 요구사항 ID(FR/NFR) 연결, 비교용 이메일, password_reset_tokens, 무작위 파일 저장 이름
상이 Updated by 상재 이 11 days ago
- Description updated (diff)
- Status changed from In Progress to Closed
- % Done changed from 90 to 100
완료 — PR #17 리뷰 후 main에 머지.
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/17
- Merge SHA: a004efb259822c1eaddd02088b6036ca030ff99e (2026-11-06, main)
- 데이터 사전: https://github.com/ai-career-platform/ai-career-platform/blob/main/database/DATA_DICTIONARY.md
- ERD: https://github.com/ai-career-platform/ai-career-platform/blob/main/database/ERD.md
h3. 머지된 최종 내용 (7개 파일)
- database/DATA_DICTIONARY.md — 테이블 51개 · 컬럼 329개 · FK 76개. 컬럼별 형식/NULL/PK/FK/삭제정책/인덱스/보안등급/보존기간, 테이블별 요구사항 ID(FR/NFR) 연결
- database/ERD.md — 영역별 ERD
- database/FULL_DATABASE_MODEL.md §10 — 확정·제외·추가 테이블 정리
- database/model/check_data_dictionary.py — 데이터 사전 검증, ERD·검증용 DDL 생성
- database/tests/ — test_data_dictionary.py, t05_contract_cases.sql, test_data_dictionary_ddl.sh (일회용 PostgreSQL에서 FK·유니크·제약 검증)
h3. 진행 중 바뀐 내용
- T04 기준선(PR #13 머지) 반영: 비교용 이메일(canonical email), password_reset_tokens 추가, 업로드 파일 무작위 저장 이름
- 리뷰 반영 후 Crasnec 승인으로 머지
h3. 남은 사항
- 실제 Migration SQL은 T08·T09, Staging 적용은 T12
- DB 계정·권한 검증은 T07(#1567)에서 진행 중
Staging 검증 결과: 해당 없음 (Staging DB 변경 없음)