**군수데이터 전략기획·환경평가 대시보드**

난 이 도 **중급**

| **프로젝트 목표** | 미국 국방부(DoD)는 군수 데이터 전략과 환경 평가를 통해 서로 다른 체계에 흩어진 데이터의 중복을 없애고 표준 키와 코드를 정해 업무 중심으로 통합하려는 접근을 공개해 왔다. 이 사례의 학습 초점은 중복 제거, 표준 키·코드, 업무 중심 통합, 역할별 화면, 자동 갱신, 재사용성이다. 본 프로젝트는 이를 바탕으로 교육용 가상 보급·정비·탄약 체계 3종의 재고 보고를 코드로 만들어 통합 대시보드로 가시화한다. 학습자는 연동 규격 분석, 코드 표준화와 결측 전처리, 통합 저장소와 검증 룰, 변경 이벤트 동기화, 불일치 식별과 품질 지수, 역할별 상황판, 데이터관리관 승인, 대량 트랜잭션 시험, AAR 재튜닝, 최종 통합을 차례로 수행한다. 최종 목표는 마스터 데이터의 확정은 사람이 승인하도록 하면서 이기종 군수 정보를 한 화면에서 보는 통합 군수 상황판을 완성하는 것이다. |
| --- | --- |

| **유의사항** | 모든 체계, 부대, 품목, 재고 수량과 코드 형식은 코드 안에서 만든 교육용 가상 자료이며 실제 군수 정보체계의 명칭·구조·데이터, 부대명, 보유 수량, 작전 정보는 사용하지 않는다. 부대 내 촬영이나 부대 자료의 외부 AI 서비스 입력은 금지한다. 스트리밍은 외부 도구 없이 메모리 안의 큐로 모의하며, 마스터 데이터의 확정과 실제 연동은 데이터관리관 승인과 부대 지침에 따른다. 수작업 소요시간과 절감률은 교육용 가정값이다. 미션별 정답 코드는 각각 한 파일로 독립 실행된다. |
| --- | --- |

**1단계. 연동 규격 분석 및 데이터 표준화 전처리**

| **미션 1. 이기종 군수 정보체계(DELIIS, 장비정비정보체계, 탄약체계) 데이터 연동 규격 분석** [초급 · 1.5시간] | **미션 1. 이기종 군수 정보체계(DELIIS, 장비정비정보체계, 탄약체계) 데이터 연동 규격 분석** [초급 · 1.5시간] |
| --- | --- |
| **목표** | 이기종 군수 정보체계 3종의 품목코드·부대코드·날짜·수량 연동 규격을 비교 분석하고, 통합 군수 상황 파악 업무를 AS-IS/TO-BE로 비교한다. |
| **수행** | 가상의 보급·정비·탄약 체계가 같은 재고를 서로 다른 코드와 날짜 형식으로 보고하는 자료를 코드로 만든다. 체계별 필드 형식, 갱신 주기, 결측 표기를 비교표로 정리하고 코드 변환 규칙이 키로 정확히 되돌아오는지 검증한다. 자료 조회부터 보고 후 수정까지 현행 업무를 10단계 이상으로 분해해 병목 구간을 표시하고 TO-BE 절차와 비교한다. |
| **산출물** | docs/dat09_as_is_to_be_spec.md, 연동 규격 비교표 |
| **평가** | **[필수] 업무 분해·연동 규격 분석** — 업무 단계 10단계 이상, 병목 구간 3개소 이상을 도출하고, 체계별 연동 규격과 AS-IS/TO-BE 비교가 명확하게 작성되었는가. |

| **미션 2. 서로 다른 부품코드, 부대코드, 날짜 포맷 통합 및 결측 데이터 전처리 파이프라인 구축** [초급~중급 · 2시간] | **미션 2. 서로 다른 부품코드, 부대코드, 날짜 포맷 통합 및 결측 데이터 전처리 파이프라인 구축** [초급~중급 · 2시간] |
| --- | --- |
| **목표** | 체계마다 다른 파일 형식(CSV, JSON, 탭 구분 엑셀 내보내기)과 품목코드·부대코드·날짜 형식을 표준 키로 통합하고 결측 데이터를 전처리하는 파이프라인을 구축한다. |
| **수행** | 세 체계의 가상 보고를 메모리 안의 문자열로 만들어 형식별 파서로 읽고, 머리글 별칭 사전으로 양식 변경에 대응한다. 품목·부대 코드와 날짜를 표준 형식으로 바꾸고, 형식 오류 레코드는 반영을 보류한다. 결측값은 다른 체계 값을 바탕으로 후보값을 채우되 확정값이 아님을 표시한다. |
| **산출물** | src/connectors/dat09_data_loader.py 및 스키마 정의서 |
| **평가** | **[필수] 다형식 통합·결측 전처리** — 지원 형식(CSV, Excel 내보내기, JSON) 파싱 성공률 100%, 코드·날짜 표준화, 결측 전처리, 양식 변경 대응이 확인되었는가. |

**2단계. 통합 저장소 구축 및 실시간 동기화·원인 추천**

| **미션 3. 통합 데이터베이스 1차 구축 및 핵심 군수 지표 집계 Baseline 쿼리 모듈 구현** [중급 · 2.5시간] | **미션 3. 통합 데이터베이스 1차 구축 및 핵심 군수 지표 집계 Baseline 쿼리 모듈 구현** [중급 · 2.5시간] |
| --- | --- |
| **목표** | 세 체계의 표준화 재고를 통합 데이터 저장소에 구축하고, 검증 룰 15종과 핵심 군수 지표 집계 Baseline 쿼리를 구현한다. |
| **수행** | 표준화한 2,160건을 하나의 표로 쌓아 통합 저장소로 삼고, 룰 15종을 가상 조항 번호가 붙은 설정 문자열로 분리해 위반 건수와 처리 지연시간을 측정한다. 분류별 재고 합계, 재고 부족 품목, 체계 간 일치율을 구하는 쿼리 함수를 만들고, 경계 조건 단위 테스트를 수행한다. |
| **산출물** | src/engine/dat09_rule_engine.py |
| **평가** | **[필수] 통합 저장소·룰 엔진** — 검증 룰 15종 이상, 룰 처리 지연 50ms 이하, 경계 조건 단위 테스트 100% 통과, 핵심 지표 쿼리가 규정(가상 조항)과 일치하는가. |

| **미션 4. 실시간 데이터 스트리밍(Kafka/CDC) 기반 이기종 데이터 정합성 유지 및 자동 동기화 고도화** [중급~고급 · 3시간] | **미션 4. 실시간 데이터 스트리밍(Kafka/CDC) 기반 이기종 데이터 정합성 유지 및 자동 동기화 고도화** [중급~고급 · 3시간] |
| --- | --- |
| **목표** | 변경 이벤트 스트림(CDC 방식을 메모리에서 모의)으로 체계 간 정합성을 유지하고 불일치 원인을 분류해 마스터 값 후보를 추천하는 모듈을 고도화한다. |
| **수행** | 외부 스트리밍 도구 없이 메모리 안의 큐로 변경 이벤트를 만들고, 중복 전송과 순서가 뒤바뀐 오래된 값이 섞인 상태에서 이벤트 ID 중복 제거와 키별 최신 시각 우선 규칙으로 동기화한다. 일괄 스냅샷과 결과가 같은지 검증하고, 불일치를 결측, 단위 오류, 반영 지연, 입력 오류로 분류해 다수값을 마스터 후보로 추천한다. |
| **산출물** | src/ai/dat09_intelligence_module.py |
| **평가** | **[선택] 스트림 동기화·원인 추천** — 추천/분류 정확도 85% 이상이며, 스트림 동기화 결과가 일괄 결과와 일치하고 추천 사유가 실무자가 수용할 수 있게 합리적인가. |

**3단계. 불일치 식별·품질 지수 및 통합 군수 상황판**

| **미션 5. 체계 간 불일치 데이터 자동 식별 및 데이터 신뢰도 품질 지수 산출 엔진 개발** [중급 · 3시간] | **미션 5. 체계 간 불일치 데이터 자동 식별 및 데이터 신뢰도 품질 지수 산출 엔진 개발** [중급 · 3시간] |
| --- | --- |
| **목표** | 체계 간 불일치 데이터를 자동 식별하고 데이터 품질 지수를 산출하는 엔진을 입력-분석-검토-결과 4개 화면으로 구현한다. |
| **수행** | 키별로 세 체계의 값을 비교해 값 불일치와 결측을 식별하고 편차가 큰 건을 우선 검토 대상으로 표시한다. 완전성, 일치성, 적시성, 유효성 4개 차원을 가중 합산해 체계별·부대별 품질 지수를 계산한다. 입력, 분석, 검토, 결과의 4개 화면을 텍스트 화면으로 출력한다. |
| **산출물** | src/ui/dat09_app.py |
| **평가** | **[필수] 불일치 식별·품질 지수** — 핵심 화면 4종(입력-분석-검토-결과) 구현을 완료하고, 불일치 식별과 품질 지수가 근거와 함께 표시되어 실무자가 조작하기 편한가. |

| **미션 6. 지휘관 및 군수참모용 통합 군수 상황판(Logistics COP) 실시간 대시보드 구현** [중급~고급 · 2.5시간] | **미션 6. 지휘관 및 군수참모용 통합 군수 상황판(Logistics COP) 실시간 대시보드 구현** [중급~고급 · 2.5시간] |
| --- | --- |
| **목표** | 지휘관과 군수참모가 보는 통합 군수 상황판(Logistics COP)을 시간별 갱신 방식으로 구현하고, 예외 상황에서도 중단되지 않는 에러 처리를 갖춘다. |
| **수행** | 변경 이벤트를 1시간 단위로 반영해 총재고, 분류별 재고, 부족 경보를 갱신하고 지휘관용 요약 화면과 군수참모용 상세 화면을 구분해 보여 준다. 입력 검증기와 에러 핸들러로 필수 항목 누락, 중복 이벤트, 증감량 과대, 재고 음수화, 권한 없는 역할 등 예외 10종을 주입해 크래시 없이 기록하고 조치를 안내한다. |
| **산출물** | src/utils/dat09_validator.py 및 에러 핸들러 |
| **평가** | **[선택] 상황판·에러 처리** — 예외 상황 10종에서 크래시 0건, 에러 로그 기록률 100%이며, 오류 메시지가 원인과 조치를 알기 쉽게 안내하는가. |

**4단계. 마스터 데이터 승인 체계 및 대량 트랜잭션 부하 시험**

| **미션 7. 체계 간 데이터 충돌 시 마스터 데이터 확정을 위한 데이터관리관 HITL 승인 설계** [고급 · 3시간] | **미션 7. 체계 간 데이터 충돌 시 마스터 데이터 확정을 위한 데이터관리관 HITL 승인 설계** [고급 · 3시간] |
| --- | --- |
| **목표** | 체계 간 데이터 충돌 시 시스템은 후보만 제안하고 데이터관리관 승인으로만 마스터 데이터를 확정하는 사람 승인 체계를 설계한다. |
| **수행** | 충돌 건마다 다수값 후보와 근거를 제안으로 등록하고, 데이터관리관이 근거를 적어 승인하거나 반려하게 한다. 수량 차이가 큰 고영향 건은 군수참모 확인을 먼저 받아야 한다. 자동 확정, 제안자 본인 승인, 권한 없는 역할의 승인 등 우회 시도 10종을 차단하고 모든 처리를 해시 체인 감사 이력에 남겨 변조 시 탐지되는지 확인한다. |
| **산출물** | src/workflow/dat09_approval_system.py |
| **평가** | **[필수] 마스터 확정 HITL 승인** — 이력 기록 무결성 100%, 승인 권한 우회 시도 차단율 100%이며 자동 확정 없이 군 보안·행정 절차에 부합하는 승인 흐름이 구현되었는가. |

| **미션 8. 수만 건의 이기종 군수 트랜잭션 동시 유입 시뮬레이션 부하 테스트** [고급 · 3.5시간] | **미션 8. 수만 건의 이기종 군수 트랜잭션 동시 유입 시뮬레이션 부하 테스트** [고급 · 3.5시간] |
| --- | --- |
| **목표** | 세 체계에서 수만 건의 트랜잭션이 뒤섞여 유입되는 상황을 모의해 부하 테스트를 수행한다. |
| **수행** | 체계별 코드 형식이 다른 트랜잭션 5천~5만 건을 만들고 중복 1%, 형식 오류 0.4%, 일시 장애를 주입한다. 마이크로 배치로 표준화·중복 제거·오류 격리·반영을 수행하고 규모별 처리 시간, 일괄 계산과의 정합성, 자동화 성공률을 측정한다. 수작업 소요시간 가정값과 비교해 절감률을 계산한다. |
| **산출물** | src/pipeline/dat09_batch_runner.py |
| **평가** | **[선택] 대량 트랜잭션 부하 시험** — 전체 배치 파이프라인 실행 시간 5분 이내, 자동화 성공률 99% 이상, 수작업 대비 업무 소요 시간 80% 이상 절감(가정값 명시)이 확인되는가. |

**5단계. AAR 매핑 재튜닝 및 통합 상황판 최종 완성**

| **미션 9. AAR 기반 데이터 연동 누락 분석 및 매핑 테이블 파라미터 재튜닝** [고급 · 3시간] | **미션 9. AAR 기반 데이터 연동 누락 분석 및 매핑 테이블 파라미터 재튜닝** [고급 · 3시간] |
| --- | --- |
| **목표** | AAR에서 드러난 데이터 연동 누락 5유형을 재현·분석하고 매핑 규칙과 판정 파라미터를 재튜닝한다. |
| **수행** | 코드 자릿수, 부대명, 날짜 형식, 결측 표기, 신규 품목의 5유형 변형을 가상 보고에 심어 매핑 v1의 누락을 재현한다. 규칙을 보정한 v2와 허용 오차·허용 지연 일수를 격자 탐색으로 재튜닝한 결과를 가상 정답 대비 F1로 비교하고, 자동 UAT 체크리스트로 재검증한다. |
| **산출물** | docs/dat09_uat_feedback_report.md 및 패치 내역 |
| **평가** | **[필수] 연동 누락 분석·재튜닝** — UAT 체크리스트 90점 이상, 개선 요구 5건 반영 완료이며 매핑 보정 후 연동 누락이 0건으로 확인되는가. |

| **미션 10. 이기종 군수 정보체계 데이터 통합 및 실시간 가시화 대시보드 최종 완성** [최고급 · 3시간] | **미션 10. 이기종 군수 정보체계 데이터 통합 및 실시간 가시화 대시보드 최종 완성** [최고급 · 3시간] |
| --- | --- |
| **목표** | 수집부터 불일치 식별, 품질 지수, 마스터 승인 대기 분리, 상황판 가시화까지 한 번에 실행되는 통합 군수 상황판 도구를 완성한다. |
| **수행** | 환경 점검 후 세 체계 자료를 수집·표준화하고 불일치를 식별해 품질 지수를 계산한다. 마스터 후보는 모두 데이터관리관 승인 대기로 분리해 자동 확정하지 않는다. 분류별·부대별 재고 상황판 그래프와 설치 스크립트 개요, 9장 매뉴얼 목차, 자체 점검표, 브리핑 요약을 출력한다. |
| **산출물** | dist/dat09_package/, README.md, docs/dat09_final_manual.md |
| **평가** | **[필수] 원클릭 통합·상황판** — 설치부터 실행까지 원클릭 절차가 완비되고 매뉴얼 작성률 100%이며, 자체 점검 전 항목 PASS와 업무 시간 절감 효과가 브리핑으로 정리되었는가. |

**최종 판정**

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

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

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