- Frontend: 하드코딩된 localhost API URL을 동적 URL 생성으로 변경
- reports-daily.html: 3곳 수정 (프로젝트 로드, 미리보기, 보고서 생성)
- issues-archive.html: 프로젝트 로드 함수 수정
- issues-dashboard.html: 2곳 수정 (프로젝트 로드, 진행중 이슈 로드)
- issues-inbox.html: 프로젝트 로드 함수 수정
- daily-work.html: 프로젝트 로드 함수 수정
- permissions.js: 2곳 수정 (권한 부여, 사용자 권한 조회)
- Backup System: 완전한 백업/복구 시스템 구축
- backup_script.sh: 자동 백업 스크립트 (DB, 볼륨, 설정 파일)
- restore_script.sh: 백업 복구 스크립트
- setup_auto_backup.sh: 자동 백업 스케줄 설정 (매일 오후 9시)
- 백업 정책: 최신 10개 버전만 유지하여 용량 절약
- Migration: 5장 사진 지원 마이그레이션 파일 업데이트
이제 Cloudflare 환경(m.hyungi.net)에서 HTTPS 프로토콜로 API 호출하여
Mixed Content 오류 없이 모든 기능이 정상 작동합니다.
- photo_path3, photo_path4, photo_path5 컬럼 추가
- completion_photo_path2~5 컬럼 추가
- completion_rejected_at, completion_rejected_by_id, completion_rejection_reason 컬럼 추가
- last_exported_at, export_count 컬럼 추가
- 021_add_5_photo_support.sql 마이그레이션 생성
- 백엔드 재시작으로 새로운 스키마 적용 완료
✨ 새로운 기능:
- iPhone HEIC 사진 업로드 지원 (pillow-heif 라이브러리 추가)
- 완료 사진 업로드/교체 기능
- 완료 코멘트 수정 기능
- 통합 이슈 수정 모달 (진행 중/완료 대기 공통)
🔧 기술적 개선:
- HEIC 파일 자동 감지 및 원본 저장
- Base64 이미지 처리 로직 강화
- 상세한 디버깅 로그 추가
- 프론트엔드 파일 정보 로깅
📝 문서화:
- 배포 가이드 (DEPLOYMENT_GUIDE_20251026.md) 추가
- DB 변경사항 로그 업데이트
- 마이그레이션 스크립트 (020_add_management_completion_fields.sql)
🐛 버그 수정:
- loadManagementData -> initializeManagement 함수명 통일
- 모달 저장 후 즉시 닫히는 문제 해결
- 422 Unprocessable Entity 오류 해결
🎯 진행 상태 4단계 세분화:
- 진행 중 (파란색): 일반적인 진행 상태
- 긴급 (주황색): 마감 3일 이내
- 지연됨 (빨간색): 마감시간 초과
- 완료 대기 (보라색): 완료 신청 후 승인 대기
🔧 상태 판별 로직:
- 마감시간 기준 자동 상태 변경
- completion_requested_at 필드로 완료 대기 상태 판별
- 각 상태별 고유 색상, 아이콘, 텍스트
📱 완료 신청 기능:
- 마감시간 카드 우하단에 '완료신청' 버튼
- 완료 사진 업로드 (필수, 5MB 제한)
- 완료 코멘트 입력 (선택사항)
- 실시간 이미지 미리보기
🗄️ DB 구조 확장:
- completion_requested_at: 완료 신청 시간
- completion_requested_by_id: 신청자 ID
- completion_photo_path: 완료 사진 경로
- completion_comment: 완료 코멘트
🎨 UI/UX 개선:
- 상태별 그라데이션 배경색
- 애니메이션 아이콘 (톱니바퀴, 경고, 시계 등)
- 드래그 앤 드롭 사진 업로드
- 모달 기반 완료 신청 폼
💡 워크플로우:
1. 담당자가 작업 완료 후 '완료신청' 클릭
2. 완료 사진과 코멘트 업로드
3. 상태가 '완료 대기'로 변경
4. 관리자 승인 후 '완료됨'으로 최종 처리
🔐 보안 및 검증:
- 이미지 파일 타입 검증
- 파일 크기 제한 (5MB)
- Base64 인코딩으로 안전한 전송
- 사용자 인증 및 권한 확인
Expected Result:
✅ 진행 상황을 한눈에 파악 가능한 색상 코딩
✅ 마감 관리 자동화 (긴급/지연 상태)
✅ 완료 신청 프로세스로 품질 관리 강화
✅ 직관적인 UI로 사용자 경험 향상
🎯 관리함 진행중 페이지 추가 정보 입력 시스템:
📊 DB 구조 확장:
- responsible_person_detail: 해당자 상세 정보 (VARCHAR 200)
- cause_detail: 원인 상세 정보 (TEXT)
- additional_info_updated_at: 추가 정보 입력 시간
- additional_info_updated_by_id: 추가 정보 입력자 ID
- 018_add_additional_info_fields.sql 마이그레이션 실행 완료
🔧 백엔드 API:
- /api/management/{issue_id}/additional-info (PUT): 추가 정보 업데이트
- /api/management/{issue_id}/additional-info (GET): 추가 정보 조회
- AdditionalInfoUpdateRequest 스키마 추가
- management.py 라우터 생성 및 등록
🎨 프론트엔드 UI:
- 진행중 탭 상단에 '추가 정보 입력' 버튼 추가
- 완료됨 탭에서는 버튼 자동 숨김
- 세련된 모달 디자인 (오렌지 테마)
- 원인부서 드롭다운 (생산/품질/구매/설계/영업)
- 해당자 상세 입력 필드
- 원인 상세 텍스트 영역
💡 핵심 특징:
- 모든 필드 선택사항 (NULL 허용)
- 기록용 정보로 외부 노출 없음
- 기존 데이터 자동 로드 및 수정 가능
- 입력 시간/입력자 자동 추적
- 진행중 상태 이슈만 대상
🔐 권한 관리:
- issues_management 페이지 권한 필요
- 진행중 상태 이슈만 수정 가능
- 사용자별 입력 이력 추적
🎯 사용 시나리오:
1. 관리함 > 진행중 탭 접근
2. '추가 정보 입력' 버튼 클릭
3. 원인부서, 해당자, 원인상세 입력
4. 저장 후 내부 기록으로 보관
Expected Result:
✅ 관리함에서 상세한 원인 정보 기록 가능
✅ 체계적인 이슈 추적 및 분석 기반 마련
✅ 선택적 정보 입력으로 유연한 운영
✅ 깔끔한 UI로 사용자 경험 향상
🎯 핵심 개선사항:
- 수신함에서 진행중/완료로 상태 변경시 project_sequence_no 자동 할당
- 프로젝트별로 1부터 시작하는 깔끔한 순번 체계
🔧 백엔드 수정:
- inbox.py: update_issue_status에 자동 할당 로직 추가
- generate_project_sequence_no() DB 함수 활용
- 진행중/완료 상태 변경시에만 실행
📁 DB 마이그레이션:
- 017_fix_project_sequence_no.sql 생성
- 기존 데이터 보정 (누락된 순번 0개 확인)
- migration_log 테이블 구조에 맞게 로그 기록
📋 문서화:
- DB_CHANGES_LOG.md 생성 및 업데이트
- 배포 가이드, 검증 방법, 주의사항 명시
- Docker 환경 기준 실행 방법 제공
✅ 실행 완료 상태:
- 마이그레이션 성공 (2025-10-26 11:15:44+09:00)
- 백엔드 서비스 재시작 완료
- 모든 검증 항목 통과
Expected Result:
🎯 현황판에서 프로젝트별 No.1, No.2, No.3... 표시
🎯 6개월 후에도 각 프로젝트 내에서 작은 번호 유지
🎯 전체 통합 번호 대신 프로젝트별 깔끔한 순번 체계
📸 Completion Photo Upload:
- 수신함에서 '완료됨' 상태 선택 시 완료 사진 업로드 기능 추가 (1장 제한)
- Base64 인코딩으로 사진 업로드 및 미리보기 기능
- 완료 상태 변경 시 actual_completion_date 자동 설정
🗄️ Final Issue DB Structure:
- 최종 부적합 사항을 위한 포괄적인 DB 스키마 설계 및 구현
- 프로젝트별 순번 (project_sequence_no) 자동 생성 시스템
📋 New Database Fields:
- completion_photo_path: 완료 사진 경로
- solution: 해결방안 (관리함에서 입력)
- responsible_department: 담당부서 (department_type ENUM)
- responsible_person: 담당자 (VARCHAR 100)
- expected_completion_date: 조치 예상일 (DATE)
- actual_completion_date: 완료 확인일 (DATE, 자동 설정)
- cause_department: 원인부서 (department_type ENUM)
- management_comment: ISSUE에 대한 의견 (TEXT)
- final_description: 최종 내용 (수정본 또는 원본)
- final_category: 최종 카테고리 (수정본 또는 원본)
🔧 Backend Implementation:
- Issue 모델에 11개 새 필드 추가
- IssueStatusUpdateRequest에 completion_photo 필드 추가
- ManagementUpdateRequest 스키마 신규 생성
- update_issue_status API에 완료 사진 처리 로직 추가
- generate_project_sequence_no() 함수로 프로젝트별 순번 자동 생성
🎨 Frontend Implementation:
- 상태 결정 모달에 완료 사진 업로드 섹션 추가
- 완료 상태 선택 시에만 사진 업로드 UI 표시
- 파일 크기 제한 (5MB), 이미지 파일 검증
- 사진 미리보기 및 Base64 변환 처리
- 완료 사진 없이 완료 처리 시 확인 다이얼로그
🚀 User Experience:
- 직관적인 완료 사진 업로드 워크플로우
- 실시간 사진 미리보기로 업로드 확인 가능
- 완료 처리 시 자동으로 완료 확인일 기록
- 프로젝트별 순번으로 체계적인 이슈 관리
🔍 Database Migration:
- 016_add_management_fields.sql 마이그레이션 성공적으로 실행
- 멱등성 보장 및 기존 데이터 보존
- 인덱스 최적화 (project_sequence, responsible_department, expected_completion)
- 기존 이슈들의 final_description/final_category 자동 초기화
Expected Result:
✅ 수신함에서 완료 상태 선택 시 완료 사진 업로드 가능
✅ 완료 처리 시 완료 확인일 자동 기록
✅ 프로젝트별 순번으로 체계적인 이슈 번호 관리
✅ 관리함에서 사용할 모든 필드 준비 완료
✅ 최종 부적합 사항 리포트 생성을 위한 DB 구조 완성
🔄 Duplicate Tracking System:
- 중복 신고 시 원본 이슈에 신고자 정보 자동 추가
- 신고 인지도 및 대응 속도 분석을 위한 데이터 수집
- 뒷북치는 신고자 파악 및 집계 기능
📊 Database Schema Updates:
- duplicate_of_issue_id: 중복 대상 이슈 ID (FK)
- duplicate_reporters: 중복 신고자 목록 (JSONB 배열)
- 015_add_duplicate_tracking.sql 마이그레이션 실행
- GIN 인덱스로 JSONB 검색 성능 최적화
🔧 Backend Enhancements:
- 중복 폐기 시 대상 이슈에 신고자 정보 자동 추가
- 신고자 중복 체크 로직 (동일 사용자 재추가 방지)
- /api/inbox/management-issues API 추가 (중복 선택용)
- 프로젝트별 관리함 이슈 목록 조회 지원
🎨 Frontend UI Improvements:
- 중복 선택 시 관리함 이슈 목록 표시
- 프로젝트별 필터링된 이슈 목록 제공
- 간단한 이슈 정보 표시 (제목, 카테고리, 신고자, 중복 건수)
- 직관적인 선택 UI (클릭으로 선택, 시각적 피드백)
📋 Duplicate Selection Process:
1. 폐기 사유로 '중복' 선택
2. 동일 프로젝트의 관리함 이슈 목록 자동 로드
3. 중복 대상 이슈 선택 (필수)
4. 확인 시 신고자 정보가 원본 이슈에 추가
💾 Data Structure:
- duplicate_reporters: [
{
user_id: 123,
username: 'reporter1',
full_name: '신고자1',
report_date: '2024-10-25T14:30:00',
added_at: '2024-10-25T15:00:00'
}
]
🔍 Analytics Features:
- 중복 신고 건수 표시
- 신고자별 신고 시점 추적
- 원본 이슈 대비 지연 신고 분석 가능
- 부서별/사용자별 인지도 분석 데이터 제공
🚀 User Experience:
- 중복 처리 시 명확한 안내 메시지
- 관리함 이슈 목록 실시간 로드
- 선택 필수 검증 (중복 대상 미선택 시 경고)
- 처리 완료 후 자동 목록 새로고침
Expected Result:
✅ 중복 신고 시 신고자 정보 자동 추적
✅ 신고 인지도 및 대응 속도 분석 데이터 수집
✅ 직관적인 중복 대상 선택 UI
✅ 부서별/개인별 신고 패턴 분석 기반 마련
🏢 Department Management System:
- 5개 부서 지원: 생산, 품질, 구매, 설계, 영업
- 사용자 생성/수정 시 부서 선택 가능
- 부서별 사용자 분류 및 표시
📊 Database Schema Updates:
- department_type ENUM 추가 (production, quality, purchasing, design, sales)
- users 테이블에 department 컬럼 추가
- idx_users_department 인덱스 생성 (성능 최적화)
- 014_add_user_department.sql 마이그레이션 실행
🔧 Backend Enhancements:
- DepartmentType ENUM 클래스 추가 (models.py, schemas.py)
- User 모델에 department 필드 추가
- UserBase, UserUpdate 스키마에 department 필드 포함
- 기존 API 엔드포인트 자동 호환
🎨 Frontend UI Improvements:
- 사용자 추가 폼에 부서 선택 드롭다운 추가
- 사용자 목록에 부서 정보 배지 표시 (녹색 배경)
- 사용자 편집 모달 새로 구현
- 부서명 한글 변환 함수 (AuthAPI.getDepartmentLabel)
✨ User Management Features:
- 편집 버튼으로 사용자 정보 수정 가능
- 부서, 이름, 권한 실시간 변경
- 사용자 ID는 수정 불가 (읽기 전용)
- 모달 기반 직관적 UI
🔍 Visual Enhancements:
- 부서 정보 아이콘 (fas fa-building)
- 색상 코딩: 부서(녹색), 권한(빨강/파랑)
- 반응형 레이아웃 (flex-1, gap-3)
- 호버 효과 및 트랜지션
🚀 API Integration:
- AuthAPI.getDepartments() - 부서 목록 반환
- AuthAPI.getDepartmentLabel() - 부서명 변환
- AuthAPI.updateUser() - 부서 정보 포함 업데이트
- 기존 createUser API 확장 지원
Expected Result:
✅ 사용자 생성 시 부서 선택 가능
✅ 사용자 목록에 부서 정보 표시
✅ 편집 버튼으로 부서 변경 가능
✅ 5개 부서 분류 시스템 완성
✅ 직관적인 사용자 관리 UI
🗄️ DB Schema Changes:
- 새로운 ENUM 타입 추가:
* review_status: pending_review, in_progress, completed, disposed
* disposal_reason_type: duplicate, invalid_report, not_applicable, spam, custom
- issues 테이블 확장 (8개 컬럼 추가):
* review_status: 수신함 워크플로우 상태 관리
* disposal_reason: 폐기 사유 (기본값: duplicate)
* custom_disposal_reason: 사용자 정의 폐기 사유
* disposed_at: 폐기 처리 날짜
* reviewed_by_id: 검토자 ID (users 테이블 FK)
* reviewed_at: 검토 완료 날짜
* original_data: 원본 데이터 보존 (JSONB)
* modification_log: 수정 이력 추적 (JSONB)
- 성능 최적화 인덱스 3개 추가:
* idx_issues_review_status
* idx_issues_reviewed_by_id
* idx_issues_disposed_at (부분 인덱스)
- 데이터 무결성 제약 조건:
* chk_disposal_reason_required: 폐기 시 사유 필수
* chk_custom_reason_logic: custom 사유 시 텍스트 필수
🛡️ Migration Safety Features:
- 중복 실행 방지 (IF NOT EXISTS 체크)
- 트랜잭션 기반 원자성 보장
- 실행 결과 자동 검증 (컬럼/인덱스/ENUM 개수 확인)
- migration_log 테이블로 실행 이력 추적
- 상세한 실행 로그 및 에러 메시지
📋 Deployment Checklist:
- 배포 시 필수 확인사항 문서화
- 자동 마이그레이션 스크립트 제공
- 단계별 검증 절차 정의
- 롤백 계획 및 문제 해결 가이드
- API 테스트 및 모니터링 방법
🎯 Workflow Design:
업로드 → 수신함(검토) → [폐기→폐기함] or [승인→관리함]
- 폐기: 중복/무효 데이터만 (분석 가치 없음)
- 관리함: 모든 유효한 부적합 (진행중+완료 포함)
- 원본 데이터 보존으로 수정 전후 비교 가능
- 수정 이력 추적으로 변경 내역 완전 보존
Result:
✅ DB 스키마 완전 구축
✅ 마이그레이션 안전성 100% 보장
✅ 배포 시 누락 방지 시스템 구축
✅ 수신함 워크플로우 DB 기반 완성
- 기존 4단계 권한을 admin/user 2단계로 단순화
- 페이지별 세부 접근 권한 관리 시스템 추가
- 부적합 조회 시 일반 사용자는 본인 등록 건만 조회 가능하도록 제한
- 관리자 전용 전체 부적합 조회 API 추가 (/api/issues/admin/all)
Backend Changes:
- models.py: UserPagePermission 모델 추가, UserRole 단순화
- page_permissions.py: 페이지 권한 관리 API 라우터 추가
- auth.py: 사용자 목록 조회 및 비밀번호 초기화 API 추가
- issues.py: 권한별 부적합 조회 제한 로직 구현
- 마이그레이션: 010~012 권한 시스템 관련 DB 스키마 변경
- 토큰 저장 키 통일 (access_token으로 일관성 확보)
- 일일공수 페이지 API 스크립트 로딩 순서 수정
- 프로젝트 관리 페이지 비활성 프로젝트 표시 문제 해결
- 업로드 카테고리에 '기타' 항목 추가 (백엔드 schemas.py 포함)
- 비밀번호 변경 기능 API 연동으로 수정
- 프로젝트 드롭다운 z-index 문제 해결
- CORS 설정 및 Nginx 구성 개선
- 비밀번호 해싱 방식 pbkdf2_sha256으로 변경 (bcrypt 72바이트 제한 해결)
- localStorage와 DB ID 불일치 문제 해결
- 프로젝트별 보고서 시간 필터링 수정
- 일반 사용자에게 일일공수 메뉴 숨김
- 공통 헤더 및 인증 시스템 구현
- 프로젝트별 일일공수 분리 기능 추가 (ProjectDailyWork 모델)
- IssuesAPI에서 project_id 누락 문제 수정
- 사용자 인증 통합 (TokenManager 기반)
- 목록 관리 페이지에 고급 필터링 시스템 추가
- 프로젝트별, 검토상태별, 날짜별 필터링
- 검토 완료/필요 항목 시각적 구분 및 정렬
- 해결 시간 입력 + 확인 버튼으로 검토 완료 처리
- 부적합 조회 페이지에 동일한 필터링 기능 적용
- 검토 상태에 따른 카드 스타일링 (음영 처리)
- JavaScript 템플릿 리터럴 오류 수정
- 보고서 페이지 프로젝트별 분석 기능 추가
- 프로젝트 선택 드롭다운 추가
- 총 작업 공수를 프로젝트별 일일공수 데이터로 계산
- 부적합 처리 시간, 카테고리 분석, 상세 목록 모두 프로젝트별 필터링
- localStorage 키 이름 통일 (daily-work-data)
- 사진 2장까지 업로드 지원
- 카메라 촬영 + 갤러리 선택 분리
- 이미지 압축 및 최적화 (ImageUtils)
- iPhone .mpo 파일 JPEG 변환 지원
- 카테고리 변경: 치수불량 → 설계미스, 검사미스 추가
- KST 시간대 설정
- URL 해시 처리로 목록관리 페이지 이동 개선
- 로그인 OAuth2 form-data 형식 수정
- 업로드 속도 개선 및 프로그레스바 추가
- 일일 공수 입력 기능
- 부적합 사항 등록 (이미지 선택사항)
- 날짜별 부적합 조회 (시간순 나열)
- 목록 관리 (인라인 편집, 작업시간 확인 버튼)
- 보고서 생성 (총 공수/부적합 시간 분리)
- JWT 인증 및 권한 관리
- Docker 기반 배포 환경 구성
