📌 트리거

• 관리자가 GUI에서 "분류시작", "분류종료", "일시정지" 버튼 클릭
• 컨베이어 벨트 입구 IR 센서에 물품 감지
• 10초간 물품 미감지

👥 참여자

• GUI
• API Server
• Service Layer
• TCP Handler
• Sort Controller (ESP32)

🟢 A. 분류 시작 시나리오

1. 시작 명령 발생

   • 관리자가 GUI에서 "분류시작" 버튼 클릭
   • GUI에서 REST API 요청 전송: POST /api/inbound/start

2. 시스템 상태 확인

   • Service Layer는 현재 분류기 상태 확인
     • 상태가 RUNNING일 경우
       → WebSocket 메시지 전송:
       {"event_type": "info", "message": "이미 작동 중입니다", "auto_dismiss": 1000}
       → 요청 중단
     • 상태가 PAUSED일 경우
       → 일시정지에서 재개 작업 진행
     • 상태가 STOPPED일 경우
       → 정지에서 시작 작업 진행

3. 하드웨어 제어 명령 전송

   • TCP Handler가 Sort Controller로 메시지 전송: SCst\n
   • Sort Controller 작업:
     • 컨베이어 벨트 모터 ON
     • 바코드 스캐너 ON
     • 센서 활성화
     • 응답 전송: SRok\n

4. GUI 상태 업데이트

   • 상태를 RUNNING으로 변경
   • WebSocket 메시지 전송:
     {"event_type": "status_update", "status": "running"}
   • GUI 반영:
     • 상태: 작동 중 (녹색)
     • "분류시작" 버튼 비활성화
     • "분류종료", "일시정지" 버튼 활성화

🔴 B. 분류 종료 시나리오

1. 종료 명령 발생

   • GUI에서 "분류종료" 클릭 → POST /api/inbound/stop
   • 또는 Sort Controller가 10초 미감지 감지 → SEas\n

2. 시스템 상태 확인

   • 상태가 RUNNING 또는 PAUSED가 아닐 경우
     → WebSocket 메시지 전송:
     {"event_type": "info", "message": "분류기가 작동 중이 아닙니다", "auto_dismiss": 1000}
     → 중단

3. 대기 물품 확인

   • 대기 물품 수 > 0일 경우
     → WebSocket 경고 메시지 전송:
     {"event_type": "warning", "message": "아직 처리 중인 물품이 있습니다", "auto_dismiss": 1000}
     → 종료 중단
   • 대기 물품 없음 → 다음 단계 진행

4. 하드웨어 제어 명령 전송

   • TCP Handler → Sort Controller: SCsp\n
   • Sort Controller 작업:
     • 컨베이어 벨트 모터 OFF
     • 바코드 스캐너 OFF
     • 센서 비활성화
     • 응답 전송: SRok\n

5. GUI 상태 업데이트

   • 상태를 STOPPED로 변경
   • WebSocket 메시지 전송:
     {"event_type": "status_update", "status": "stopped"}
   • GUI 반영:
     • 상태: 분류 종료 (회색)
     • "분류시작" 버튼 활성화
     • "분류종료", "일시정지" 버튼 비활성화

🟡 C. 일시정지 시나리오

1. 일시정지 명령 발생

   • GUI에서 "일시정지" 버튼 클릭 → POST /api/inbound/pause

2. 시스템 상태 확인

   • 상태가 RUNNING이 아닐 경우
     → WebSocket 메시지 전송:
     {"event_type": "info", "message": "분류기가 작동 중이 아닙니다", "auto_dismiss": 1000}
     → 중단

3. 하드웨어 제어 명령 전송

   • TCP Handler → Sort Controller: SCps\n
   • Sort Controller 작업:
     • 컨베이어 벨트 모터 OFF
     • 스캐너 및 센서는 ON 상태 유지
     • 응답 전송: SRok\n

4. GUI 상태 업데이트

   • 상태를 PAUSED로 변경
   • WebSocket 메시지 전송:
     {"event_type": "status_update", "status": "paused"}
   • GUI 반영:
     • 상태: 일시정지 (노란색)
     • "분류시작" 버튼 활성화 (재개 용도)
     • "분류종료" 버튼 활성화
     • "일시정지" 버튼 비활성화

📌 트리거

• 컨베이어 벨트 입구 IR 센서에 물품 감지

👥 참여자

• Sort Controller (ESP32)
• TCP Handler
• Service Layer
• DB
• GUI

📦 1. 물품 감지 및 카운트 증가

• Sort Controller의 입구 IR 센서가 물품 감지
• Sort Controller는 TCP 메시지를 TCP Handler로 전송
  • 메시지에는 센서 ID(entry), 감지 상태(1=감지됨) 포함
• TCP Handler는 메시지를 Service Layer로 전달
• Service Layer는 입고 대기 물품 수를 1 증가시킴
• Socket.IO를 통해 GUI에 업데이트된 카운트 전송
• GUI는 다음과 같이 표시
  • 대기 물품 수를 1로 업데이트
  • 진행 표시줄 반영

🔍 2. 바코드 스캔 및 분류

• 물품이 ESP32-CAM 위치에 도달 → Sort Controller가 바코드 스캔 수행
• 스캔된 바코드 정보를 TCP 메시지로 전송
• TCP Handler → Service Layer로 메시지 전달
• Service Layer는 바코드 파싱 수행:
  • 보관 종류: 첫 1자리 (1: 냉동/A, 2: 냉장/B, 3: 상온/C)
  • 물품 번호: 다음 2자리
  • 유통기한: 다음 6자리 (YYMMDD 형식)
• 물품 번호에 따라 창고 결정 (A/B/C)
• DB에서 해당 창고의 빈 선반 위치 조회
  • 가장 번호가 작은 선반 위치 할당
• TCP Handler가 Sort Controller에 분류 명령 전송
  • 분류 구역 정보 포함 (A/B/C/E)

⚙️ 3. 분류 실행 및 결과 처리

• Sort Controller는 명령 수신 → 서보모터 작동
  • 지정된 구역으로 물품 밀어냄
• 분류대 IR 센서가 물품 통과 감지
• 감지 결과를 TCP 메시지로 전송 → Service Layer로 전달
• Service Layer는 다음 작업 수행:
  • 대기 물품 수 1 감소
  • 처리된 물품 수 1 증가
  • DB에 물품 정보 저장 (분류, 창고, 유통기한 등)
• Socket.IO를 통해 GUI에 분류 결과 및 카운트 전송
• GUI는 다음 항목 업데이트:
  • 대기 수량
  • 처리 수량
  • 물품 로그에 새 항목 추가

🔀 선택 분기점

• 물품 분류:
  • 물품 번호에 따라 A/B/C 창고 중 하나로 지정
• 분류 감지:
  • IR 센서 감지 성공 → 분류 완료
  • 감지 실패 → 물품 분실 처리

❗ 예외 상황 - 바코드 오류

• Sort Controller가 바코드 인식 실패 시 오류 이벤트 전송
• Service Layer는 오류 물품을 E 분류대로 이동 지시
• GUI에 바코드 오류 알림 표시 (Socket.IO 메시지)

📌 트리거

• 정기적(5초 간격) 환경 센서 측정
• 관리자 온도 기준치 변경 시

👥 참여자

• Env Controller
• TCP Handler
• Service Layer
• DB
• GUI

🌡️ 1. 창고별 상태 확인

• 기준치: 사용자가 고정된 범위 내에서 설정한 온도

• 고정된 범위:

  • 냉동 창고(A): -25℃ ~ -15℃
  • 냉장 창고(B): 0℃ ~ 10℃
  • 상온 창고(C): 15℃ ~ 25℃

• 기준치 설정 플로우:

  • GUI에서 기준치 설정 (고정 범위 내)
  • API Server → Service Layer → TCP Server → Env Controller로 기준치 전송

• 온도 측정 및 상태 판단 (Env Controller에서 5초 주기 실행):

  • 대기 모드: 기준치 ±2℃ 이내
  • 냉방 모드:
    • 1단계: 기준치 +2℃ 초과 ~ +4℃ 이내
    • 2단계: 기준치 +4℃ 초과 ~ +6℃ 이내
    • 3단계: 기준치 +6℃ 초과
  • 난방 모드:
    • 1단계: 기준치 -2℃ 미만 ~ -4℃ 이내
    • 2단계: 기준치 -4℃ 미만 ~ -6℃ 이내
    • 3단계: 기준치 -6℃ 미만
  • 경고 상태: 고정된 min/max 범위 벗어난 값

• 결과 전송:

  • Env Controller → TCP Handler → Service Layer → API Server → GUI
  • 포함 정보:
    • 창고 ID
    • 측정값
    • 온도 제어 단계
    • 정상/경고 상태
    • 시간

• 경고 상태인 경우:

  • DB의 temp_warning_logs 테이블에 기록 (창고 ID, 온도, 발생 시각)

🖥️ 2. GUI 표시

• 대시보드:

  • 창고 ID, 측정값, 상태 표시
  • 상태 색상:
    • 정상: 녹색
    • 경고: 빨간색

• 창고환경 페이지:

  • 창고 ID, 측정값, 온도 제어 단계, 상태 표시
  • 제어 단계 색상:
    • 냉방: 파란색
    • 난방: 빨간색
    • 정지: 회색
  • 상태 색상:
    • 정상: 초록색
    • 경고: 빨간색

💨 3. 팬 제어 명령 결정

• Env Controller는 온도 제어 단계에 따라 팬 속도 및 LED 상태 조절

• 냉방 모드:

  • 팬 작동 (단계별 세기 증가)
  • 파란색 LED ON
  • 빨간색 LED OFF

• 난방 모드:

  • A, B 창고: 팬 정지 + 모든 LED OFF
  • C 창고: 팬 작동 (단계별 세기 증가) + 빨간색 LED ON + 파란색 LED OFF

• 정지 모드:

  • 팬 정지 + 모든 LED OFF

• 처리 후 TCP Handler → Service Layer로 제어 단계 전송

🚨 4. 경고 상태 처리

• 경고 상태 발생 시:

  • Service Layer → Env Controller로 경고 명령 전송
  • Env Controller는 노란색 LED 깜빡임 및 부저 작동

• 정상 상태 복귀 시:

  • 경고 장치 비활성화 명령 전송 (LED 및 부저 OFF)

🔀 선택 분기점

• 온도 상태에 따라:

  • 정상 / 경고 / 위험 상태 → GUI 및 LED 표시, 팬 제어 방식 변경

• 팬 제어 모드:

  • 냉방: 파란 LED, 팬 작동
  • 난방: 빨간 LED, 팬 작동 (C 창고만)
  • 정지: 팬 OFF, 모든 LED OFF

❗ 예외 상황

• 센서 오류:

  • 측정값 비정상 시 이전 값 유지
  • 오류 상태 GUI 표시

• 통신 장애:

  • 10초 이상 데이터 미수신 시 장애 표시
  • 자동 재연결 시도

[RFID 카드 등록]

[등록된 RFID 카드 출입]