4.0 KiB

Raw Blame History

작업 이력 관리 시스템 설치 가이드

📋 개요

작업 이력 관리 시스템이 추가되었습니다. 입고/출고/이송/정비 작업을 관리하고 통계를 확인할 수 있습니다.

🚀 설치 방법

1. 데이터베이스 마이그레이션 실행

PostgreSQL 데이터베이스에 작업 이력 테이블을 생성해야 합니다.

# 방법 1: psql 명령어 사용 (로컬 PostgreSQL)
psql -U postgres -d plm -f db/migrations/20241020_create_work_history.sql

# 방법 2: Docker 컨테이너 사용
docker exec -i <DB_CONTAINER_NAME> psql -U postgres -d plm < db/migrations/20241020_create_work_history.sql

# 방법 3: pgAdmin 또는 DBeaver 사용
# db/migrations/20241020_create_work_history.sql 파일을 열어서 실행

2. 백엔드 재시작

cd backend-node
npm run dev

3. 프론트엔드 확인

대시보드 편집 화면에서 다음 위젯들을 추가할 수 있습니다:

작업 이력: 작업 목록을 테이블 형식으로 표시
운송 통계: 오늘 작업, 총 운송량, 정시 도착률 등 통계 표시

📊 주요 기능

작업 이력 위젯

작업 번호, 일시, 유형, 차량, 경로, 화물, 중량, 상태 표시
유형별 필터링 (입고/출고/이송/정비)
상태별 필터링 (대기/진행중/완료/취소)
실시간 자동 새로고침

운송 통계 위젯

오늘 작업 건수 및 완료율
총 운송량 (톤)
누적 거리 (km)
정시 도착률 (%)
작업 유형별 분포 차트

🔧 API 엔드포인트

작업 이력 관리

GET /api/work-history - 작업 이력 목록 조회
GET /api/work-history/:id - 작업 이력 단건 조회
POST /api/work-history - 작업 이력 생성
PUT /api/work-history/:id - 작업 이력 수정
DELETE /api/work-history/:id - 작업 이력 삭제

통계 및 분석

GET /api/work-history/stats - 작업 이력 통계
GET /api/work-history/trend?months=6 - 월별 추이
GET /api/work-history/routes?limit=5 - 주요 운송 경로

📝 샘플 데이터

마이그레이션 실행 시 자동으로 4건의 샘플 데이터가 생성됩니다:

입고 작업 (완료)
출고 작업 (진행중)
이송 작업 (대기)
정비 작업 (완료)

🎯 사용 방법

1. 대시보드에 위젯 추가

대시보드 편집 모드로 이동
상단 메뉴에서 "위젯 추가" 선택
"작업 이력" 또는 "운송 통계" 선택
원하는 위치에 배치
저장

2. 작업 이력 필터링

유형 선택: 전체/입고/출고/이송/정비
상태 선택: 전체/대기/진행중/완료/취소
새로고침 버튼으로 수동 갱신

3. 통계 확인

운송 통계 위젯에서 다음 정보를 확인할 수 있습니다:

오늘 작업 건수
완료율
총 운송량
정시 도착률
작업 유형별 분포

🔍 문제 해결

데이터가 표시되지 않는 경우

데이터베이스 마이그레이션이 실행되었는지 확인
백엔드 서버가 실행 중인지 확인
브라우저 콘솔에서 API 에러 확인

API 에러가 발생하는 경우

# 백엔드 로그 확인
cd backend-node
npm run dev

위젯이 표시되지 않는 경우

프론트엔드 재시작
브라우저 캐시 삭제
페이지 새로고침

📚 관련 파일

백엔드

backend-node/src/types/workHistory.ts - 타입 정의
backend-node/src/services/workHistoryService.ts - 비즈니스 로직
backend-node/src/controllers/workHistoryController.ts - API 컨트롤러
backend-node/src/routes/workHistoryRoutes.ts - 라우트 정의

프론트엔드

frontend/types/workHistory.ts - 타입 정의
frontend/components/dashboard/widgets/WorkHistoryWidget.tsx - 작업 이력 위젯
frontend/components/dashboard/widgets/TransportStatsWidget.tsx - 운송 통계 위젯

데이터베이스

db/migrations/20241020_create_work_history.sql - 테이블 생성 스크립트

🎉 완료!

작업 이력 관리 시스템이 성공적으로 설치되었습니다!

4.0 KiB Raw Blame History