pbl02/scenario_md/MOV02-수송·물류·창고_수송성과-수송지원 실적·비용 가시화 Tool/MOV02-수송·물류·창고_수송성과-수송지원 실적·비용 가시화 Tool.md

수송지원 실적·비용 가시화 Tool

난 이 도 중급

프로젝트 목표

NATO 동맹전환사령부(ACT)는 다국적 군수 지원에서 수송 요청부터 도착까지의 시간, 처리 기간, 물동량과 수송능력, 지연 원인을 한 화면에서 보는 물류·수송 성과 가시화를 강조해 왔다. 본 프로젝트는 이 공개 사례를 바탕으로 교육용 가상 도로망과 수송 자산 자료를 코드로 만들어, 수송지원 실적과 비용을 근거로 경로와 자산을 결정하는 과정을 구현한다. 학습자는 자산·도로망 스키마 정의, 도로 파괴·통제 구역 전처리, 다익스트라 Baseline, 위협 회피·적재 효율 추천, 생존확률·정시도착 신뢰도 점수, 관제 대시보드, 수송통제관 승인(HITL), 도로 50곳 차단 스트레스 시험, AAR 재보정, 최종 통합을 차례로 수행한다. 최종 목표는 수송 리드타임과 톤km당 비용을 낮추면서 위험 경로의 강행 여부는 반드시 사람이 결정하도록 하는 수송지원 실적·비용 가시화 도구를 완성하는 것이다.

유의사항	모든 도로망·자산 제원·위협 구역·수송 기록은 코드 안에서 만든 교육용 가상 자료이며 실제 부대명, 지명, 보급로, 장비 제원, 작전 정보는 사용하지 않는다. 부대 내 촬영이나 부대 자료의 외부 AI 서비스 입력은 금지한다. 위협 구역과 생존확률은 판단 보조를 위한 추상 모델이며, 위험 경로 강행·우회와 실제 수송 결심은 지휘계통에 따른다. 비용 단가와 수작업 소요시간은 교육용 가정값이다. 미션별 정답 코드는 각각 한 파일로 독립 실행된다.

1단계. 수송 데이터 정의 및 전장 제약 전처리

미션 1. 전장 수송 자산(트럭, 트레일러, 수송기) 제원 및 도로망 네트워크 데이터 스키마 정의 [초급 · 1.5시간]	미션 1. 전장 수송 자산(트럭, 트레일러, 수송기) 제원 및 도로망 네트워크 데이터 스키마 정의 [초급 · 1.5시간]
목표	트럭·트레일러·수송기의 교육용 가정 제원과 도로망(노드·간선·교량 하중) 데이터 스키마를 정의하고, 수송지원 실적·비용 보고 업무를 AS-IS/TO-BE로 비교한다.
수행	자산(적재량·속도·km당 비용), 노드, 간선(거리·도로 등급·교량 하중·통행 여부), 수송 요청의 필드와 허용값을 정한다. 가상 샘플을 만들어 검증기로 형식·범위 오류를 걸러 낸다. 현행 수송 실적·비용 보고 업무를 10단계 이상으로 분해해 단계별 소요시간을 적고, 병목 구간과 자동화 후 TO-BE 절차를 비교표로 정리한다.
산출물	docs/mov02_as_is_to_be_spec.md, 자산·도로망 스키마 정의서
평가	[필수] 업무 분해·스키마 정의 — 업무 단계 10단계 이상, 병목 구간 3개소 이상을 도출하고, AS-IS/TO-BE 소요시간 비교와 입출력 데이터 명세(필드·허용값)가 빠짐없이 작성되었는가.

미션 2. 도로 파괴, 교량 붕괴, 통제 구역 등 전장 제약 조건 그래프 전처리 모듈 구현 [초급~중급 · 2시간]	미션 2. 도로 파괴, 교량 붕괴, 통제 구역 등 전장 제약 조건 그래프 전처리 모듈 구현 [초급~중급 · 2시간]
목표	도로 파괴, 교량 붕괴·하중 제한, 통제 구역 보고를 여러 형식에서 읽어 도로망 그래프에 반영하는 전처리 모듈을 구현한다.
수행	CSV, 엑셀 내보내기(탭 구분), JSON, 공문 텍스트 형식의 가상 보고서를 각각 파싱해 표준 제약 레코드로 바꾼다. 머리글이 바뀐 양식은 별칭 사전으로 맞추고, 존재하지 않는 구간 번호는 반영을 보류해 확인을 요청한다. 반영 전후 연결 요소 수와 부대별 도달 가능 여부를 비교한다.
산출물	src/connectors/mov02_data_loader.py 및 스키마 정의서
평가	[필수] 다형식 파싱·제약 반영 — 지원 형식 4종 파싱 성공률 100%, 양식 변경(머리글 변경) 대응, 오류 레코드 반영 보류와 반영 전후 연결성 비교가 확인되었는가.

2단계. 최단경로 Baseline 및 위협 회피 경로 추천

미션 3. 다익스트라 기반 최단거리 보급 경로 탐색 1차 Baseline 알고리즘 구현 [중급 · 2.5시간]	미션 3. 다익스트라 기반 최단거리 보급 경로 탐색 1차 Baseline 알고리즘 구현 [중급 · 2.5시간]
목표	다익스트라 알고리즘으로 보급소에서 지원 부대까지 최단시간 경로를 찾는 Baseline과 경로 검증 규칙 엔진을 구현한다.
수행	간선 가중치를 차종별 소요시간으로 두고 통행 불가·하중 초과 구간을 제외해 최단 경로를 구한다. 적재량, 기한, 정비 중 자산, 위협 구역 통과 등 검증 규칙 15종을 설정 문자열로 분리해 코드 수정 없이 바꿀 수 있게 한다. 경계 조건(적재량 한계 정확히 일치, 고립 노드 등) 단위 테스트와 규칙 처리 시간을 측정한다.
산출물	src/engine/mov02_rule_engine.py, 경로 검증 규칙 설정
평가	[필수] Baseline·규칙 엔진 — 검증 규칙 15종 이상, 규칙 처리 지연 50ms 이하, 경계 조건 단위 테스트 100% 통과, Baseline의 한계(위협 구역 통과)를 결과로 제시했는가.

미션 4. 적 위협 반경 회피 및 자산 적재 효율을 고려한 최적 수송 경로 추천 모델 고도화 [중급~고급 · 3시간]	미션 4. 적 위협 반경 회피 및 자산 적재 효율을 고려한 최적 수송 경로 추천 모델 고도화 [중급~고급 · 3시간]
목표	적 위협 반경 회피와 적재 효율(차종 조합)을 함께 고려한 최적 수송 경로 추천 모델로 고도화한다.
수행	간선 비용에 소요시간과 위협 위험 가중치를 함께 넣고, 과거 수송통제관 승인 사례(가상)로 위험 가중치를 학습한다. 검증 사례에서 통제관 선택과의 Top-1 일치도와 Top-3 포함률을 측정하고, 추천 Top-3와 유사도 점수, 추천 사유를 출력한다. 트럭만 배차할 때와 트레일러 조합 배차의 비용·차량 수를 비교한다.
산출물	src/ai/mov02_intelligence_module.py, 추천 일치도 검증표
평가	[선택] 추천 정확도·사유 제시 — 검증 사례 추천 정확도(Top-1 일치도) 85% 이상, Top-3 옵션과 유사도 점수, 기준 경로 대비 추천 사유와 적재 효율 비교가 제시되었는가.

3단계. 수송 신뢰도 점수 산출 및 관제 대시보드 가시화

미션 5. 수송선단 생존 확률 및 정시 도착 신뢰도 점수 산출 엔진 개발 [중급 · 3시간]	미션 5. 수송선단 생존 확률 및 정시 도착 신뢰도 점수 산출 엔진 개발 [중급 · 3시간]
목표	후보 경로마다 수송선단 생존확률과 정시 도착 신뢰도를 계산해 0~100점 신뢰도 점수와 등급을 산출하는 엔진을 개발한다.
수행	위협 구간 통과 수로 생존확률을, 도로 등급·교량 대기·위협 구역 감속을 반영한 몬테카를로 모의로 정시 도착 확률을 구한다. 점수와 등급(신뢰·주의·위험)을 입력-분석-검토-결과 4개 화면으로 나누어 보이고, 상태 뱃지(완료·승인대기·반려)로 걸러 본다. 가상 운행 60건으로 예측 확률의 보정 정도(Brier 점수)를 확인한다.
산출물	src/ui/mov02_app.py, 신뢰도 점수 산출 결과표
평가	[필수] 신뢰도 점수·화면 구성 — 핵심 화면 4종(입력-분석-검토-결과) 구현, 상태별 뱃지·필터 동작, 정시도착 예측의 Brier 점수가 무정보 예측(0.25)보다 낮은가.

미션 6. 전술 수송 경로 및 자산 배정 현황 가시화 2D/3D 수송 관제 대시보드 구현 [중급~고급 · 2.5시간]	미션 6. 전술 수송 경로 및 자산 배정 현황 가시화 2D/3D 수송 관제 대시보드 구현 [중급~고급 · 2.5시간]
목표	수송 요청별 자산 배정과 경로를 관제 대시보드로 가시화하고, 입력 검증기와 에러 처리기로 예외 상황에서도 멈추지 않게 한다.
수행	요청을 적재량에 맞게 트레일러·트럭에 배정하고 경로 지도, 자산 가동률, 운행 일정(지연 표시), 요청별 비용을 2x2 대시보드로 그린다. 필수 항목 누락, 특수문자, 중복 번호, 단위 포함 문자열, 결측, 음수, 없는 목적지, 수송능력 초과, 도달 불가, 자산 부족의 예외 10종을 주입해 오류 코드와 조치 가이드를 기록한다. 일시 장애 재시도와 부분 배정 롤백, 1만 건 대용량 검증을 확인한다.
산출물	src/utils/mov02_validator.py 및 에러 핸들러, 관제 대시보드 화면
평가	[선택] 관제 가시화·예외 처리 — 예외 주입 10종에서 크래시 0건, 에러 로그 기록률 100%, 오류별 조치 가이드 제공, 재시도·롤백 동작과 대시보드 4개 패널이 확인되었는가.

4단계. 수송통제관 승인 체계 및 대규모 차단 스트레스 시험

미션 7. 위험 경로 강행 또는 우회 결정을 위한 수송통제관 HITL 승인 워크플로우 설계 [고급 · 3시간]	미션 7. 위험 경로 강행 또는 우회 결정을 위한 수송통제관 HITL 승인 워크플로우 설계 [고급 · 3시간]
목표	위험 경로 강행 또는 우회를 수송통제관이 직접 승인·반려하는 인간 개입(HITL) 결재 워크플로우를 설계한다.
수행	AI가 제안한 경로는 모두 검토대기로 등록하고, 위협 구역을 지나는 강행 경로는 수송통제관과 상급 통제관 2단계 결재를 거치게 한다. 역할별 권한(요청자·통제관·상급 통제관·감사), 사유 10자 이상 필수, 반려 후 재기안 연결, 승인 후 경로 변경 금지 규칙을 둔다. 권한 우회 시도 10종을 넣어 차단 여부를 확인하고, 해시 체인 감사 로그로 이력 위·변조를 검출한다.
산출물	src/workflow/mov02_approval_system.py, 결재 이력 조회 결과
평가	[필수] 인간 승인·권한 통제 — 자동 승인 0건, 권한 우회 시도 차단율 100%, 반려 사유 필수·재기안 연계, 감사 로그 무결성 100%와 위·변조 검출이 확인되었는가.

미션 8. 도로 50곳 동시 차단 모의 대규모 보급 경로 재탐색 스트레스 테스트 [고급 · 3.5시간]	미션 8. 도로 50곳 동시 차단 모의 대규모 보급 경로 재탐색 스트레스 테스트 [고급 · 3.5시간]
목표	도로 50곳이 동시에 차단되는 상황을 1년치 일괄 배치로 모의해 보급 경로 재탐색의 성능과 안정성을 시험한다.
수행	192개 노드로 확장한 가상 도로망에서 매일 50개 구간을 무작위로 차단하고 365일 x 요청 8건을 자동 재탐색한다. 잘못된 구간 번호와 빈 보고를 주입해 배치가 멈추지 않는지 보고, 진행률과 완료 알림을 출력한다. 실행 시간, 자동화 성공률, 우회로 인한 소요 증가, 수작업 대비 소요 시간을 계산하고 차단 규모(10~150곳)별 한계점을 확인한다.
산출물	src/pipeline/mov02_batch_runner.py, 스트레스 시험 결과표
평가	[선택] 대규모 재탐색 성능 — 전체 배치 실행 시간 5분 이내, 자동화 성공률 99% 이상, 수작업 대비 업무 소요 80% 이상 절감(가정값 근거 명시), 차단 규모별 한계점이 제시되었는가.

5단계. 사후검토 재보정 및 최종 통합

미션 9. AAR 기반 수송 지연 사례 분석 및 경로 위험 가중치 파라미터 재보정 [고급 · 3시간]	미션 9. AAR 기반 수송 지연 사례 분석 및 경로 위험 가중치 파라미터 재보정 [고급 · 3시간]
목표	가상 사후검토(AAR) 수송 기록으로 지연 원인을 분석하고, 소요시간 계수와 위협 구역 위험 가중치를 재보정한다.
수행	AAR 기록 120건의 계획 대비 실제 소요시간을 비교해 비포장 감속, 교량 대기, 위협 구역 검문·감속으로 지연을 분해한다. 학습 80건으로 소요시간 계수를 최소제곱으로 다시 맞추고 검증 40건에서 예측 오차와 기한 초과 판정 정확도를 비교한다. 구역별 피해·중단 보고로 위험 가중치를 베이지안 방식으로 갱신하고, UAT 점검표 점수와 개선 요구 반영 내역을 정리한다.
산출물	docs/mov02_uat_feedback_report.md 및 패치 내역
평가	[필수] AAR 원인분석·재보정 — UAT 점검표 90점 이상, 개선 요구 5건 반영, 재보정 후 소요시간 예측 오차 감소와 위험 가중치 갱신 근거가 제시되었는가.

미션 10. 전장 수송 자산 동적 배정 및 최적 보급 경로 추천 시스템 최종 완성 [최고급 · 3시간]	미션 10. 전장 수송 자산 동적 배정 및 최적 보급 경로 추천 시스템 최종 완성 [최고급 · 3시간]
목표	환경 점검부터 제약 반영, 경로 추천, 자산 동적 배정, 승인 대기 분리, 실적·비용 집계까지 한 번에 실행되는 통합 시스템을 완성한다.
수행	하루 동안 시간 차를 두고 들어오는 수송 요청 14건을 가용 시각이 이른 자산부터 배정하고, 재보정된 계수와 위험 가중치로 경로를 고른다. 도로로 갈 수 없는 요청은 공중수송 대안으로, 위험·고비용 건은 통제관 승인대기로 분리한다. 최단시간·트럭 전용 기준선과 수송량, 톤km당 비용, 정시율, 리드타임, 생존확률을 비교하고 자체 점검표, 매뉴얼 목차, 브리핑 요약을 출력한다.
산출물	dist/mov02_package/, README.md, docs/mov02_final_manual.md
평가	[필수] 통합 실행·자체 점검 — 설치 점검부터 결과 출력까지 한 번에 실행되고, 자체 점검 전 항목 PASS, 매뉴얼 작성률 100%, 기준선 대비 실적·비용 지표 개선이 브리핑으로 정리되었는가.

최종 판정

판정 기준 : 모든 필수 항목([필수])에서 PASS를 받아야 최종 PASS로 인정한다.

최종 판정 결과 : ( PASS / FAIL )

평가 의견 : (필수 항목 중 하나라도 FAIL인 경우 사유를 기재한다.)