Hyungi Ahn c3383a1154 feat: 수신함 프론트엔드 완전 구현 - 실제 API 연동
🎨 UI Components:
- 3개 워크플로우 모달 추가:
  * 폐기 모달: 사유 선택 (중복/무효신고/해당없음/스팸/직접입력)
  * 검토 모달: 프로젝트/카테고리/설명 수정 + 원본 정보 표시
  * 상태 모달: 진행중/완료 선택 + 처리 메모

- 부적합 카드 UI 개선:
  * 워크플로우 액션 버튼 (폐기/검토/승인)
  * 읽음/안읽음 상태 표시
  * 사진 첨부 여부 표시
  * 클릭 가능한 제목 (상세보기)

🔌 API Integration:
- 실제 백엔드 API 완전 연동:
  * GET /api/inbox/ - 수신함 목록 (프로젝트 필터링)
  * GET /api/inbox/statistics - 실시간 통계
  * POST /api/inbox/{id}/dispose - 폐기 처리
  * POST /api/inbox/{id}/review - 검토/수정
  * POST /api/inbox/{id}/status - 상태 변경

- 에러 처리 및 사용자 피드백:
  * API 오류 시 적절한 메시지 표시
  * 성공 시 결과 안내 및 목록 자동 새로고침
  * 입력 검증 (필수값, 사용자 정의 사유 등)

🎯 Workflow Logic:
- 폐기 처리:
  * 5가지 사유 선택 (기본값: 중복)
  * 사용자 정의 사유 입력 검증
  * 폐기 후 폐기함으로 이동

- 검토/수정:
  * 원본 정보 보존 및 표시
  * 프로젝트/카테고리/설명 수정 가능
  * 수정 이력 자동 추적

- 상태 결정:
  * 진행중/완료 선택
  * 처리 메모 추가 가능
  * 관리함으로 자동 이동

📊 Real-time Features:
- 실시간 통계 업데이트
- 읽음 상태 로컬 저장 (inbox_read_status)
- 프로젝트별 필터링
- 자동 목록 새로고침

🎨 UX Improvements:
- 모달 기반 워크플로우 (직관적)
- 원본 정보 표시 (수정 전후 비교)
- 적절한 로딩 상태 표시
- 사용자 친화적 에러 메시지
- 액션 버튼 색상 구분 (빨강/파랑/초록)

Result:
 수신함 워크플로우 프론트엔드 100% 완성
 백엔드 API와 완벽 연동
 실시간 데이터 동기화
 사용자 친화적 UI/UX
 모든 워크플로우 액션 구현
2025-10-25 12:11:26 +09:00

M-Project - 작업보고서 시스템

간단하고 효율적인 부적합 사항 관리 및 공수 계산 시스템

🚀 빠른 시작

Docker를 사용한 실행 (권장)

  1. Docker 컨테이너 실행:
cd M-Project
docker-compose up -d
  1. 브라우저에서 접속:
http://localhost:16080
  1. 로그인:
  • 관리자: hyungi / djg3-jj34-X3Q3
  • 검사자1: inspector1 / pass123
  • 검사자2: inspector2 / pass456

간단한 웹 서버 실행 (개발용)

cd M-Project
python3 -m http.server 16080

📱 주요 기능

1. 프로젝트 관리 (신규 추가 )

  • Job No. 기반 프로젝트 생성
  • 관리자 전용 프로젝트 생성 배너
  • 프로젝트 목록 조회 및 관리

2. 부적합 등록 (모바일 최적화)

  • 사진 촬영 또는 업로드 (최대 2장)
  • 카테고리별 분류 (자재누락, 설계미스, 입고자재 불량, 검사미스)
  • 상세 설명 입력

3. 목록 관리

  • 등록된 부적합 사항 조회
  • 작업 시간 입력
  • 상태 변경 (신규→진행중→완료)
  • 추가 메모 작성

4. 일일 공수 관리

  • 작업자 수 및 정규/야근 시간 입력
  • 날짜별 공수 추적
  • 자동 계산 기능

5. 보고서

  • 작업 기간 및 총 공수 자동 계산
  • 카테고리별 통계
  • 부적합 사항 상세 내역
  • 인쇄 가능한 형식

📁 파일 구조

M-Project/
├── index.html      # 메인 애플리케이션
├── Rules.md        # 시스템 규칙 및 요구사항
└── README.md       # 이 파일

🛠️ 기술 스택

  • Backend: FastAPI (Python), SQLAlchemy, PostgreSQL
  • Frontend: HTML5, Tailwind CSS, JavaScript (Vanilla)
  • Database: PostgreSQL 15
  • Container: Docker & Docker Compose
  • Web Server: Nginx
  • Authentication: JWT (JSON Web Token)
  • Icons: Font Awesome

📋 데이터 구조

부적합 사항은 다음과 같은 형식으로 저장됩니다:

{
  id: 1234567890,                    // 타임스탬프
  photo: "data:image/jpeg;base64...", // Base64 이미지
  location: "2층 회의실",              // 위치
  category: "safety",                 // 카테고리
  description: "안전 장비 미착용",      // 설명
  urgency: "high",                    // 긴급도
  status: "new",                      // 상태
  reporter: "inspector1",             // 보고자 ID
  reporterName: "검사자1",            // 보고자 이름
  reportDate: "2025-09-17T10:30:00", // 보고 일시
  workHours: 2.5,                    // 작업 시간
  detailNotes: "추가 메모..."         // 상세 메모
}

특징

  • 모바일 우선: 현장에서 스마트폰으로 쉽게 입력
  • 실시간 데이터: PostgreSQL 데이터베이스로 실시간 동기화
  • 권한 관리: 관리자/일반 사용자 역할 기반 접근 제어
  • Docker 기반: 간편한 배포 및 확장성
  • RESTful API: 표준 API 설계로 확장 가능

🔒 보안 기능

  • JWT 인증: 토큰 기반 보안 인증 시스템
  • 비밀번호 암호화: bcrypt 해시를 사용한 안전한 비밀번호 저장
  • 권한 기반 접근: 역할별 API 접근 제어
  • SQL 인젝션 방지: SQLAlchemy ORM 사용

📚 문서

📝 라이선스

내부 사용 목적으로 제작됨


최종 업데이트: 2024-10-24
버전: 1.0.0 (프로젝트 관리 기능 추가)

Description
No description provided
Readme 1.9 MiB
Languages
HTML 66.2%
Python 13.6%
JavaScript 13.4%
PLpgSQL 5%
Shell 1.3%
Other 0.5%