production-report

name	production-report
description	생산실적 집계 자동화 — BI 실적 + 임률단가 + 조립비 API → 생산관리 마스터리스트 자동 생성

생산실적 집계 자동화 스킬

목적

BI 실적 데이터, 임률단가, 조립비 시스템 API를 자동으로 합쳐서 생산관리_마스터리스트.xlsx를 생성한다.

실행 스크립트

05_생산실적/_자동화/build_master.py

PYTHONUTF8=1 python build_master.py

입력 데이터

입력	경로	설명
BI 실적	05_생산실적/BI실적/대원테크_라인별 생산실적_BI.xlsx	경로 원본: production-result-upload SKILL.md 0단계
임률단가	02_급여단가/임률단가/03_대원테크/임률단가_대원테크_독립계산.xlsx	단가 기준
조립비 API	http://ax.samsong.com:33200/api/assembly-cost-operation	조립비 시스템 실시간 데이터
라인 API	http://ax.samsong.com:33200/api/line-operation	라인 운영 데이터

출력

05_생산실적/생산관리_마스터리스트.xlsx

선행 작업

• BI 실적 파일 최신본 확인 (production-result-upload SKILL.md 0단계에서 자동 갱신)
• 임률단가 파일 최신본 확인

관련 스크립트

스크립트	역할
(폐지됨)	BI 파일 갱신은 production-result-upload SKILL.md 0단계에서 처리

실패 조건

다음 중 하나라도 해당하면 실행 실패로 판정한다:

조건	판정
BI 실적 파일 열기 실패 (경로 없음/형식 불일치)	FAIL
임률단가 파일 열기 실패	FAIL
조립비 API(ax.samsong.com:33200) 무응답	FAIL
build_master.py 실행 에러 (Python/의존성 문제)	FAIL
출력 마스터리스트 행 수 0건	FAIL

중단 기준

다음 상황에서는 즉시 중단하고 사용자에게 보고한다:

1. BI 실적 컬럼 구조 변경 감지 — 매핑 불일치
2. 임률단가 파일에 단가 0원 또는 빈값 행 존재 — 데이터 미완성
3. API 응답 스키마 변경 — 필드명 불일치

검증 항목

실행 완료 후 반드시 확인:

• 출력 마스터리스트 행 수 = BI 실적 대상 행 수
• 단가 컬럼에 0원/빈값 없음
• API 데이터와 마스터리스트 합계 일치
• 파일명/경로가 기존 규칙 준수

되돌리기 방법

범위	방법
출력 파일	마스터리스트 삭제 후 build_master.py 재실행
입력 데이터	원본 미수정 — 복원 불필요

금지사항

• build_master.py 출력 파일을 직접 수정하지 않는다 (재실행 시 덮어씀)
• BI 원본 파일 구조를 임의 변경하지 않는다
• 임률단가 파일의 단가 컬럼을 검증 없이 수정하지 않는다