ERP-node/db/migrations/046_QUICK_FIX.md

# 채번 규칙 마이그레이션 오류 긴급 수정

## 🚨 발생한 오류들

### 오류 1: check_table_scope_requires_table_name
```
SQL Error [23514]: ERROR: new row for relation "numbering_rules" violates check constraint "check_table_scope_requires_table_name"
```
**원인**: `scope_type='table'`인데 `table_name=NULL`

### 오류 2: check_global_scope_no_table_name
```
SQL Error [23514]: ERROR: new row for relation "numbering_rules" violates check constraint "check_global_scope_no_table_name"
```
**원인**: `scope_type='global'`인데 `table_name=''` (빈 문자열)

### 근본 원인
마이그레이션이 부분적으로 실행되어 데이터와 제약조건이 불일치 상태입니다.

## ✅ 해결 방법

### 🎯 가장 쉬운 방법 (권장)

**PgAdmin 또는 DBeaver에서 `046_SIMPLE_FIX.sql` 실행**

이 파일은 다음을 자동으로 처리합니다:
1. ✅ 기존 제약조건 모두 제거
2. ✅ `table_name` NULL → 빈 문자열로 변경
3. ✅ `scope_type`을 모두 'table'로 변경
4. ✅ 결과 확인

```sql
-- db/migrations/046_SIMPLE_FIX.sql 전체 내용을 복사하여 실행하세요
```

**실행 후**:
- `046_update_numbering_rules_scope_type.sql` 전체 실행
- 완료!

---

### 옵션 2: 명령줄에서 실행

```bash
# 1. 긴급 수정 SQL 실행
psql -h localhost -U postgres -d ilshin -f db/fix_existing_numbering_rules.sql

# 2. 전체 마이그레이션 실행
psql -h localhost -U postgres -d ilshin -f db/migrations/046_update_numbering_rules_scope_type.sql
```

---

### 옵션 3: Docker 컨테이너 내부에서 실행

```bash
# 1. Docker 컨테이너 확인
docker ps | grep postgres

# 2. 컨테이너 내부 접속
docker exec -it <CONTAINER_NAME> psql -U postgres -d ilshin

# 3. SQL 실행
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

# 4. 확인
SELECT COUNT(*) FROM numbering_rules WHERE table_name IS NULL;
-- 결과: 0

# 5. 종료
\q
```

---

## 🔍 왜 이 문제가 발생했나?

### 기존 마이그레이션 순서 (잘못됨)
```sql
-- 1. scope_type 변경 (먼저 실행됨)
UPDATE numbering_rules SET scope_type = 'table' WHERE scope_type IN ('global', 'menu');

-- 2. table_name 정리 (나중에 실행됨)
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

-- 3. 제약조건 추가
ALTER TABLE numbering_rules ADD CONSTRAINT check_table_scope_requires_table_name ...
```

**문제점**: 
- `scope_type='table'`로 변경된 후
- 아직 `table_name=NULL`인 상태
- 이 상태에서 INSERT/UPDATE 시도 시 제약조건 위반

### 수정된 마이그레이션 순서 (올바름)
```sql
-- 1. table_name 정리 (먼저 실행!)
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

-- 2. scope_type 변경
UPDATE numbering_rules SET scope_type = 'table' WHERE scope_type IN ('global', 'menu');

-- 3. 제약조건 추가
ALTER TABLE numbering_rules ADD CONSTRAINT check_table_scope_requires_table_name ...
```

---

## 📋 실행 체크리스트

- [ ] 옵션 1, 2, 또는 3 중 하나 선택하여 데이터 수정 완료
- [ ] `SELECT COUNT(*) FROM numbering_rules WHERE table_name IS NULL;` 실행 → 결과가 `0`인지 확인
- [ ] 전체 마이그레이션 `046_update_numbering_rules_scope_type.sql` 실행
- [ ] 백엔드 재시작
- [ ] 프론트엔드에서 채번 규칙 테스트

---

## 🎯 완료 후 확인사항

### SQL로 최종 확인
```sql
-- 1. 모든 규칙이 table 타입인지
SELECT scope_type, COUNT(*) 
FROM numbering_rules 
GROUP BY scope_type;
-- 결과: table만 나와야 함

-- 2. table_name이 NULL인 규칙이 없는지
SELECT COUNT(*) 
FROM numbering_rules 
WHERE table_name IS NULL;
-- 결과: 0

-- 3. 샘플 데이터 확인
SELECT 
  rule_id,
  rule_name,
  scope_type,
  table_name,
  company_code
FROM numbering_rules
LIMIT 5;
```

---

## 💡 추가 정보

수정된 마이그레이션 파일(`046_update_numbering_rules_scope_type.sql`)은 이제 올바른 순서로 실행되도록 업데이트되었습니다. 하지만 **이미 실행된 부분적인 마이그레이션**으로 인해 데이터가 불일치 상태일 수 있으므로, 위의 긴급 수정을 먼저 실행하는 것이 안전합니다.