pbl02/scenario_md/PRC07-조달·계약·국산화_부품국산화-데이터 기반 부품 국산화 후보 자동추천 Tool/PRC07-조달·계약·국산화_부품국산화-데이터 기반 부품 국산화 후보 자동추천 Tool.md

**데이터 기반 부품 국산화 후보 자동추천 Tool**

난 이 도 **고급**

| **프로젝트 목표** | 무기체계 부품은 해외 의존도가 높고 공급선이 하나뿐이거나 단종(DMSMS) 공고가 나오면 조달이 막히기 쉬운데, 위험 신호를 사람이 문서와 전화로 모으면 국산화 후보를 찾기까지 수개월이 걸린다. 본 프로젝트는 부품 공급망 자료에서 조달 병목과 위험 신호를 찾고 국산화 대체 후보를 자동으로 추천하는 도구를 만드는 과제로, 업무 단계별 병목과 위험 신호 기준, 추천 수정안, 계약 의뢰 근거와 변경 이력, 업무 효과 측정까지 한 흐름으로 구현한다. 교육용 가상 부품 100종과 가상 국가·가상 업체 자료로 공급망 데이터 스키마 정의, 공급업체 자료 정제와 단종 공고 파싱, 룰 기반 조달 위험 스크리닝, 텍스트 유사도와 지식 그래프를 쓴 대체 부품 추천, 붕괴 위험도와 조기경보, 위험 지도 대시보드와 오류 처리, 규격 검토와 승인 HITL 워크플로우, 공급망 차단 스트레스 시험, AAR 가중치 재보정, 통합 패키지까지 단계별로 만든다. 최종 목표는 위험 부품을 조기에 찾아 국산화 후보를 근거와 함께 제시하되, 규격 적합성 판단과 조달 승인은 담당자가 하도록 지원하는 도구를 완성하는 것이다. |
| --- | --- |

| **유의사항** | 모든 부품·업체·국가·단가·납기 자료는 코드 안에서 만든 교육용 가상 자료이며 실제 무기체계, 부품 번호, 업체, 국가, 계약 정보는 사용하지 않는다. 부대·기관 자료의 외부 AI 서비스 입력과 부대 내 촬영은 금지한다. 추천과 위험 점수는 판단 보조 정보이며 규격 적합성 최종 판단, 보안 검토, 조달 승인은 기술검토관·보안담당·승인권자가 수행한다. 룰과 대응시킨 지침 조항은 연결 방식을 보이기 위한 가상 예시이며 실제 규정 원문이 아니다. 미션별 정답 코드는 각각 한 파일로 독립 실행된다. |
| --- | --- |

**1단계. 공급망 데이터 정의 및 공급업체·단종 공고 전처리**

| **미션 1. 무기체계 핵심 부품 공급망(단종 부품, 해외 의존도, 리드타임) 데이터셋 스키마 정의** [초급 · 1.5시간] | **미션 1. 무기체계 핵심 부품 공급망(단종 부품, 해외 의존도, 리드타임) 데이터셋 스키마 정의** [초급 · 1.5시간] |
| --- | --- |
| **목표** | 무기체계 부품 공급망(단종 부품, 해외 의존도, 리드타임) 자료의 스키마와 입출력 명세를 정의하고, 현행(AS-IS) 국산화 후보 선정 업무를 단계로 나누어 병목을 찾는다. |
| **수행** | 부품 식별, 공급망(공급선 수, 해외 의존, 리드타임, 납기 지연), 단종 상태(최종구매 잔여 개월), 조달 속성(재고, 수요, 불량률, 수출 허가)을 묶어 필드 16개의 스키마와 검증 규칙을 만든다. 가상 부품 100건을 검증하고 형식·허용값·범위·자료형·논리 규칙 위반 오류를 일부러 넣어 검출되는지 확인한다. 국산화 후보 선정 업무를 12단계로 분해해 단계별 작업일과 대기일을 계산하고, 자동화할 수 있는 단계와 사람이 판단해야 하는 단계를 나눈 TO-BE 안을 비교한다. |
| **산출물** | docs/prc07_as_is_to_be_spec.md, 입출력 데이터 명세 |
| **평가** | **[필수] AS-IS/TO-BE 업무 분해** — 업무 단계 10단계 이상 분해, 병목 구간 3개소 이상 도출, 정상 샘플 검증 오류 0건, AS-IS와 TO-BE 비교가 단계별로 명확한가. |

| **미션 2. 국내외 공급업체 데이터 정제, 부품 단종(DMSMS) 공고 파싱 전처리 모듈 구현** [초급~중급 · 2시간] | **미션 2. 국내외 공급업체 데이터 정제, 부품 단종(DMSMS) 공고 파싱 전처리 모듈 구현** [초급~중급 · 2시간] |
| --- | --- |
| **목표** | 국내외 공급업체 자료의 표기 차이를 정제하고 서식이 다른 부품 단종(DMSMS) 공고문에서 필요한 항목을 추출하는 전처리 모듈을 구현한다. |
| **수행** | CSV, 엑셀 내보내기 형태(탭 구분), JSON 세 형식의 공급업체 자료를 열 이름 별칭 사전으로 하나의 표준 스키마로 바꾸고, 업체명 표기와 국가 코드, 리드타임 단위(일·주·개월·년), 날짜 형식을 통일한다. 서식이 서로 다른 단종 공고문 5건에서 부품번호, 단종일, 최종구매(LTB) 기한, 대체품을 정규식으로 추출한다. 열 이름이 바뀐 새 양식을 넣어 실패를 확인한 뒤 별칭 사전만 고쳐 코드 수정 없이 처리되는지 확인한다. |
| **산출물** | src/connectors/prc07_data_loader.py 및 스키마 정의서 |
| **평가** | **[필수] 자료 정제·공고 파싱** — CSV·탭 구분(엑셀 내보내기)·JSON·공문 텍스트 파싱 성공률 100%, 중복 업체 정리, 새 서식을 설정 변경만으로 처리하는 확장성을 확인했는가. |

**2단계. 조달 위험 스크리닝 룰 및 대체 부품 추천 모델**

| **미션 3. 공급선 단일화 및 납기 지연 이력 기반 1차 조달 위험 스크리닝 알고리즘 구현** [중급 · 2.5시간] | **미션 3. 공급선 단일화 및 납기 지연 이력 기반 1차 조달 위험 스크리닝 알고리즘 구현** [중급 · 2.5시간] |
| --- | --- |
| **목표** | 공급선 단일화와 납기 지연 이력 등을 점검하는 조달 위험 룰 15종 이상을 코딩해 부품별 1차 스크리닝 등급을 산출한다. |
| **수행** | 단일 공급선, 해외 의존, 리드타임 초과, 납기 지연률, 단종 예고·확정, 최종구매 임박, 단가 급등, 재고 가용기간 부족 등 16종 룰을 YAML 설정으로 두고 가중치 합으로 고위험·주의·관심 등급을 낸다. 각 룰에 가상 지침 조항을 연결해 판정 근거를 보이고, 레코드 1건당 처리 지연시간을 측정한다. 다음 12개월 실제 단절 여부와 등급을 비교해 탐지력을 점검하고, 리드타임 기준을 바꿔 코드 수정 없이 결과가 달라지는지 확인한다. |
| **산출물** | src/engine/prc07_rule_engine.py |
| **평가** | **[필수] 조달 위험 룰 스크리닝** — 룰 15종 이상, 처리 지연시간 50ms 이하, 룰별 근거 조항 연결, 등급별 실제 단절률 차이와 재현율을 제시하고 설정 변경으로 룰을 바꿀 수 있는가. |

| **미션 4. NLP 및 지식 그래프 기반 대체 가능 호환 부품(Alternative Parts) 자동 추천 모델 고도화** [중급~고급 · 3시간] | **미션 4. NLP 및 지식 그래프 기반 대체 가능 호환 부품(Alternative Parts) 자동 추천 모델 고도화** [중급~고급 · 3시간] |
| --- | --- |
| **목표** | 텍스트 유사도와 지식 그래프, 규격 적합성을 결합해 해외 부품별 국산 대체 후보를 추천하고 추천 근거를 제시한다. |
| **수행** | 부품 설명문의 TF-IDF 유사도, 전압·전력·온도·크기·인터페이스 6개 규격 적합성, 동의어를 간선으로 연결한 지식 그래프 이웃 유사도를 가중합해 부품별 Top-3 후보를 만든다. 과거 승인된 국산 대체품을 정답으로 삼아 Top-1·Top-3 정확도를 계산하고, 신호별로 하나씩만 쓸 때와 비교한다. 1순위 오추천 사례를 원인별로 보고 추천 사유 문장(점수 구성과 미충족 규격)을 만든다. |
| **산출물** | src/ai/prc07_intelligence_module.py |
| **평가** | **[선택] 대체 부품 추천 모델** — 추천 정확도(Top-1) 85% 이상, 신호별 기여 비교, 규격 불일치 후보가 1순위가 되지 않는지, 추천 사유가 실무자가 읽을 수 있는 문장으로 제시되는가. |

**3단계. 붕괴 위험도 조기경보 및 위험 지도 대시보드**

| **미션 5. 공급망 붕괴 위험도(Supply Chain Risk Score) 및 조기경보 산출 엔진 개발** [중급 · 3시간] | **미션 5. 공급망 붕괴 위험도(Supply Chain Risk Score) 및 조기경보 산출 엔진 개발** [중급 · 3시간] |
| --- | --- |
| **목표** | 공급망 붕괴 위험도(Supply Chain Risk Score)와 월별 지연 추이 기반 조기경보를 산출하는 엔진을 만들고 입력-분석-검토-결과 4개 화면으로 구성한다. |
| **수행** | 공급선 수, 해외 조달, 리드타임, 납기 지연률, 단종 상태 등 12개 지표로 로지스틱 회귀 위험도(0~100점)를 학습하고 별도 가상 부품군에서 AUC와 등급별 실제 단절률을 확인한다. 월별 납기 지연일에 EWMA 관리도를 적용해 지연이 서서히 늘기 시작한 부품을 조기경보하고 감지율·경보 지연·오경보율을 측정한다. 입력 요약, 분석(분포·요인), 검토(경보 부품과 근거), 결과(요약·내보내기)의 4개 화면을 텍스트 패널과 그래프로 구성한다. |
| **산출물** | src/ui/prc07_app.py |
| **평가** | **[필수] 위험도·조기경보 엔진** — 핵심 화면 4종(입력-분석-검토-결과) 구현, 별도 검증 부품군에서 위험도 성능 제시, 조기경보 감지율과 오경보율을 측정했는가. |

| **미션 6. 부품 조달 위험 공급망 지도 및 대체선 추천 인터랙티브 대시보드 구현** [중급~고급 · 2.5시간] | **미션 6. 부품 조달 위험 공급망 지도 및 대체선 추천 인터랙티브 대시보드 구현** [중급~고급 · 2.5시간] |
| --- | --- |
| **목표** | 부품 조달 위험 공급망 지도와 대체선 추천 대시보드에 입력 검증과 에러 핸들러를 붙여 깨진 입력에도 멈추지 않게 한다. |
| **수행** | 국가와 부품 범주별 평균 위험을 보이는 공급망 지도, 리드타임과 지연률 산점도, 위험 상위 부품의 대체 후보 규격 적합성 패널을 가진 대시보드를 만든다. 입력 읽기와 행 단위 검증기를 두고 문제 행은 격리하며 나머지로 계속 진행한다. 빈 입력, 깨진 JSON, 필수 열 누락, 숫자 열 문자, 음수 값, 극단값 등 16종 입력을 넣어 크래시 0건과 에러 로그 기록, 사용자용 메시지와 조치 안내를 확인한다. |
| **산출물** | src/utils/prc07_validator.py 및 에러 핸들러 |
| **평가** | **[선택] 대시보드·에러 핸들러** — 예외 상황에서 크래시 0건, 에러 로그 기록률 100%, 오류마다 알기 쉬운 메시지와 조치 가이드가 제공되는가. |

**4단계. 규격 검토·승인 HITL 및 공급망 차단 스트레스 시험**

| **미션 7. 추천된 대체 부품의 규격 적합성 검토 및 조달 승인을 위한 HITL 워크플로우 설계** [고급 · 3시간] | **미션 7. 추천된 대체 부품의 규격 적합성 검토 및 조달 승인을 위한 HITL 워크플로우 설계** [고급 · 3시간] |
| --- | --- |
| **목표** | 추천된 대체 부품의 규격 적합성 검토와 조달 승인을 위한 HITL 워크플로우를 설계하고 이력 무결성과 권한 통제를 검증한다. |
| **수행** | 시스템 제안, 조달담당 상신, 기술검토관 규격 검토, 보안담당 검토, 승인권자 결재의 순서를 상태 기계로 구현하고 역할별 권한을 최소로 둔다. 각 단계는 사유와 근거 입력을 필수로 하고, 필수 규격 미충족이나 보안 확인 미완료 건은 반려하며 무응답은 보류로 두어 자동 확정하지 않는다. 시스템 자동 승인, 단계 건너뛰기, 상신자 본인 승인, 로그 삭제 등 우회 시도 9종이 차단되는지 확인하고 해시 체인 감사 로그의 임의 수정 탐지를 점검한다. |
| **산출물** | src/workflow/prc07_approval_system.py |
| **평가** | **[필수] 규격 검토·승인 HITL** — 이력 기록 무결성 100%, 승인 권한 우회 시도 차단율 100%, 자동 확정 0건, 군 보안·행정 절차에 맞는 검토 순서와 사유 기록을 갖추었는가. |

| **미션 8. 지정학적 위기 모의 글로벌 공급망 전면 차단 스트레스 시뮬레이션** [고급 · 3.5시간] | **미션 8. 지정학적 위기 모의 글로벌 공급망 전면 차단 스트레스 시뮬레이션** [고급 · 3.5시간] |
| --- | --- |
| **목표** | 가상 공급국 전면 차단을 모의한 스트레스 시뮬레이션으로 배치 파이프라인의 실행 시간, 안정성, 업무 시간 절감 효과를 검증한다. |
| **수행** | 평시, 가상국가 A 차단, A+B 차단, 해외 전면 차단 4개 시나리오를 부품 2,000종 규모로 실행해 단절 부품, 국산 대체 후보 보유, 업체 수용량을 고려한 분기 내 착수 가능 건수, 핵심 부품 착수 대기, 재고 90일 미만 단절을 계산한다. 레코드 손상 2%와 일시 오류 3%를 주입해 재시도와 격리로 자동화 성공률을 구하고, 규모를 4,000종까지 늘려 실행 시간을 본다. 시간 예산을 초과하면 후보 탐색을 생략하고 룰 스크리닝만 유지하는 기능 축소 동작을 확인하며, 가정 단가로 수작업 대비 시간 절감을 계산한다. |
| **산출물** | src/pipeline/prc07_batch_runner.py |
| **평가** | **[선택] 공급망 차단 스트레스 시험** — 전체 배치 실행 5분 이내, 자동화 성공률 99% 이상, 수작업 대비 소요 시간 80% 이상 절감(가정 단가 명시), 과부하 시 기능 축소가 작동하는가. |

**5단계. AAR 가중치 재보정 및 통합 패키지 완성**

| **미션 9. AAR 기반 대체선 오추천 사례 분석 및 부품 유사도 매칭 가중치 재보정** [고급 · 3시간] | **미션 9. AAR 기반 대체선 오추천 사례 분석 및 부품 유사도 매칭 가중치 재보정** [고급 · 3시간] |
| --- | --- |
| **목표** | AAR로 대체선 오추천 사례를 분석하고 매칭 가중치를 재보정하되 별도 검증 세트로 개선 여부를 확인한다. |
| **수행** | 현장 모의 AAR 세트에서 1순위 오추천을 원인별(후보 충돌, 크기 편차 감점 등)로 분류하고, 가중치 재보정, 정밀 규격 항목 추가, 후보 1:1 배정, 근소 차이 검토 표시를 개선안으로 시험한다. 각 개선안은 AAR 세트로 설계하고 서로 다른 검증 세트에서 확인해 채택·보류·기각을 정한다. UAT 체크리스트 10개 항목을 측정값으로 채점하고 개선 요구 5건의 반영 여부를 점검한다. |
| **산출물** | docs/prc07_uat_feedback_report.md 및 패치 내역 |
| **평가** | **[필수] AAR·가중치 재보정** — UAT 체크리스트 90점 이상, 개선 요구 5건 반영, 개선 전후를 검증 세트에서 비교하고 채택·기각 사유와 한계를 기록했는가. |

| **미션 10. 무기체계 부품 조달 조기경보 및 대체 공급선 추천 시스템 통합 패키지 완성** [최고급 · 3시간] | **미션 10. 무기체계 부품 조달 조기경보 및 대체 공급선 추천 시스템 통합 패키지 완성** [최고급 · 3시간] |
| --- | --- |
| **목표** | 무기체계 부품 조달 위험 조기경보와 대체 공급선 추천 기능을 하나의 통합 패키지로 완성한다. |
| **수행** | 입력 검증, 룰 스크리닝, 위험도와 조기경보, 대체 후보 추천과 1:1 배정, 검토 큐와 해시 체인 감사 로그를 한 파일의 파이프라인으로 묶는다. 서로 다른 가상 부품군 4종으로 End-to-End 실행과 자체 점검 8항목, 함수 호출 추적 기반 커버리지를 측정하고, 원클릭 설치 스크립트 5단계와 매뉴얼 7개 장의 작성률을 점검한다. 마지막으로 조달 담당자용 브리핑 요약을 출력한다. |
| **산출물** | dist/prc07_package/, README.md, docs/prc07_final_manual.md |
| **평가** | **[필수] 통합 패키지 완성** — 원클릭 설치부터 실행까지 5단계 점검 통과, 매뉴얼 작성률 100%, End-to-End 성공, 자체 점검과 커버리지 기준 충족, 모든 추천이 사람 검토 대기 상태인가. |

**최종 판정**

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

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

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