feat: NAS(Synology) 배포 도구 및 마이그레이션 추가

- deploy/ 폴더: docker-compose.synology.yml, deploy.sh, package.sh
- NAS 배포 패키지 생성/전송/설치 자동화 스크립트
- 삭제 로그 테이블 마이그레이션 (018_add_deletion_log_table.sql)
- 사진 필드 마이그레이션 유틸리티 (migrate_add_photo_fields.py)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/main.py

@@ -60,9 +60,15 @@ async def health_check():
 # 전역 예외 처리
 @app.exception_handler(Exception)
 async def global_exception_handler(request: Request, exc: Exception):
+    # CORS 헤더 추가 (500 에러에서도 CORS 헤더가 필요)
     return JSONResponse(
         status_code=500,
-        content={"detail": f"Internal server error: {str(exc)}"}
+        content={"detail": f"Internal server error: {str(exc)}"},
+        headers={
+            "Access-Control-Allow-Origin": "*",
+            "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS",
+            "Access-Control-Allow-Headers": "*"
+        }
     )
 
 if __name__ == "__main__":

backend/migrate_add_photo_fields.py

@@ -0,0 +1,41 @@
+"""
+데이터베이스 마이그레이션: 사진 필드 추가
+- 신고 사진 3, 4, 5 추가
+- 완료 사진 2, 3, 4, 5 추가
+"""
+from sqlalchemy import create_engine, text
+import os
+
+# 데이터베이스 URL
+DATABASE_URL = os.getenv("DATABASE_URL", "postgresql://postgres:postgres@db:5432/issue_tracker")
+
+def run_migration():
+    engine = create_engine(DATABASE_URL)
+
+    with engine.connect() as conn:
+        print("마이그레이션 시작...")
+
+        try:
+            # 신고 사진 필드 추가
+            print("신고 사진 필드 추가 중...")
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS photo_path3 VARCHAR"))
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS photo_path4 VARCHAR"))
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS photo_path5 VARCHAR"))
+
+            # 완료 사진 필드 추가
+            print("완료 사진 필드 추가 중...")
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS completion_photo_path2 VARCHAR(500)"))
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS completion_photo_path3 VARCHAR(500)"))
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS completion_photo_path4 VARCHAR(500)"))
+            conn.execute(text("ALTER TABLE issues ADD COLUMN IF NOT EXISTS completion_photo_path5 VARCHAR(500)"))
+
+            conn.commit()
+            print("✅ 마이그레이션 완료!")
+
+        except Exception as e:
+            conn.rollback()
+            print(f"❌ 마이그레이션 실패: {e}")
+            raise
+
+if __name__ == "__main__":
+    run_migration()

backend/migrations/018_add_deletion_log_table.sql

@@ -0,0 +1,28 @@
+-- 삭제 로그 테이블 추가
+-- 생성일: 2025-11-08
+-- 설명: 부적합 등 엔티티 삭제 시 로그를 보관하기 위한 테이블
+
+CREATE TABLE IF NOT EXISTS deletion_logs (
+    id SERIAL PRIMARY KEY,
+    entity_type VARCHAR(50) NOT NULL,
+    entity_id INTEGER NOT NULL,
+    entity_data JSONB NOT NULL,
+    deleted_by_id INTEGER NOT NULL REFERENCES users(id),
+    deleted_at TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT (NOW() AT TIME ZONE 'Asia/Seoul'),
+    reason TEXT
+);
+
+-- 인덱스 추가
+CREATE INDEX IF NOT EXISTS idx_deletion_logs_entity_type ON deletion_logs(entity_type);
+CREATE INDEX IF NOT EXISTS idx_deletion_logs_entity_id ON deletion_logs(entity_id);
+CREATE INDEX IF NOT EXISTS idx_deletion_logs_deleted_by ON deletion_logs(deleted_by_id);
+CREATE INDEX IF NOT EXISTS idx_deletion_logs_deleted_at ON deletion_logs(deleted_at);
+
+-- 테이블 코멘트
+COMMENT ON TABLE deletion_logs IS '엔티티 삭제 로그 - 삭제된 데이터의 백업 및 추적';
+COMMENT ON COLUMN deletion_logs.entity_type IS '삭제된 엔티티 타입 (issue, project, daily_work 등)';
+COMMENT ON COLUMN deletion_logs.entity_id IS '삭제된 엔티티의 ID';
+COMMENT ON COLUMN deletion_logs.entity_data IS '삭제 시점의 엔티티 전체 데이터 (JSON)';
+COMMENT ON COLUMN deletion_logs.deleted_by_id IS '삭제 실행자 ID';
+COMMENT ON COLUMN deletion_logs.deleted_at IS '삭제 시각 (KST)';
+COMMENT ON COLUMN deletion_logs.reason IS '삭제 사유 (선택사항)';

backend/routers/reports.py

@@ -145,10 +145,6 @@ async def preview_daily_report(
 ):
     """일일보고서 미리보기 - 추출될 항목 목록"""
 
-    # 권한 확인
-    if current_user.role != UserRole.admin:
-        raise HTTPException(status_code=403, detail="품질팀만 접근 가능합니다")
-
     # 프로젝트 확인
     project = db.query(Project).filter(Project.id == project_id).first()
     if not project:
@@ -169,7 +165,7 @@ async def preview_daily_report(
     issues = issues_query.all()
 
     # 정렬: 지연 -> 진행중 -> 완료됨 순으로, 같은 상태 내에서는 신고일 최신순
-    issues = sorted(issues, key=lambda x: (get_issue_priority(x), -x.report_date.timestamp() if x.report_date else 0))
+    issues = sorted(issues, key=lambda x: (get_issue_priority(x), -get_timestamp(x.report_date)))
 
     # 통계 계산
     stats = calculate_project_stats(issues)
@@ -190,11 +186,7 @@ async def export_daily_report(
     current_user: User = Depends(get_current_user),
     db: Session = Depends(get_db)
 ):
-    """품질팀용 일일보고서 엑셀 내보내기"""
-    
-    # 권한 확인 (품질팀만 접근 가능)
-    if current_user.role != UserRole.admin:
-        raise HTTPException(status_code=403, detail="품질팀만 접근 가능합니다")
+    """일일보고서 엑셀 내보내기"""
     
     # 프로젝트 확인
     project = db.query(Project).filter(Project.id == request.project_id).first()
@@ -223,8 +215,18 @@ async def export_daily_report(
             not_exported_after_completion.append(issue)
         elif issue.actual_completion_date:
             # actual_completion_date가 있는 경우: 완료일과 마지막 추출일 비교
-            completion_date = issue.actual_completion_date.replace(tzinfo=None) if issue.actual_completion_date.tzinfo else issue.actual_completion_date
-            export_date = issue.last_exported_at.replace(tzinfo=None) if issue.last_exported_at.tzinfo else issue.last_exported_at
+            # actual_completion_date는 date 또는 datetime일 수 있음
+            if isinstance(issue.actual_completion_date, datetime):
+                completion_date = issue.actual_completion_date.replace(tzinfo=None) if issue.actual_completion_date.tzinfo else issue.actual_completion_date
+            else:
+                # date 타입인 경우 datetime으로 변환
+                completion_date = datetime.combine(issue.actual_completion_date, datetime.min.time())
+
+            if isinstance(issue.last_exported_at, datetime):
+                export_date = issue.last_exported_at.replace(tzinfo=None) if issue.last_exported_at.tzinfo else issue.last_exported_at
+            else:
+                export_date = datetime.combine(issue.last_exported_at, datetime.min.time())
+
             if completion_date > export_date:
                 # 완료일이 마지막 추출일보다 나중 -> 완료 후 아직 추출 안됨 -> 진행 중 시트에 표시
                 not_exported_after_completion.append(issue)
@@ -236,14 +238,14 @@ async def export_daily_report(
     in_progress_issues = in_progress_only + not_exported_after_completion
 
     # 진행 중 시트 정렬: 지연중 -> 진행중 -> 완료됨 순서
-    in_progress_issues = sorted(in_progress_issues, key=lambda x: (get_issue_priority(x), -x.report_date.timestamp() if x.report_date else 0))
+    in_progress_issues = sorted(in_progress_issues, key=lambda x: (get_issue_priority(x), -get_timestamp(x.report_date)))
 
     # "완료됨" 시트용: 완료 항목 중 "완료 후 추출된 것"만 (진행 중 시트에 표시되는 것 제외)
     not_exported_ids = {issue.id for issue in not_exported_after_completion}
     completed_issues = [issue for issue in all_completed if issue.id not in not_exported_ids]
 
     # 완료됨 시트도 정렬 (완료일 최신순)
-    completed_issues = sorted(completed_issues, key=lambda x: -x.actual_completion_date.timestamp() if x.actual_completion_date else 0)
+    completed_issues = sorted(completed_issues, key=lambda x: -get_timestamp(x.actual_completion_date))
 
     # 웹과 동일한 로직: 진행중 + 완료를 함께 정렬하여 순번 할당
     # (웹에서는 in_progress와 completed를 함께 가져와서 전체를 reviewed_at 순으로 정렬 후 순번 매김)
@@ -871,3 +873,12 @@ def get_issue_status_header_color(issue: Issue) -> str:
     elif priority == 3:  # 완료
         return "92D050"  # 진한 초록색
     return "4472C4"  # 기본 파란색
+
+def get_timestamp(dt) -> float:
+    """date 또는 datetime 객체에서 timestamp 반환"""
+    if dt is None:
+        return 0
+    if isinstance(dt, datetime):
+        return dt.timestamp()
+    # date 타입인 경우 datetime으로 변환
+    return datetime.combine(dt, datetime.min.time()).timestamp()

deploy/deploy.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+# =============================================================================
+# M-Project Synology NAS 배포 스크립트
+# =============================================================================
+
+set -e
+
+echo "=========================================="
+echo "M-Project (부적합관리) 배포 시작"
+echo "=========================================="
+
+# 1. 환경 변수 파일 확인
+if [ ! -f .env ]; then
+    echo "❌ .env 파일이 없습니다."
+    echo "   .env.synology 파일을 복사하고 값을 수정하세요:"
+    echo "   cp .env.synology .env"
+    exit 1
+fi
+
+# 비밀번호 미설정 확인
+if grep -q "변경필수" .env; then
+    echo "❌ .env 파일에 기본값이 남아있습니다."
+    echo "   모든 '변경필수' 항목을 실제 값으로 수정하세요."
+    exit 1
+fi
+
+# 2. Docker 이미지 빌드
+echo ""
+echo "🔨 Docker 이미지 빌드 중..."
+docker-compose -f docker-compose.synology.yml build --no-cache
+
+# 3. 기존 컨테이너 중지
+echo ""
+echo "🛑 기존 컨테이너 중지 중..."
+docker-compose -f docker-compose.synology.yml down 2>/dev/null || true
+
+# 4. 컨테이너 시작
+echo ""
+echo "🚀 컨테이너 시작 중..."
+docker-compose -f docker-compose.synology.yml up -d
+
+# 5. DB 초기화 대기
+echo ""
+echo "⏳ 데이터베이스 초기화 대기 중 (15초)..."
+sleep 15
+
+# 6. DB 마이그레이션 실행
+echo ""
+echo "📦 DB 마이그레이션 실행 중..."
+for sql_file in ./init-db/*.sql; do
+    if [ -f "$sql_file" ]; then
+        echo "  실행: $(basename "$sql_file")"
+        docker exec -i m-project-db psql -U "${POSTGRES_USER:-mproject}" "${POSTGRES_DB:-mproject}" < "$sql_file" 2>/dev/null || true
+    fi
+done
+
+# 7. 데이터베이스 복원 (백업 파일이 있는 경우)
+BACKUP_FILE=$(ls -t backup_*.sql 2>/dev/null | head -1)
+if [ -n "$BACKUP_FILE" ]; then
+    echo ""
+    read -p "📦 DB 백업 발견: $BACKUP_FILE - 복원하시겠습니까? (y/N) " -n 1 -r
+    echo ""
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        echo "📦 데이터베이스 복원 중..."
+        docker exec -i m-project-db psql -U "${POSTGRES_USER:-mproject}" "${POSTGRES_DB:-mproject}" < "$BACKUP_FILE"
+        echo "✅ 데이터베이스 복원 완료"
+    fi
+fi
+
+# 8. 상태 확인
+echo ""
+echo "=========================================="
+echo "📊 컨테이너 상태"
+echo "=========================================="
+docker-compose -f docker-compose.synology.yml ps
+
+# 9. 헬스체크
+echo ""
+echo "🔍 서비스 확인 중..."
+sleep 5
+
+check_service() {
+    local name="$1"
+    local url="$2"
+    printf "  %-20s " "$name"
+    status=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 3 "$url" 2>/dev/null || echo "000")
+    if [ "$status" -ge 200 ] && [ "$status" -lt 400 ]; then
+        echo "✅ OK ($status)"
+    else
+        echo "❌ FAIL ($status)"
+    fi
+}
+
+check_service "Backend API" "http://localhost:16000/api/health"
+check_service "Frontend" "http://localhost:16080/"
+
+echo ""
+echo "=========================================="
+echo "✅ 배포 완료!"
+echo "=========================================="
+echo ""
+echo "접속 URL:"
+echo "  - 웹 UI:    http://NAS_IP:16080"
+echo "  - API:      http://NAS_IP:16000"
+echo "  - DB:       NAS_IP:16432 (PostgreSQL)"
+echo ""

deploy/docker-compose.synology.yml

@@ -0,0 +1,80 @@
+version: '3.8'
+
+services:
+  # PostgreSQL 데이터베이스
+  db:
+    image: postgres:15-alpine
+    container_name: m-project-db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-mproject}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: ${POSTGRES_DB:-mproject}
+      TZ: Asia/Seoul
+      PGTZ: Asia/Seoul
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./init-db:/docker-entrypoint-initdb.d
+    ports:
+      - "16432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-mproject}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - m-project-network
+
+  # FastAPI 백엔드
+  backend:
+    build: ./backend
+    container_name: m-project-backend
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgresql://${POSTGRES_USER:-mproject}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB:-mproject}
+      SECRET_KEY: ${SECRET_KEY}
+      ALGORITHM: HS256
+      ACCESS_TOKEN_EXPIRE_MINUTES: 10080
+      ADMIN_USERNAME: ${ADMIN_USERNAME:-hyungi}
+      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
+      TZ: Asia/Seoul
+    volumes:
+      - uploads:/app/uploads
+    ports:
+      - "16000:8000"
+    depends_on:
+      db:
+        condition: service_healthy
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+    networks:
+      - m-project-network
+
+  # Nginx 프론트엔드
+  nginx:
+    build: ./nginx
+    container_name: m-project-nginx
+    restart: unless-stopped
+    ports:
+      - "16080:80"
+    volumes:
+      - ./frontend:/usr/share/nginx/html:ro
+      - uploads:/app/uploads
+    depends_on:
+      - backend
+    networks:
+      - m-project-network
+
+volumes:
+  postgres_data:
+    driver: local
+  uploads:
+    driver: local
+
+networks:
+  m-project-network:
+    driver: bridge
+    name: m-project-network

deploy/package.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+# =============================================================================
+# M-Project 배포 패키지 생성 스크립트
+# =============================================================================
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+DEPLOY_DIR="$SCRIPT_DIR"
+PACKAGE_DIR="$DEPLOY_DIR/mproject-package"
+
+echo "=========================================="
+echo "M-Project 배포 패키지 생성"
+echo "=========================================="
+
+# 기존 패키지 삭제
+rm -rf "$PACKAGE_DIR"
+mkdir -p "$PACKAGE_DIR"
+
+# 1. Docker 설정 파일
+echo "📦 Docker 설정 복사..."
+cp "$DEPLOY_DIR/docker-compose.synology.yml" "$PACKAGE_DIR/docker-compose.yml"
+cp "$DEPLOY_DIR/.env.synology" "$PACKAGE_DIR/.env.example"
+cp "$DEPLOY_DIR/deploy.sh" "$PACKAGE_DIR/"
+chmod +x "$PACKAGE_DIR/deploy.sh"
+
+# 2. 데이터베이스 백업 생성
+echo "📦 DB 백업 시도..."
+if docker exec m-project-db pg_dump -U mproject mproject > "$PACKAGE_DIR/backup_$(date +%Y%m%d_%H%M%S).sql" 2>/dev/null; then
+    echo "  ✅ DB 백업 완료"
+else
+    echo "  ⚠️ DB 백업 건너뜀 (컨테이너 미실행)"
+    rm -f "$PACKAGE_DIR"/backup_*.sql
+fi
+
+# 3. 소스 코드 복사
+echo "📦 소스 코드 복사..."
+
+# Backend
+mkdir -p "$PACKAGE_DIR/backend"
+rsync -a --exclude='__pycache__' --exclude='.git' --exclude='venv' --exclude='*.pyc' \
+    "$PROJECT_DIR/backend/" "$PACKAGE_DIR/backend/"
+
+# Frontend
+mkdir -p "$PACKAGE_DIR/frontend"
+rsync -a --exclude='.git' --exclude='uploads' \
+    "$PROJECT_DIR/frontend/" "$PACKAGE_DIR/frontend/"
+
+# Nginx
+mkdir -p "$PACKAGE_DIR/nginx"
+rsync -a "$PROJECT_DIR/nginx/" "$PACKAGE_DIR/nginx/"
+
+# 4. init-db 폴더 (마이그레이션 스크립트)
+mkdir -p "$PACKAGE_DIR/init-db"
+if [ -d "$PROJECT_DIR/backend/migrations" ]; then
+    cp "$PROJECT_DIR/backend/migrations"/*.sql "$PACKAGE_DIR/init-db/" 2>/dev/null || true
+fi
+
+# 5. 압축
+echo "📦 압축 중..."
+cd "$DEPLOY_DIR"
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+tar -czf "mproject-deploy-$TIMESTAMP.tar.gz" -C "$DEPLOY_DIR" mproject-package
+
+# 크기 확인
+echo ""
+echo "=========================================="
+echo "✅ 패키지 생성 완료!"
+echo "=========================================="
+ls -lh "$DEPLOY_DIR/mproject-deploy-$TIMESTAMP.tar.gz"
+echo ""
+echo "파일: $DEPLOY_DIR/mproject-deploy-$TIMESTAMP.tar.gz"
+echo ""
+echo "Synology NAS로 전송:"
+echo "  scp $DEPLOY_DIR/mproject-deploy-$TIMESTAMP.tar.gz admin@NAS_IP:/volume1/docker/"
+echo ""
+echo "NAS에서 설치:"
+echo "  cd /volume1/docker/"
+echo "  tar -xzf mproject-deploy-$TIMESTAMP.tar.gz"
+echo "  cd mproject-package"
+echo "  cp .env.example .env && vi .env"
+echo "  bash deploy.sh"
+echo ""

frontend/issues-management.html

@@ -172,13 +172,14 @@
         }
         
         .collapse-content {
-            max-height: 1000px;
-            overflow: hidden;
+            max-height: none;
+            overflow: visible;
             transition: max-height 0.3s ease-out;
         }
         
         .collapse-content.collapsed {
             max-height: 0;
+            overflow: hidden;
         }
         
         /* 진행 중 카드 스타일 */
@@ -486,6 +487,13 @@
                 // ManagementAPI 사용
                 const managementIssues = await ManagementAPI.getAll();
                 
+                console.log('🔍 관리함 이슈 로드 완료:', managementIssues.length, '개');
+                console.log('📊 상태별 분포:', {
+                    in_progress: managementIssues.filter(i => i.review_status === 'in_progress').length,
+                    completed: managementIssues.filter(i => i.review_status === 'completed').length,
+                    other: managementIssues.filter(i => !['in_progress', 'completed'].includes(i.review_status)).length
+                });
+                
                 // 수신함에서 넘어온 순서대로 No. 재할당 (reviewed_at 기준)
                 managementIssues.sort((a, b) => new Date(a.reviewed_at) - new Date(b.reviewed_at));
                 
@@ -567,9 +575,22 @@
             function filterIssues() {
                 const projectFilter = document.getElementById('projectFilter').value;
 
+                console.log('🔍 필터링 시작:', {
+                    currentTab: currentTab,
+                    projectFilter: projectFilter,
+                    totalIssues: issues.length
+                });
+
                 filteredIssues = issues.filter(issue => {
                     // 현재 탭에 따른 상태 필터링
-                    if (issue.review_status !== currentTab) return false;
+                    let statusMatch = false;
+                    if (currentTab === 'in_progress') {
+                        statusMatch = issue.review_status === 'in_progress';
+                    } else if (currentTab === 'completed') {
+                        statusMatch = issue.review_status === 'completed';
+                    }
+                    
+                    if (!statusMatch) return false;
                     
                     // 프로젝트 필터링
                     if (projectFilter && issue.project_id != projectFilter) return false;
@@ -577,6 +598,11 @@
                     return true;
                 });
 
+                console.log('✅ 필터링 결과:', {
+                    filteredCount: filteredIssues.length,
+                    tab: currentTab
+                });
+
                 sortIssues();
                 displayIssues();
                 updateStatistics(); // 통계 업데이트 추가
@@ -633,6 +659,8 @@
                 const issues = groupedByDate[date];
                 const groupId = `group-${date.replace(/\./g, '-')}`;
                 
+                console.log(`📅 날짜 그룹 [${date}]: ${issues.length}개 이슈`);
+                
                 return `
                     <div class="date-group">
                         <div class="date-header flex items-center justify-between p-3 bg-gray-50 rounded-lg" 
@@ -657,6 +685,18 @@
             }).join('');
 
             container.innerHTML = dateGroups;
+            
+            // 모든 날짜 그룹을 기본적으로 펼쳐진 상태로 초기화
+            Object.keys(groupedByDate).forEach(date => {
+                const groupId = `group-${date.replace(/\./g, '-')}`;
+                const content = document.getElementById(groupId);
+                const icon = document.getElementById(`icon-${groupId}`);
+                
+                if (content && icon) {
+                    content.classList.remove('collapsed');
+                    icon.style.transform = 'rotate(0deg)';
+                }
+            });
         }
 
         // 이슈 행 생성 함수