PostgreSQL 테이블명 단수형 통일 작업 문서화

- plans에서 troubleshooting으로 이동
- 날짜 250911로 업데이트
- 완료 사항 체크 및 교훈 추가
This commit is contained in:
happybell80 2025-09-11 20:50:28 +09:00
parent 30b6d7e444
commit 332a25de68

View File

@ -1,9 +1,9 @@
# PostgreSQL 데이터베이스 테이블 변경 계획
# PostgreSQL 테이블명 단수형 통일 작업
## 작성 정보
- **작성일**: 250910
- **작성일**: 250911
- **작성자**: happybell80
- **목적**: PostgreSQL 테이블 구조 대대적 변경에 따른 영향 범위 파악 및 수정 계획
- **문제**: 코드는 복수형, DB는 단수형 테이블명 사용으로 불일치
## 1. 데이터베이스 연결 정보
@ -197,13 +197,13 @@
- [ ] API 응답 필드명 확인
### 3.3 저장소별 작업
- [x] auth-server: SQLAlchemy 모델 + asyncpg 쿼리 수정
- [ ] rb8001: SQLAlchemy 모델 + text() 쿼리 수정
- [ ] rb10508_micro: asyncpg 직접 쿼리 수정
- [ ] frontend-base: asyncpg 직접 쿼리 수정
- [x] robeing-gateway: SQLAlchemy 모델 + asyncpg 쿼리 수정
- [ ] robeing-monitor: SQLAlchemy 모델 + asyncpg 쿼리 수정
- [ ] skill-email: psycopg2 쿼리 수정
- [x] auth-server: 이미 완료 상태
- [x] rb8001: 테이블명 단수형 변경 완료
- [x] rb10508_micro: 사용 안함 (폐기 예정)
- [x] frontend-base: system_metrics 비활성화 완료
- [x] robeing-gateway: 이미 완료 상태
- [x] robeing-monitor: 테이블명 변경 및 import 수정 완료
- [x] skill-email: gmail_token 변경 완료
### 3.4 테스트 계획
- [ ] 각 저장소별 단위 테스트
@ -230,11 +230,11 @@
4. **비어있는 주요 테이블** (레코드 0건):
- conversation_log, gmail_token, news, user_preference, workspace_member
## 5. 작업 우선순위
## 5. 수행 결과
1. **긴급**: 테이블명 불일치 해결 (user vs users 등)
2. **높음**: 존재하지 않는 테이블 생성 또는 코드 수정
3. **중간**: 컬럼 불일치 해결
1. **완료**: 모든 복수형 테이블명을 단수형으로 통일
2. **주석 처리**: 존재하지 않는 테이블 참조 코드
3. **배포 성공**: 모든 서비스 정상 동작 확인
## 6. 롤백 계획
@ -244,7 +244,7 @@
4. 단계별 배포 (테스트 환경 → 프로덕션)
---
**주의사항**:
- 모든 변경사항은 테스트 환경(rb10508_micro)에서 먼저 검증
- 프로덕션(rb8001) 적용은 완전한 테스트 후 진행
- 데이터 손실 방지를 위한 백업 필수
**교훈**:
- DB 테이블명은 단수형 사용이 PostgreSQL 관례
- 코드와 DB 구조 일치 필수
- 존재하지 않는 테이블은 주석 처리로 명시