Add DB schema check and migration scripts for tags column

check_tags_table_schema.py

@@ -0,0 +1,151 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""uploaded_file 테이블의 tags 컬럼 존재 여부 확인 및 수정"""
+import sys
+import os
+from pathlib import Path
+
+# 프로젝트 루트를 Python 경로에 추가
+project_root = Path(__file__).parent
+sys.path.insert(0, str(project_root))
+
+from app import create_app
+from app.database import db
+from sqlalchemy import inspect, text
+
+def check_and_fix_tags_column():
+    """uploaded_file 테이블에 tags 컬럼이 있는지 확인하고 없으면 추가"""
+    app = create_app()
+    
+    with app.app_context():
+        try:
+            print("\n" + "="*80)
+            print("데이터베이스 연결 정보:")
+            print("="*80)
+            print(f"DB URI: {app.config.get('SQLALCHEMY_DATABASE_URI', 'N/A')}")
+            
+            # DB 엔진 가져오기
+            engine = db.engine
+            
+            # Inspector로 테이블 구조 확인
+            inspector = inspect(engine)
+            
+            # uploaded_file 테이블이 있는지 확인
+            tables = inspector.get_table_names()
+            print(f"\n데이터베이스 테이블 목록 ({len(tables)}개):")
+            for table in sorted(tables):
+                print(f"  - {table}")
+            
+            if 'uploaded_file' not in tables:
+                print("\n❌ uploaded_file 테이블이 존재하지 않습니다!")
+                print("   테이블을 생성합니다...")
+                db.create_all()
+                print("✅ 테이블 생성 완료")
+                return
+            
+            # uploaded_file 테이블의 컬럼 확인
+            columns = inspector.get_columns('uploaded_file')
+            column_names = [col['name'] for col in columns]
+            
+            print(f"\n{'='*80}")
+            print(f"uploaded_file 테이블 컬럼 목록 ({len(columns)}개):")
+            print('='*80)
+            for col in columns:
+                nullable = col.get('nullable', True)
+                nullable_str = "NULL 허용" if nullable else "NOT NULL"
+                print(f"  - {col['name']}: {col['type']} ({nullable_str})")
+            
+            # tags 컬럼 확인
+            if 'tags' in column_names:
+                print(f"\n✅ tags 컬럼이 존재합니다!")
+                
+                # tags 컬럼의 상세 정보
+                tags_col = next((col for col in columns if col['name'] == 'tags'), None)
+                if tags_col:
+                    print(f"   타입: {tags_col['type']}")
+                    print(f"   Nullable: {tags_col.get('nullable', True)}")
+                
+                # 실제 데이터 확인
+                print(f"\n{'='*80}")
+                print("태그 데이터 확인:")
+                print('='*80)
+                
+                result = db.session.execute(text("SELECT COUNT(*) FROM uploaded_file"))
+                total_files = result.scalar()
+                print(f"전체 파일 수: {total_files}")
+                
+                result = db.session.execute(text("""
+                    SELECT COUNT(*) FROM uploaded_file 
+                    WHERE tags IS NOT NULL AND tags != ''
+                """))
+                files_with_tags = result.scalar()
+                print(f"태그가 있는 파일 수: {files_with_tags}")
+                
+                if files_with_tags > 0:
+                    result = db.session.execute(text("""
+                        SELECT id, original_filename, 
+                               LENGTH(tags) as tag_length,
+                               SUBSTR(tags, 1, 100) as tag_preview
+                        FROM uploaded_file 
+                        WHERE tags IS NOT NULL AND tags != ''
+                        ORDER BY id DESC
+                        LIMIT 5
+                    """))
+                    
+                    print(f"\n최근 태그가 있는 파일 (최대 5개):")
+                    for row in result:
+                        print(f"  - ID: {row[0]}, 파일명: {row[1]}")
+                        print(f"    태그 길이: {row[2]} 문자")
+                        print(f"    태그 미리보기: {row[3]}...")
+                else:
+                    print("\n⚠️  태그가 있는 파일이 없습니다.")
+                    print("   '일반 태그 생성' 또는 '상세 태그 생성'을 실행한 후 다시 확인해주세요.")
+                
+            else:
+                print(f"\n❌ tags 컬럼이 존재하지 않습니다!")
+                print("   컬럼을 추가합니다...")
+                
+                # SQLite인 경우
+                if 'sqlite' in str(engine.url):
+                    print("   SQLite 데이터베이스 감지")
+                    db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN tags TEXT"))
+                    db.session.commit()
+                    print("✅ tags 컬럼 추가 완료 (SQLite)")
+                else:
+                    # PostgreSQL, MySQL 등 다른 DB
+                    print(f"   {engine.url.drivername} 데이터베이스 감지")
+                    try:
+                        db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN tags TEXT"))
+                        db.session.commit()
+                        print("✅ tags 컬럼 추가 완료")
+                    except Exception as e:
+                        print(f"❌ 컬럼 추가 실패: {e}")
+                        db.session.rollback()
+                        raise
+                
+                # 다시 확인
+                inspector = inspect(engine)
+                columns = inspector.get_columns('uploaded_file')
+                column_names = [col['name'] for col in columns]
+                if 'tags' in column_names:
+                    print("✅ 확인: tags 컬럼이 성공적으로 추가되었습니다!")
+                else:
+                    print("❌ 경고: 컬럼 추가 후에도 확인되지 않습니다!")
+            
+            print("\n" + "="*80)
+            print("확인 완료")
+            print("="*80)
+            
+        except Exception as e:
+            print(f"\n❌ 오류 발생: {e}")
+            import traceback
+            traceback.print_exc()
+            db.session.rollback()
+            sys.exit(1)
+
+if __name__ == '__main__':
+    print("="*80)
+    print("uploaded_file 테이블 tags 컬럼 확인 및 수정")
+    print("="*80)
+    check_and_fix_tags_column()
+

migrate_add_tags_column.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+uploaded_file 테이블에 tags 컬럼 추가 마이그레이션 스크립트
+실서버에서 실행하여 tags 컬럼이 없으면 추가합니다.
+"""
+import sys
+import os
+from pathlib import Path
+
+# 프로젝트 루트를 Python 경로에 추가
+project_root = Path(__file__).parent
+sys.path.insert(0, str(project_root))
+
+from app import create_app
+from app.database import db
+from sqlalchemy import inspect, text
+
+def migrate_add_tags_column():
+    """uploaded_file 테이블에 tags 컬럼 추가"""
+    app = create_app()
+    
+    with app.app_context():
+        try:
+            print("="*80)
+            print("uploaded_file 테이블 tags 컬럼 마이그레이션")
+            print("="*80)
+            
+            # DB 엔진 가져오기
+            engine = db.engine
+            print(f"\n데이터베이스: {engine.url}")
+            
+            # Inspector로 테이블 구조 확인
+            inspector = inspect(engine)
+            
+            # uploaded_file 테이블이 있는지 확인
+            tables = inspector.get_table_names()
+            if 'uploaded_file' not in tables:
+                print("❌ uploaded_file 테이블이 존재하지 않습니다!")
+                print("   먼저 애플리케이션을 실행하여 테이블을 생성하세요.")
+                return False
+            
+            # uploaded_file 테이블의 컬럼 확인
+            columns = inspector.get_columns('uploaded_file')
+            column_names = [col['name'] for col in columns]
+            
+            print(f"\n현재 컬럼 목록: {', '.join(column_names)}")
+            
+            # tags 컬럼 확인
+            if 'tags' in column_names:
+                print("\n✅ tags 컬럼이 이미 존재합니다!")
+                print("   마이그레이션이 필요하지 않습니다.")
+                return True
+            
+            # tags 컬럼 추가
+            print("\n⚠️  tags 컬럼이 없습니다. 추가합니다...")
+            
+            # SQLite인 경우
+            if 'sqlite' in str(engine.url):
+                print("   SQLite 데이터베이스 감지")
+                db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN tags TEXT"))
+                db.session.commit()
+                print("✅ tags 컬럼 추가 완료 (SQLite)")
+            else:
+                # PostgreSQL, MySQL 등 다른 DB
+                db_type = engine.url.drivername
+                print(f"   {db_type} 데이터베이스 감지")
+                try:
+                    if 'postgresql' in db_type or 'postgres' in db_type:
+                        # PostgreSQL
+                        db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN IF NOT EXISTS tags TEXT"))
+                    elif 'mysql' in db_type:
+                        # MySQL
+                        db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN tags TEXT"))
+                    else:
+                        # 기타
+                        db.session.execute(text("ALTER TABLE uploaded_file ADD COLUMN tags TEXT"))
+                    
+                    db.session.commit()
+                    print("✅ tags 컬럼 추가 완료")
+                except Exception as e:
+                    print(f"❌ 컬럼 추가 실패: {e}")
+                    db.session.rollback()
+                    import traceback
+                    traceback.print_exc()
+                    return False
+            
+            # 다시 확인
+            inspector = inspect(engine)
+            columns = inspector.get_columns('uploaded_file')
+            column_names = [col['name'] for col in columns]
+            
+            if 'tags' in column_names:
+                print("\n✅ 확인: tags 컬럼이 성공적으로 추가되었습니다!")
+                print("   이제 '일반 태그 생성'과 '상세 태그 생성' 기능을 사용할 수 있습니다.")
+                return True
+            else:
+                print("\n❌ 경고: 컬럼 추가 후에도 확인되지 않습니다!")
+                return False
+            
+        except Exception as e:
+            print(f"\n❌ 오류 발생: {e}")
+            import traceback
+            traceback.print_exc()
+            db.session.rollback()
+            return False
+
+if __name__ == '__main__':
+    success = migrate_add_tags_column()
+    sys.exit(0 if success else 1)
+

태그_생성_DB_저장_문제_해결.md

@@ -0,0 +1,140 @@
+# 태그 생성 DB 저장 문제 해결 가이드
+
+## 문제 상황
+실서버에서 '일반 태그 생성'과 '상세 태그 생성'을 실행했는데 결과 값이 DB에 저장되지 않는 문제
+
+## 원인 분석
+가장 가능성 높은 원인: **`uploaded_file` 테이블에 `tags` 컬럼이 없음**
+
+## 해결 방법
+
+### 1단계: DB 스키마 확인
+
+실서버에서 다음 스크립트를 실행하여 `tags` 컬럼 존재 여부를 확인합니다:
+
+```bash
+python check_tags_table_schema.py
+```
+
+또는 가상환경 사용 시:
+```bash
+.\venv\Scripts\python.exe check_tags_table_schema.py
+```
+
+### 2단계: tags 컬럼 추가 (필요한 경우)
+
+`tags` 컬럼이 없다면 다음 마이그레이션 스크립트를 실행합니다:
+
+```bash
+python migrate_add_tags_column.py
+```
+
+또는 가상환경 사용 시:
+```bash
+.\venv\Scripts\python.exe migrate_add_tags_column.py
+```
+
+### 3단계: 확인
+
+마이그레이션 후 다시 확인:
+
+```bash
+python check_tags_table_schema.py
+```
+
+`tags` 컬럼이 추가되었는지 확인하고, 태그 생성 기능을 다시 테스트합니다.
+
+## 추가 확인 사항
+
+### 1. 서버 로그 확인
+태그 생성 실행 시 서버 로그에서 다음 메시지를 확인하세요:
+
+- `[일반 태그 생성] DB 저장 성공` 또는 `[상세 태그 생성] DB 저장 성공`
+- `[일반 태그 생성] 경고: DB 저장 후 태그가 None입니다!` (이 메시지가 나오면 문제 있음)
+
+### 2. DB 직접 확인
+실서버 DB에 직접 접속하여 확인:
+
+```sql
+-- 컬럼 확인
+PRAGMA table_info(uploaded_file);  -- SQLite
+-- 또는
+SELECT column_name, data_type 
+FROM information_schema.columns 
+WHERE table_name = 'uploaded_file';  -- PostgreSQL
+
+-- 태그 데이터 확인
+SELECT id, original_filename, 
+       CASE WHEN tags IS NULL THEN 'NULL' 
+            WHEN tags = '' THEN 'EMPTY' 
+            ELSE 'HAS DATA' END as tag_status,
+       LENGTH(tags) as tag_length
+FROM uploaded_file
+ORDER BY id DESC
+LIMIT 10;
+```
+
+### 3. 코드 확인
+태그 생성 함수는 다음 위치에 있습니다:
+- 일반 태그: `app/routes.py` - `generate_simple_tags()` 함수 (라인 5301)
+- 상세 태그: `app/routes.py` - `generate_detailed_tags()` 함수 (라인 4952)
+
+저장 로직:
+```python
+tags_json_str = json.dumps(tags_data_with_type, ensure_ascii=False)
+file.tags = tags_json_str
+db.session.commit()
+db.session.refresh(file)
+```
+
+## 예상되는 문제와 해결책
+
+### 문제 1: tags 컬럼이 없음
+**증상**: 태그 생성은 성공하지만 DB에 저장되지 않음
+**해결**: `migrate_add_tags_column.py` 실행
+
+### 문제 2: DB 연결 문제
+**증상**: 태그 생성 시 에러 발생
+**해결**: DB 연결 설정 확인 (`.env` 파일의 `DATABASE_URL`)
+
+### 문제 3: 트랜잭션 롤백
+**증상**: 저장은 되지만 바로 사라짐
+**해결**: 서버 로그에서 에러 메시지 확인, `db.session.rollback()` 호출 여부 확인
+
+### 문제 4: JSON 파싱 실패
+**증상**: AI 응답은 받았지만 저장 실패
+**해결**: 서버 로그에서 JSON 파싱 에러 확인, AI 모델 응답 형식 확인
+
+## 실서버에서 실행 방법
+
+### SSH 접속 후
+```bash
+# 프로젝트 디렉토리로 이동
+cd /path/to/project
+
+# 가상환경 활성화 (있는 경우)
+source venv/bin/activate  # Linux/Mac
+# 또는
+.\venv\Scripts\activate  # Windows
+
+# 스크립트 실행
+python check_tags_table_schema.py
+python migrate_add_tags_column.py
+```
+
+### Docker 환경인 경우
+```bash
+# 컨테이너 접속
+docker exec -it <container_name> bash
+
+# 스크립트 실행
+python check_tags_table_schema.py
+python migrate_add_tags_column.py
+```
+
+## 참고 파일
+- `check_tags_table_schema.py`: DB 스키마 확인 스크립트
+- `migrate_add_tags_column.py`: tags 컬럼 추가 마이그레이션
+- `app/routes.py`: 태그 생성 함수 (라인 4952, 5301)
+- `app/database.py`: UploadedFile 모델 정의 (라인 39-72)
+