# 데이터베이스 설계서 (Database Schema)

## 1. 공통 원칙

- **Soft Delete:** 모든 테이블 `is_deleted CHAR(1) DEFAULT 'N'` — 물리 삭제 금지
- **Audit:** 모든 테이블 `created_at TIMESTAMP`, `updated_at TIMESTAMP` — 감사 로그
- **ID 생성:** `Sequence` + `allocationSize=50` — Oracle 11g 최적화
- **공통 코드:** 드롭다운/상태값은 Common Code 테이블에서 동적 관리

## 2. 공통 코드 인프라

### TB_COMMON_CODE_GROUP (대분류)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| GROUP_CODE | VARCHAR2(50) | PK | 'PROJECT_TYPE', 'ISSUE_STATUS' |
| GROUP_NAME | VARCHAR2(100) | NOT NULL | '프로젝트 유형', '이슈 상태' |
| DESCRIPTION | CLOB | NULLABLE | |

### TB_COMMON_CODE (소분류)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| CODE_ID | NUMBER | PK (Seq) | 시퀀스 자동 증가 |
| GROUP_CODE | VARCHAR2(50) | FK | TB_COMMON_CODE_GROUP 참조 |
| CODE_VALUE | VARCHAR2(50) | UNIQUE, NOT NULL | 내부 로직 코드 ('BUG', 'SI') |
| CODE_NAME | VARCHAR2(100) | NOT NULL | 화면 표시용 ('결함 및 장애') |
| OPTION_VAL_1 | VARCHAR2(100) | NULLABLE | UI 뱃지 색상 |
| OPTION_VAL_2 | VARCHAR2(100) | NULLABLE | SLA 가중치 |
| OPTION_VAL_3 | VARCHAR2(100) | NULLABLE | 연동 키 |
| SORT_ORDER | NUMBER | DEFAULT 1 | 노출 순서 |
| IS_ACTIVE | CHAR(1) | DEFAULT 'Y' | 'Y'/'N' |
| DESCRIPTION | CLOB | NULLABLE | |

**공통 코드 예시 데이터:**

| GROUP_CODE | CODE_VALUE | CODE_NAME | OPTION_VAL_1 (색상) | OPTION_VAL_2 (SLA) |
|------------|-----------|-----------|---------------------|--------------------|
| ISSUE_STATUS | OPEN | 접수 | blue | 48h |
| ISSUE_STATUS | IN_PROGRESS | 처리중 | orange | - |
| ISSUE_STATUS | RESOLVED | 해결 | green | - |
| ISSUE_STATUS | CLOSED | 종료 | gray | - |
| PRIORITY | CRITICAL | 긴급 | red | 4h |
| PRIORITY | HIGH | 높음 | orange | 24h |
| PRIORITY | NORMAL | 보통 | blue | 72h |
| PRIORITY | LOW | 낮음 | gray | 120h |

## 3. 도메인 테이블 명세

### TB_EMPLOYEE (직원 마스터)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| EMP_ID | NUMBER | PK (Seq) | 시스템 고유 사번 |
| LOGIN_ID | VARCHAR2(50) | UNIQUE, NOT NULL | 인증용 ID |
| PASSWORD | VARCHAR2(255) | NOT NULL | BCrypt 암호화 |
| NAME | VARCHAR2(50) | NOT NULL | 실명 |
| EMAIL | VARCHAR2(100) | UNIQUE, NOT NULL | 회사 이메일 |
| ROLE_CODE | VARCHAR2(20) | NOT NULL | ADMIN / MANAGER / EMPLOYEE |
| EMP_STATUS | VARCHAR2(20) | NOT NULL | ACTIVE / ON_LEAVE / RESIGNED |
| DISPATCH_STATUS | VARCHAR2(20) | NOT NULL | WAITING / DISPATCHED |
| JOINED_DATE | DATE | NOT NULL | 입사일 |
| LEFT_DATE | DATE | NULLABLE | 퇴사일 |
| IS_DELETED | CHAR(1) | DEFAULT 'N' | Soft Delete |

### TB_PROJECT (프로젝트 마스터)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| PROJECT_ID | NUMBER | PK (Seq) | |
| PROJECT_TYPE | VARCHAR2(20) | NOT NULL | SI / SM / MIGRATION |
| PROJECT_NAME | VARCHAR2(150) | NOT NULL | 공식 프로젝트명 |
| CONTRACT_COMPANY | VARCHAR2(100) | NOT NULL | 원청 계약사 |
| END_USER_COMPANY | VARCHAR2(100) | NOT NULL | 최종 고객사 |
| CONTRACT_TYPE | VARCHAR2(20) | NOT NULL | TURN_KEY / MM |
| STATUS | VARCHAR2(20) | NOT NULL | PREPARING / ONGOING / COMPLETED / HOLD |
| START_DATE | DATE | NOT NULL | |
| END_DATE | DATE | NOT NULL | |
| WORK_LOCATION_TYPE | VARCHAR2(20) | NOT NULL | ON_SITE / REMOTE / HYBRID |
| WORK_ADDRESS | VARCHAR2(255) | NOT NULL | 파견지 물리 주소 |
| TECH_ENVIRONMENT | CLOB | NULLABLE | 기술 스택 묶음 |
| MAIN_TASK_DESC | CLOB | NOT NULL | 구축 목적 요약 |
| CLIENT_PM_NAME | VARCHAR2(50) | NULLABLE | |
| CLIENT_PM_CONTACT | VARCHAR2(100) | NULLABLE | |
| INTERNAL_MANAGER_ID | NUMBER | FK → TB_EMPLOYEE | 내부 영업 담당자 |

### TB_DISPATCH_HISTORY (파견 투입 이력 = 포트폴리오)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| DISPATCH_ID | NUMBER | PK (Seq) | 포트폴리오 라인 단건 |
| EMP_ID | NUMBER | FK → TB_EMPLOYEE | |
| PROJECT_ID | NUMBER | FK → TB_PROJECT | |
| START_DATE | DATE | NOT NULL | 실제 투입일 |
| END_DATE | DATE | NULLABLE | NULL=현재 투입중 |
| ROLE_TITLE | VARCHAR2(50) | NOT NULL | PM / PL / BACKEND / FRONTEND / DBA |
| CONTRIBUTION_RATE | NUMBER | DEFAULT 100 | 투입률(%) |
| INDIVIDUAL_TECH | VARCHAR2(255) | NOT NULL | 개인이 직접 사용한 기술 |
| PERFORMED_TASKS | CLOB | NOT NULL | 상세 수행 업무 |
| ACHIEVEMENTS | CLOB | NULLABLE | 트러블슈팅 사례 |
| CLIENT_FEEDBACK | CLOB | NULLABLE | 고객사 PM 평가 (본사 은닉) |
| INTERNAL_RATING | NUMBER | NULLABLE | 1~5 |

### TB_ISSUE_TICKET (SR 티켓 마스터)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| TICKET_ID | NUMBER | PK (Seq) | 고유 식별 번호 |
| PROJECT_ID | NUMBER | FK → TB_PROJECT | 발생 현장 |
| REQUESTER_ID | NUMBER | FK → TB_EMPLOYEE | SOS 발행 직원 |
| ASSIGNEE_ID | NUMBER | FK → TB_EMPLOYEE | 본사 해결사 |
| CATEGORY | VARCHAR2(30) | NOT NULL | BUG / FEATURE / SUPPORT / QA |
| PRIORITY | VARCHAR2(20) | NOT NULL | LOW / NORMAL / HIGH / CRITICAL |
| TITLE | VARCHAR2(255) | NOT NULL | |
| DESCRIPTION | CLOB | NOT NULL | 에러 재현 경로 |
| STATUS | VARCHAR2(20) | NOT NULL | OPEN / ASSIGNED / IN_PROGRESS / RESOLVED / CLOSED |
| DUE_DATE | DATE | NULLABLE | SLA 데드라인 |
| RESOLVED_AT | TIMESTAMP | NULLABLE | 해결 일시 |
| RESOLUTION_NOTE | CLOB | NULLABLE | 조치 내역 |
| SLA_WARN_FLAG | CHAR(1) | DEFAULT 'N' | 배치 알림 중복 방지 |

### TB_TICKET_COMMENT (티켓 타임라인 댓글)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| COMMENT_ID | NUMBER | PK (Seq) | |
| TICKET_ID | NUMBER | FK → TB_ISSUE_TICKET | |
| USER_ID | NUMBER | FK → TB_EMPLOYEE | 작성자 |
| COMMENT_TEXT | CLOB | NOT NULL | 분석 의견 |
| ATTACHED_FILE_URL | VARCHAR2(255) | NULLABLE | 첨부파일 경로 |

### TB_WORK_REPORT (업무 보고서)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| REPORT_ID | NUMBER | PK (Seq) | |
| DISPATCH_ID | NUMBER | FK → TB_DISPATCH_HISTORY | |
| USER_ID | NUMBER | FK → TB_EMPLOYEE | 작성자 |
| REPORT_TYPE | VARCHAR2(20) | NOT NULL | DAILY / WEEKLY / MONTHLY / RETURN |
| TARGET_DATE | DATE | NOT NULL | 기준일 |
| COMPLETED_TASKS | CLOB | NOT NULL | SR 연동 자동 취합 영역 |
| PLANNED_TASKS | CLOB | NOT NULL | 차기 계획 |
| ISSUES_AND_RISKS | CLOB | NULLABLE | 특이사항 |
| SUPPORT_REQUESTED | CLOB | NULLABLE | 본사 지원 요청 |
| STATUS | VARCHAR2(20) | NOT NULL | DRAFT / SUBMITTED / APPROVED / REJECTED |
| REVIEWER_ID | NUMBER | FK → TB_EMPLOYEE | 결재자 |
| REVIEW_COMMENT | CLOB | NULLABLE | 반려 사유 |

### TB_EQUIPMENT (IT 자산 마스터)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| EQUIPMENT_ID | NUMBER | PK (Seq) | |
| EQUIPMENT_TYPE | VARCHAR2(50) | NOT NULL | LAPTOP / MONITOR / TEST_DEVICE / ACCESSORY |
| MANUFACTURER | VARCHAR2(50) | NOT NULL | Apple / LG / Samsung |
| MODEL_NAME | VARCHAR2(100) | NOT NULL | MacBook Pro 16 M3 |
| SERIAL_NUMBER | VARCHAR2(100) | UNIQUE, NOT NULL | 기기 고유 바코드 |
| ASSET_CODE | VARCHAR2(50) | UNIQUE, NOT NULL | HQ-LP-2026-0001 |
| SPECIFICATIONS | CLOB (JSON) | NOT NULL | JSON 다품종 사양 |
| STATUS | VARCHAR2(20) | NOT NULL | AVAILABLE / IN_USE / REPAIRING / RETIRED / LOST |
| PURCHASE_DATE | DATE | NOT NULL | |
| WARRANTY_EXP_DATE | DATE | NOT NULL | |
| VERSION | NUMBER | DEFAULT 0 | **낙관적 락** |

### TB_EQUIPMENT_ASSIGNMENT (장비 지급/반납 이력)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| ASSIGNMENT_ID | NUMBER | PK (Seq) | |
| EQUIPMENT_ID | NUMBER | FK → TB_EQUIPMENT | |
| USER_ID | NUMBER | FK → TB_EMPLOYEE | 지급 대상 |
| ASSIGNED_DATE | DATE | NOT NULL | 출고일 |
| RETURNED_DATE | DATE | NULLABLE | NULL=사용중 |
| COND_ON_ASSIGN | VARCHAR2(255) | NOT NULL | 지급시 상태 |
| COND_ON_RETURN | VARCHAR2(255) | NULLABLE | 반납시 상태 |

### TB_EQUIPMENT_MAINTENANCE (장비 유지보수 이력)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| MAINTENANCE_ID | NUMBER | PK (Seq) | |
| EQUIPMENT_ID | NUMBER | FK → TB_EQUIPMENT | |
| REPORTED_BY | NUMBER | FK → TB_EMPLOYEE | 고장 접수자 |
| MAINTENANCE_TYPE | VARCHAR2(30) | NOT NULL | REPAIR / UPGRADE / INSPECTION / DISPOSAL |
| ISSUE_DESCRIPTION | CLOB | NOT NULL | 고장 증상 |
| ACTION_TAKEN | CLOB | NULLABLE | 조치 내역 |
| COST | NUMBER | DEFAULT 0 | 발생 비용 |
| REPORTED_DATE | DATE | NOT NULL | |
| RESOLVED_DATE | DATE | NULLABLE | |

### TB_TRAINING_PROGRESS (교육 진도)

| 컬럼 | 타입 | 제약 | 설명 |
|------|------|------|------|
| PROGRESS_ID | NUMBER | PK (Seq) | |
| USER_ID | NUMBER | FK → TB_EMPLOYEE | |
| COURSE_NAME | VARCHAR2(100) | NOT NULL | 과정명 |
| PROGRESS_RATE | NUMBER | DEFAULT 0 | 0~100 |
| STATUS | VARCHAR2(20) | NOT NULL | NOT_STARTED / ONGOING / COMPLETED |

## 4. ER 관계 요약

```
TB_EMPLOYEE ──1:N── TB_DISPATCH_HISTORY ──N:1── TB_PROJECT
                                           └──1:N── TB_WORK_REPORT
     │
     └──1:N── TB_ISSUE_TICKET ──1:N── TB_TICKET_COMMENT
     │
     └──1:N── TB_EQUIPMENT_ASSIGNMENT ──N:1── TB_EQUIPMENT
     │                                          └──1:N── TB_EQUIPMENT_MAINTENANCE
     └──1:N── TB_TRAINING_PROGRESS
```

## 5. DDL 생성 참고 사항

- 모든 `SEQUENCE`: `INCREMENT BY 50` (Hibernate `allocationSize=50`과 정합)
- 모든 시퀀스명 컨벤션: `SEQ_TB_XXX`
- 모든 PK 컬럼: `NUMBER` 타입, 시퀀스 자동 할당
- `SPECIFICATIONS` (TB_EQUIPMENT): `CLOB`에 JSON 문자열 저장, 애플리케이션 레벨 직렬화/역직렬화
- 물리 스키마 DDL 파일: `src/main/resources/ddl/oracle_11g_schema.sql` 별도 관리