SYSTEM BLUEPRINT

현장 수리 증빙 시스템
작업자 앱과 관리자 웹 화면 설계

바코드 스캔, 전후 사진 촬영, 오프라인 동기화, 검수와 정산 흐름을 화면 단위로 정의합니다.

현장 작업자 시나리오

PDA 작업 흐름

작업자는 스캔, 촬영, 저장만 수행하고 앱이 동기화와 누락 방지를 처리합니다.

1. 로그인

작업자 계정 인증
오늘의 작업 목록 진입

2. 바코드 스캔

작업 대상 자동 식별
수기 입력 예외 처리

3. 전 사진 촬영

수리 전 상태 기록
필수 촬영 체크

4. 후 사진 촬영

수리 후 상태 기록
전후 묶음 저장

5. 자동 동기화

오프라인 큐 저장
연결 복구 시 업로드

현장 작업자 | 화면 01

작업자 홈 및 작업 목록

app.field-proof.local/jobs
PDA App

현장 작업

오늘의 작업

동기화 완료42건
검수 대기12건
업로드 실패1건

동기화 대기 3건

[화면 개요 및 목적]

오늘 배정된 작업과 동기화 상태를 한눈에 확인합니다.

[핵심 기능 로직]

서버 작업 목록과 로컬 임시 저장 목록을 합쳐 보여주고 상태값을 갱신합니다.

  • Kotlin 또는 Flutter
  • 로컬 저장소
현장 작업자 | 화면 02

바코드 스캔 및 작업 대상 확인

app.field-proof.local/scan
PDA App

현장 작업

바코드 스캔

컨테이너MSKU-4821
작업 코드DOOR-REPAIR
상태촬영 필요

스캔 후 사진 촬영으로 이동

[화면 개요 및 목적]

바코드를 스캔해 컨테이너 또는 작업 대상을 확인합니다.

[핵심 기능 로직]

스캔값을 로컬과 서버에서 조회하고 미등록 대상은 예외 흐름으로 저장합니다.

  • ML Kit Barcode
  • 예외 처리 큐
현장 작업자 | 화면 03

전후 사진 촬영 및 임시 저장

PDA App

현장 작업

사진 증빙

작업 전 사진완료
작업 후 사진완료
GPS와 시간기록

동기화 대기 3건

[화면 개요 및 목적]

작업 전 사진과 작업 후 사진을 필수로 촬영하고 제출합니다.

[핵심 기능 로직]

이미지 압축, 메타 정보 저장, 업로드 재시도 상태를 로컬 큐에 기록합니다.

  • 카메라 모듈
  • WorkManager
현장 관리자 시나리오

검수와 보정 흐름

관리자는 수집된 작업 기록을 검수하고 보류, 반려, 승인 상태를 관리합니다.

1. 대시보드

작업 현황 확인
검수 대기 우선 표시

2. 상세 조회

전후 사진 비교
작업자와 시간 확인

3. 상태 처리

승인, 보류, 반려
검수 메모 작성

4. 자료 집계

기간, 작업자별 필터
정산 대상 선별

5. 내보내기

엑셀 다운로드
내부 보고 활용

현장 관리자 | 화면 01

관리자 대시보드

admin.field-proof.local/dashboard
검수 대시보드관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
MSKU-4821김현장검수 대기
MSKU-9133박작업승인
MSKU-1248이수리보류

[화면 개요 및 목적]

금일 작업, 동기화율, 검수 대기 건을 요약합니다.

[핵심 기능 로직]

작업 기록을 상태별로 집계하고 위험 항목을 우선 노출합니다.

  • React
  • 차트 컴포넌트
현장 관리자 | 화면 02

작업 상세 및 사진 비교

admin.field-proof.local/jobs/4821
전후 사진 비교관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
전 사진문 파손 확인원본 보기
후 사진수리 완료승인 가능
검수 메모단가 확인 필요보류

[화면 개요 및 목적]

작업 전후 사진을 나란히 비교하고 검수 판단을 내립니다.

[핵심 기능 로직]

사진 원본, 압축본, 메타 정보, 검수 로그를 한 작업 단위로 조회합니다.

  • 이미지 뷰어
  • 검수 로그
현장 관리자 | 화면 03

정산 집계 및 엑셀 내보내기

admin.field-proof.local/reports
정산 집계관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
이번 주 승인318건내보내기
보류22건재검수
반려7건사유 보기

[화면 개요 및 목적]

기간과 작업자 기준으로 승인된 작업만 모아 정산 자료를 생성합니다.

[핵심 기능 로직]

필터 조건을 적용한 뒤 승인 이력과 사진 링크를 포함해 엑셀을 생성합니다.

  • Data Aggregation & Visualization
  • 엑셀 생성 모듈
시스템 운영자 시나리오

운영 설정 흐름

운영자는 사용자, 협력업체, 권한, 기준 데이터를 관리합니다.

1. 계정 관리

작업자와 관리자 등록
권한 분리

2. 협력업체 관리

업체별 작업자 연결
정산 기준 관리

3. 현장 관리

물류 센터와 구역 등록
작업 코드 관리

4. 권한 설정

조회, 승인, 내보내기 권한
역할 기반 제어

5. 로그 확인

업로드 실패 추적
검수 이력 감사

시스템 운영자 | 화면 01

사용자와 권한 관리

admin.field-proof.local/settings/users
사용자 관리관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
김현장작업자활성
최검수관리자활성
운영팀최고 관리자활성

[화면 개요 및 목적]

작업자, 관리자, 최고 관리자의 권한을 분리합니다.

[핵심 기능 로직]

역할 기반 접근 제어로 화면과 API 권한을 제한합니다.

  • JWT 인증
  • 역할 기반 권한
시스템 운영자 | 화면 02

현장과 작업 코드 설정

admin.field-proof.local/settings/codes
작업 코드관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
DOOR-REPAIR문 수리사용
PANEL-FIX패널 보정사용
CLEAN-UP청소사용

[화면 개요 및 목적]

현장, 구역, 작업 코드를 등록해 바코드 기록과 연결합니다.

[핵심 기능 로직]

기준 데이터 변경 이력을 남기고 앱 동기화 시 최신 기준을 내려줍니다.

  • 기준 데이터 API
  • 변경 이력
시스템 운영자 | 화면 03

동기화 로그와 장애 추적

admin.field-proof.local/settings/logs
동기화 로그관리자 웹
128
금일 작업
97%
동기화율
12
검수 대기
기기 A-12업로드 재시도해결
기기 B-07사진 누락확인 필요
기기 C-03중복 제출자동 병합

[화면 개요 및 목적]

업로드 실패, 중복 제출, 누락 사진 같은 장애를 추적합니다.

[핵심 기능 로직]

클라이언트 로그와 서버 로그를 작업 단위로 연결해 재처리 여부를 판단합니다.

  • 로그 수집
  • Issue Tracking & Status Management