🗂 설계 — 한샘 생산비 거래명세서 양식 해부 · 파싱 규약

정본 양식 = 1.생산비 거래명세서_라인건설 아산테크노밸리_26년 06월.xlsx (15탭). 실측 해부 26.9.23. 도구 = C:\dev\_work\hansem-0926\probe_form.py(탭·참조) · dump_tabs.py(수식/값 병기) · rel_check.py(원장 대조).

A. 탭 15개 · 돈이 흐르는 배선

단가기준 ──156──▶ 백데이터(숨김) ──▶ 77/84A/84B 내역서-주 (각 O53 = 평형 총액)
                                  └▶ 77/84A/84B 내역서-수 (각 O53)

가격적용분(원장 · 링크 0건) ┄┄전사┄┄▶ 추가분견적(주방가구)  평형 소계 N11/N21/N30/N37
                          ┄┄전사┄┄▶ 추가분견적(일반가구)  평형 소계

자재비(H124) ─┐   운반비(I18) ─┐
              └──▶ 【주방 갑지】◀┘ ◀── 추가분견적(주방가구)
                        │
                     AE36 = 수납!O37 → AF36 생산비 총 → AG36 시공비(수기) → AH36 생산비+시공비
【수납 갑지】◀── 내역서-수 · 추가분견적(일반가구)

탭 목록(원본 순서) = 가격적용분 · 자재비 · 운반비 · 주방 · 77/84A/84B 내역서-주 · 추가분견적(주방가구) · 수납 · 77/84A/84B 내역서-수 · 추가분견적(일반가구) · 단가기준 · 백데이터(건들지마세요!!)(숨김)

탭간 참조 실측(수식이 남의 탭을 무는 횟수) — 백데이터→단가기준 156 · 내역서-주/수 6탭→백데이터 13~21 · 주방→추가분견적(주방가구) 4 · 수납→추가분견적(일반가구) 4 · 갑지↔내역서 각 2 · 자재비/운반비↔주방 각 1. 🔑가격적용분은 어느 탭과도 수식으로 안 이어져 있다(양방향 0건).

B. 갑지(주방) 셀 지도

셀	내용
`S8`/`S10`/`S12`	현장명 / 담당 / 발행일 (다른 탭이 `주방!S8` 로 물어간다)
`A19:W21`	본오더 평형 행 — `O = '<평형> 내역서-주'!O53`, `W = O`
`A22`	절사(만원 맞춤, 음수 수기)
`O23`	본오더 소계 `=SUM(W19:AD22)`
`A24:W27`	추가분 평형 행 — `O = +'추가분견적(주방가구)'!N11/N21/N30/N37`
`O30`	추가분 절사 · `O31` 추가분 소계 `=SUM(W24:AD30)`
`O32`	기타-자재비 `=자재비!H124`
`O33`	기타-운반비 `=운반비!I18`
`O34`	기타 절사 · `O35` 소계 `=SUM(W32:AD34)`
`O36`	합계(VAT 별도) `=O23+O31+O35`
`AE36`	`=수납!O37` · `AF36` 생산비 총 `=O36+AE36` · `AG36` 시공비(수기) · `AH36` `=AF36+AG36`

수납 갑지도 같은 골격(행 번호만 −2 안팎). 수납의 기타행(자재비·운반비)은 원본에서 0.

C. 운반비 탭 (A1:K18) — 배차 일지와 1:1

열	내용	배차(`dispatch`) 대응
A	NO	—
B	날 짜	`order_date` (`M/D` 표기)
C	구 분	「본물량 1차」·「추가분 2차」 — `memo`/견적 차수에서 생성
D·E	이동 경로(출발지·도착지)	`departure` · `destination`
F	차량	`vehicle_type` (5톤·1톤·다마스)
G	수 량	1 고정
H	단 가	금액(규칙 적용 후)
I	공급가액	`=G*H`
J	비 고	⛔엑셀엔 안 쓴다(페페 지시 26.9.23)
`C3`	`=+주방!S8` 현장명 · `I3` `=I18`
`I18`	합계 `=SUM(I8:I17)` → 갑지 `O33` 이 물어간다

D. 자재비 탭 (A1:J134)

날짜 / 품목 / 업체명 / 마감CODE·사이즈 / 수량 / 단가 / 공급가액 / 비고 → H124 합계 → 갑지 O32. ⛔당분간 비운다 — 포인 단가 기준 노출은 대외비(페페 26.9.23). 추후 QC1 미러링 DB 로 정리 예정.

E. 🔑 가격적용분 — 추가분견적의 «단가 산출 원장»

페페 지시 26.9.23 = 이번엔 빈 데이터 + 숨김탭으로만 둔다. 파싱/기입 방식은 아래 계획만 세워두고 입력 개발은 추후.

E-1. 컬럼 지도 (헤더 2~4행 3단 · 데이터 5행~ · 합계행 489)

열	1단(2행)	2단(3행)	3단(4행)	값 예시
A	현장명			(비어 있음 — 상단 1회)
B	품종			몸 / 샘플 / EP / 문
C	소재			포일 / PET / LPM / ALF
D	평형			77m2 / 84A / 84B
E	출고일			5/20
F	품목			주방 / (일반)
G	품명			공틀 / 가림판 / 벽판넬 / 상판 / 샘플도어 / 2GFW
H·I·J	규격		폭 / 높이 / 깊이	125 / 2230 / 15
K	수량			2
L	단 가			4700
M	환기캡	측판연장	PUR	`=(H+I)21.5`
N	숨구멍	수작업엣지	"ㄴ"조립	수기
O	서랍	깊이연장	9자자재	수기
P	NC	기타	NC	수기
Q	디바이더	칸막이	손잡이	수기
R	소 계			*`=SUM(L:Q)1.15`**
S	금 액			`=R*K`
T	비 고			`현장요청` / `인테리어요청` / `*규격변경`

🔑1.15 = 가산율. 페페가 운임 규칙에 쓰라고 한 1.15 와 같은 값이다. 🔑M 열은 자동계산 수식((폭+높이)×2×1.5 = 둘레 기준 PUR/측판연장), 나머지 가산 4칸은 수기.

E-2. 추가분견적 탭 컬럼 지도 (주방가구/일반가구 공통)

A 평형 · B 날짜 · C 품목 · D 품명 · E 몸통사양 · F 칼라 · G 도어 · H 사양 · I·J·K 규격(W/H/D) · L 수량 · M 단가 · N 공급가액(=L*M) · O 비고1 · P 비고2(사유) 평형 블록 = 시작행 ~ 소계행(A = A<시작>&" 소 계" · N = SUM(블록)) → 합계행 M38 = SUM(N11,N21,N30,N37).

E-3. 전사 매핑 (원장 → 추가분견적)

가격적용분	→	추가분견적
D 평형	→	A 평형(블록 머리)
E 출고일	→	B 날짜
F 품목	→	C 품목
G 품명	→	D 품명
C 소재	→	E 몸통사양(포일) 또는 H 사양(PET·LPM) — 품종(B)에 따라 칸이 갈린다
H·I·J 규격	→	I·J·K 규격
K 수량	→	L 수량
R 소계	→	M 단가 (즉 추가분견적의 「단가」 = 원장의 1.15 가산 후 값)
S 금액	→	N 공급가액(`=L*M` 로 재계산)
T 비고	→	O 비고1 / P 사유

E-4. 🔴 원본도 어긋나 있다 (손 전사라서)

가격적용분 실합계 503,113.5(데이터 17행 + 합계행 r489) ↔ 추가분견적(주방가구) 506,223.5 = 3,110원 차이. 원장에만 'ㄱ'자(5,060)·2GFW(111,090) / 추가분견적에만 GW(105,000)·BEP(7,130×2)·오픈장선반·써라운드·신발장·PL.
추가분견적(일반가구) 513,461.2 는 원장에 한 줄도 없다 — 원장이 주방 전용으로만 돌고 있다. → 그래서 원장을 자동 생성하려면 「어느 쪽이 정본인가」를 먼저 정해야 한다. 지금은 추가분견적(제출용)이 사실상 정본이고 원장은 뒤처진 사본이다.

E-5. 구현 계획 (추후)

1단계(지금) = 새 파일 생성 시 가격적용분 데이터 전삭제 + sheet_state='hidden'. 수식 틀·헤더·서식은 그대로 둔다(형식 불파괴 원칙).
2단계 = 추가분견적 → 가격적용분 역생성(단가 L 은 M/1.15 역산, 가산칸은 0). 역산이 안 맞는 행만 사람 확인.
3단계 = PFS 에 가산칸(환기캡·숨구멍·서랍·NC·디바이더) 입력 UI 를 두고 원장을 정본으로 승격, 추가분견적을 수식으로 물린다(현재 링크 0건을 링크로 전환).

F. 평형 탭 변형 규칙 (페페 Q2·Q7 = A)

현장 타입(평형) 개수와 주방/일반 포함 여부에 맞춰 탭을 변형한다. 남는 슬롯은 탭·갑지 행까지 걷어낸다.
갑지 O23=SUM(W19:AD22) 등 범위 수식 재조립 필수.
근거 = 빈 평형 슬롯이 =SUM() 만 남아 엑셀 복구 경고를 냈던 26.9.22 엔진 결함 ③(C:\dev\seedchain\projects\pfs\rules.md).

G. 도면

기본 = 추가하지 않는다. 샘플 양식을 쓸 때도 도면 이미지는 삭제한다(페페 26.9.23). 내역서 탭마다 이미지 1장씩 박혀 있다(ws._images).

H. 🔧 자동화 파이프라인 (26.9.23 [페페] 「확실히 되는 곳까지만」 · PFS 월마감표 버튼 예정)

입구 = C:\dev\_work\hansem-0926\pipeline.py <마감번호> [--upload final|<차수>] [--only f1,f2] [--issue YYYY.MM.DD] · 종료코드 0 = 전 현장 통과.

단계	파일	하는 일
1	`sites.py` `load(close_no)`	월마감 → 현장 설정 자동 판정. 판정 불확실 = `need` 사유 → 그 현장 ⛔(빌드·업로드 안 함)
—	`overrides.json`	판단값(키 = field_no) — 발행본(`issued`·`amounts`·`type_by_est`) · 구분 강제(`grp`) · 흡수(`absorb`) · 수동 운반비(`freight`) · `site`·`dest`·`main`·`adds`·`types` 덮어쓰기 · `note` = 근거
2	`build.py` `use()`·`build(key)`	생산비 거래명세서 + 갑지 재계산 검산(assert)
3	`build_cons.py`	시공비 거래명세서(시공비 있는 현장만) + O40 검산
4	`close_xlsx.py`	월마감표(PFS `monthly_close_excel.build` 파일째 로드)
5	`pipeline.py`	대조표 · 1만원 이상 차 ⚠ · ⛔/⚠ 있으면 업로드 거부
6	`upload.py` `put_file`	NAS `B.NAS_BASE`(= `\\192.168.0.101\공유폴더\<년>현장\견적\<월>월\<업체>`)
검증	`cmp_out.py <기준폴더>`	산출물 회귀 대조(탭·셀 값/수식·병합·이미지 앵커·인쇄영역)

자동 판정 규칙(확실한 것만) — 현장명 = 본견적명 「… 견적서」 앞부분 · 담당 = field.company_member_no → company_member 「이름 직급님」 · 본건 = main_amount 있을 때만 · 평형 = 본건이면 본견적 type_name, 추가만이면 품명 접두(84B·74A) · 본건 운반비 = 본견적 운임칸 1행(날짜 = field.shipping_date, 차량 = 그날 현장 출고 배차) · 추가 운반비 = 견적 「운임」 행·운임칸마다 1행, 라벨 날짜(상차·하차 혼용)의 당일→전날 현장 출고 배차가 딱 1건일 때만 짝. 짝 없으면 need.

재현 검증(26.9.23) — 손 설정(SITES 하드코딩)으로 만든 최종본 9개 vs 자동 판정 산출 = 차이 0(cmp_out.py out_ref_0923). 예외값을 빼면 금강(753 허니콤도어 운임)·롯데(780 운임칸 날짜 없음)만 ⛔, 나머지 4현장은 자동만으로 통과.

Jev 폴백(26.9.23) — 짝 없는 운임 행의 need 사유 뒤에 sites.jev_hint 가 「Jev 추천 <배차> p=… 애매」 또는 「남은 후보 배차 0」을 붙인다. 판정 = jev_freight.py(정답셋 TRUTH · 재측정 python jev_freight.py 2 [--prod]). 반영은 여전히 overrides(사람).

PFS 붙일 때 풀 것(⏳ 미해결 — 페페 「기능 추가할 때 풀겠다」) 1. 🔴NAS 저장 경로 — PFS 는 AWS(EC2)에서 돈다 → 사무실 NAS(192.168.0.101) 에 직접 못 쓴다. 버튼 = zip 다운로드 가 현실적(또는 사무실 PC 워커가 받아 저장). 2. 예외값 저장 — Q1 추천 ⓐ monthly_close_item JSON 칸(스키마 변경 = 승인) + 월마감표 화면 입력. overrides.json 과 모양 동일. 3. 판단 입력 UI — ⛔ 현장의 사유를 화면에 띄우고 흡수/수동 운반비/발행본 금액을 받는다. 4. 시공일 — PFS 에 기록 없음(시공비 명세서 날짜 칸 대부분 빈칸). 5. 코드 이식 — 모듈 전역(use()) → ctx 인자 · pymysql 직결 → PFS DAO · 양식 파일(form\) → 서버 보관 · Excel 실열기 검증 수단 없음(evalwb 재계산만).