사용자 매뉴얼
SAM 견적서(Internal quotation)와 WINGS 주문 데이터의 사양 코드를 차량 단위로 대조해 생산 전에 차이를 찾아내는 사내 웹 앱입니다. 이 문서는 일반 사용자가 쓰는 방법과 관리자가 알아야 할 판정 로직·기준표 관리까지 한 번에 다룹니다.
00 · 이 앱은 무엇인가
왜 만들었나
차량 한 대의 사양은 두 곳에 따로 존재합니다. 하나는 영업이 만든 SAM 견적서
(Internal quotation … .docx), 다른 하나는 공장에 실제로 전달되는
WINGS 주문입니다. 두 곳의 옵션 코드가 어긋난 채로 Changeability(변경 가능 기한)가
지나가면 원하는 사양이 아닌 차가 생산됩니다. 이 앱은 그 어긋남을
기한이 지나기 전에, 사람이 문서를 일일이 대조하지 않고 찾아내기 위한 도구입니다.
무엇을 답해 주나
- 이번 달 이후 생산 예정 차량 중 사양이 어긋난 차는 몇 대이고 어느 차인가
- 그 차는 어떤 코드가 SAM에만 있고, 어떤 코드가 WINGS에만 있는가
- 필수코드(Mandatory)가 한쪽에서 빠지지 않았는가
- 도색(Paint)·타이어(Tyre)·캡(Cab)·PTO가 양쪽에서 같은가
- 생산월이 바뀌는 동안 사양이 어떻게 변해 왔는가(생산월 이력관리)
- 이 차는 어느 SAM 문서와 비교된 것인가(모델 매칭)
01 · 시작하기 · 로그인
접속
브라우저(Edge·Chrome 권장)에서 https://sam-afab.startruckkorea.com 으로 접속합니다.
운영 주소에서는 회사 Microsoft 365 계정 로그인이 필수이며, 로그인 화면에서
Microsoft 계정으로 로그인을 누르면 회사 로그인 페이지로 이동했다가 되돌아옵니다.
권한
별도의 앱 내부 권한 표는 없습니다. SharePoint 사이트(SAM-AFAB)의 접근 권한이 곧 이 앱의 권한입니다.
| 하는 일 | 필요한 것 |
|---|---|
| 대시보드·이력·매칭 결과 조회 | 로그인만 하면 가능 |
| 코드 관리 / 모델 매칭 편집·저장 | SharePoint 해당 폴더 쓰기 권한 |
| 데이터 다시 계산(빌드) | SharePoint 읽기 + 05. output 쓰기 권한 |
02 · 화면 구성
모든 화면은 상단 바 하나로 이동합니다.
| 메뉴 / 버튼 | 하는 일 |
|---|---|
| 대시보드 | 차량 목록과 요약 타일. 앱의 중심 화면 |
| 생산월 이력관리 | 같은 모델의 사양이 생산월마다 어떻게 바뀌었는지 |
| 모델 매칭 | WINGS 모델이 어떤 SAM 문서와 짝지어졌는지 + 매칭 규칙 편집 |
| 코드 관리 | 기준표 Excel(필수코드·캡·카테고리 등)을 웹에서 편집 |
| 사용자메뉴얼 | 지금 보고 있는 이 문서 |
| ⬇ Export | 대시보드에서만 보이며, 지금 필터가 걸린 목록을 Excel로 저장 |
| ⟳ 데이터 다시 계산 | SharePoint 원본으로 비교를 다시 계산(→ 09장) |
| 🌐 EN / 한국어 | 화면 언어 전환. 선택은 이 브라우저에 기억됩니다 |
| ⎋ 로그아웃 | Microsoft 계정 로그아웃 |
03 · 데이터가 흐르는 길
이 앱에는 서버가 없습니다. 화면은 GitHub Pages에 올라간 정적 파일이고, 데이터는 전부 SharePoint에 있으며, 계산은 “데이터 다시 계산”을 누른 사람의 브라우저에서 돕니다.
SharePoint 폴더 구조
사이트: startruckkorea.sharepoint.com/sites/SAM-AFAB → 문서 라이브러리 SAM-AFAB_Data
| 폴더 | 들어가는 것 | 규칙 |
|---|---|---|
01. SAM_files |
SAM 견적서 .docx |
생산월 폴더 안에 넣습니다. MY26/2026-07 생산 또는 2026-07 생산처럼
폴더 이름이 YYYY-MM으로 시작해야 인식됩니다. |
02. WINGS_data |
WINGS export .xlsx / .xls / .csv |
여러 개가 있으면 가장 최신 1개만 사용합니다(→ 12장 “최신 판정”). |
03. model_rules |
model_mapping.xlsx |
모델 번호 정규화·별칭 등 매칭 규칙 |
04. code |
기준표 Excel 5종 | 필수코드·공장관리코드·캡·모델 카테고리·코드 사전(→ 11장) |
05. output |
data.json, codes.json |
빌드 결과. 앱이 켜질 때 여기부터 읽습니다. 사람이 직접 건드리지 마세요. |
05. output이 갱신되고, 그때부터 전원에게 반영됩니다.
05. output을 읽지 못하면(권한 없음/빌드 이력 없음) 사이트와 함께 배포된
사본 데이터를 씁니다. 이때 화면 상단 회색 줄에 “출처: 배포 사본(빌드 결과 없음)”이 표시됩니다.
04 · 대시보드
4.1 요약 타일
타일은 두 줄입니다. 숫자는 항상 아래 범위 안에서 셉니다.
- 전체 현황 (시작월 이후) — 생산월이 시작월 이상인 차량 전체. 시작월은 기본이 이번 달이며, 필터 줄의 시작월 드롭다운으로 바꿉니다. 과거로 넓히면 지난 차량도 함께 비교됩니다.
- 2주 이내 (Changeability D-14) — 남은 일수가 0~14일인 차량. 가장 급한 대상 (남은 일수 기준이라 시작월과 무관합니다)
| 타일 | 세는 기준 |
|---|---|
| 전체 Commission | 해당 범위의 전체 대수 |
| 매칭 Match | SAM 문서를 찾았고 차이가 없음 |
| 미스매치 Mismatch | SAM 문서를 찾았지만 코드·도색·타이어 차이가 있음 |
| No SAM No SAM | 비교할 SAM 문서를 찾지 못함 |
| Mandatory 누락 | 필수코드가 한쪽에만 있는 차량 |
| SAM update요청 | 생산월 폴더에 문서가 없어 이전 달 문서로 대신 비교한 차량 |
전체 = 매칭 + 미스매치 + No SAM (겹치지 않음).
Mandatory 누락과 SAM update요청은 별도 표시라 위 셋과 겹쳐서 셉니다.
타일을 누르면 아래 목록이 그 조건만 남깁니다. 이때 기존 드롭다운·검색은 모두 해제되므로 목록 건수 = 타일 숫자가 됩니다. 미스매치·Mandatory 타일은 유용한 순서로 자동 정렬됩니다.
4.2 Upcoming changeability 카드
왼쪽 위 카드는 오늘 기준 가장 가까운 Changeability 날짜와 그날 해당하는 Commission 수를 보여 줍니다. 앞으로 남은 날짜가 없으면 가장 최근 지난 날짜를 보여 줍니다.
4.3 모델별 대수
오른쪽 두 카드는 Model · Type · Axle · Cab · MY 조합을 “1개 모델”로 보고 대수를 셉니다. 왼쪽 카드는 이번 생산월 이후 전체, 오른쪽 카드는 지금 필터가 걸린 결과입니다.
4.4 필터
| 필터 | 설명 |
|---|---|
| 생산월 | WINGS의 Requested delivery date 기준 연-월 |
| MY | 모델이어. SAM/WINGS 코드 V8Q~V8Z로 판정(→ 10.7) |
| Model / Type / Axle / Cab | 차종(Arocs 등) / 모델표기(4153L 등) / 축(8x4) / 캡 코드 |
| 검색창 | Commission·모델·코드 등 행의 모든 값을 대상으로 부분 일치 |
| 전체 상태 | Match / Mismatch / No SAM |
| Display only production from this month | 기본 켜짐. 생산월이 이번 달 이상인 행만 |
4.5 목록 읽는 법
| 열 | 의미 |
|---|---|
| Commission | WINGS Commission no. (차량 1대) |
| Model / Type / Axle | 차종 / 모델 표기 / 구동축 |
| Cab · PTO | WINGS 기준 값. SAM과 다르면 ≠ 가 붙고, 마우스를 올리면 양쪽 값이 보입니다 |
| Production | 생산(요청 납기) 일자 |
| Changeability | 사양 변경 가능 마지막 일자 |
| Changeability D-Day | 오늘 기준 남은 일수. D-14 이하는 주황, 지난 건 회색(지남) |
| Only in SAM / Only in WINGS | 한쪽에만 있는 코드 개수. 0이면 ✓ |
| Mandatory | 한쪽에만 있는 필수코드 개수 |
| Status | Match / Mismatch / No SAM (+ SAM update요청 배지) |
개수 열의 셈법 — 옵션코드 차이뿐 아니라 도색·타이어 차이도 함께 셉니다. “타이어만 다른 차”가 Mismatch인데 목록에는 ✓로 보이는 일을 막기 위한 것입니다.
정렬은 열 제목 클릭(다시 누르면 역순), 행 클릭은 차량 상세 창을 엽니다.
4.6 Export
⬇ Export는 지금 화면에 보이는 목록 그대로(필터·정렬 반영) Excel로 저장합니다. 파일 맨 위에 적용된 필터와 내보낸 시각이 함께 기록되므로, 회의 자료로 그대로 쓸 수 있습니다.
05 · 차량 상세 창
목록에서 행을 클릭하면 오른쪽에서 상세 창이 열립니다.
- 맨 위 정보 — 차종·카테고리·축·캡·MY·PTO·생산일·Changeability·SAM Baumuster·상태 등. 제목 아래 회색 글씨가 실제로 비교된 SAM 파일명입니다.
- 🔍 Difference Codes — 차이만 모아 봅니다.
- 🚪 Cab / ⚙️ PTO / 🎨 Paint / 🛞 Tyre — 양쪽이 다를 때만 나타납니다
- Codes Only in SAM / Codes Only in WINGS — 한쪽에만 있는 옵션코드와 설명
- Mandatory — 빠진 필수코드. 문제가 없으면 “양쪽 모두 반영됨” 목록을 보여 줍니다
- Factory Control — 공장관리코드 차이(참고용. 상태 판정에는 쓰지 않음 → 10.5)
- 📄 Full Code List — SAM·WINGS 전체 코드를 좌우로 나란히 정렬. 한쪽에 없는 칸은 비어 보입니다.
- ⬇ 이 차량 Excel — 이 차량 한 대의 정보와 전체 코드 대조표를 Excel로 저장합니다.
06 · 생산월 이력관리
같은 MY·같은 모델의 차량을 생산월 순으로 세워 두고, 달마다 어떤 코드가 +추가·−삭제됐는지 보여 줍니다. “언제부터 이 코드가 빠졌지?”를 추적할 때 씁니다.
조작
| 항목 | 설명 |
|---|---|
| MY 선택 | 이력은 같은 MY 안에서만 이어집니다 |
| WINGS 코드 / SAM 코드 / WINGS + SAM 대조 | 어느 쪽 코드를 볼지. 대조를 고르면 두 줄이 위아래로 함께 나옵니다 |
| 이전 생산월 대비 / 첫 생산월 대비 | 각 달을 무엇과 비교할지 |
| 모델 검색 | 모델명·Commission 번호로 좁히기 |
| ⬇ Export | 지금 보이는 이력을 Excel로 저장 |
표 읽는 법
- 열 = 생산월, 줄 = Commission → 갈래(코드 / 🎨도색 / 🛞타이어) × 소스(WINGS·SAM)
- 그 모델의 첫 생산월은 기본(기준)으로 표시되고 변경 내역이 없습니다
- 생산이 없던 달은 — 로 비어 있습니다
- 한 달에 여러 대가 있으면 그 달의 코드는 합집합으로 봅니다. 대표 1건만 칩으로 보이고 나머지는 “외 n대”
- ⚠ n 배지 = 같은 달 안에서도 차량마다 사양이 갈린 코드 수. 마우스를 올리면 코드 목록이 보입니다
- Commission 번호를 클릭하면 그 차량의 상세 창이 열립니다
일치 / 불일치 띠
WINGS + SAM 대조일 때만 월 머리글 아래에 일치 / 불일치 띠가 깔립니다. 이 배지는 바로 아래 두 줄(WINGS·SAM)의 변경 내역이 서로 같은가를 말합니다. 화면에 보이는 것과 배지가 늘 맞아떨어지게 하려는 것입니다.
06+ · Mismatch 예외 (문제없는 차이)
비교상 차이는 있지만 실제로는 문제가 없는 코드를 예외로 등록하는 기능입니다. 예외는 Commission × 코드 단위로 관리되며, Admin 만 등록·수정·해제할 수 있습니다(별도 승인 절차 없음).
사용법
- 대시보드에서 Mismatch 차량을 열면 차이 코드 탭 맨 위에 문제없는 Mismatch 확인 섹션이 나옵니다.
- Admin 이 코드별 문제없음(또는 남은 n개 모두 문제없음)을 누르고 노트(이유)를 적으면 바로 반영됩니다.
- 처리된 코드는 대시보드에서 더 이상 차이로 세지 않습니다. 한 차량의 차이가 모두 처리되면 그 차량은 Match 로 분류되고 상태 옆에 예외 표시가 붙습니다.
- Admin 은 노트 수정과 해제를 할 수 있습니다. 해제한 코드는 다시 차이로 집계됩니다.
- Read 권한자는 상태와 노트를 볼 수만 있습니다.
Mismatch 예외 메뉴
| 탭 | 내용 |
|---|---|
| 문제없음 처리 | 대시보드에서 차이 제외(전부면 Match)로 처리된 코드와, 그 차량의 현재 상태 |
| 해제 · 미반영 | 해제된 코드, 그리고 예전 승인 절차 시절에 요청만 되고 반영되지 않은 기록 |
| 변경 이력 | 누가 언제 무엇을 등록·수정·해제했는지 전체 기록 (삭제되지 않음) |
- 기록은 SharePoint
SAM-AFAB_Data/06. exceptions/exceptions.json에 저장됩니다. - 데이터를 다시 계산하지 않아도 화면을 여는 즉시 반영됩니다. 빌드 결과(data.json)의 원래 판정은 바뀌지 않습니다.
- 같은 코드라도 Commission 이 다르면 별도 예외입니다.
07 · 모델 매칭
“어디가 안 붙었나”를 먼저 보고, “이 차는 어느 SAM 문서와 비교됐나”를 확인하고, 매칭 규칙을 고치는 화면입니다. 위쪽 버튼으로 문제 · 매칭 결과 · 매칭 규칙 세 화면을 오갑니다.
문제 — 고칠 것부터
매칭 문제를 한 표에 모았습니다. 버튼 옆 빨간 숫자가 고칠 것의 수이고, 위쪽 칩으로 종류를 골라 봅니다.
| 구분 | 뜻 · 할 일 |
|---|---|
| SAM 못 찾음 | SAM 을 못 찾은 WINGS 주문(모델·캡·PTO·생산월로 묶음). 원인 칸이 “생산월 폴더가 없음”인지 “그 달 SAM 에 이 번호가 없음”인지 알려 주고, 그 달 비슷한 번호도 함께 보여 줍니다. 같은 차의 다른 이름이라면 규칙 추가로 모델명 변경(From → To)을 등록합니다. 대수를 누르면 그 차량 상세가 열립니다 |
| 안 붙은 SAM | 잘 읽혔는데 어떤 주문에도 안 쓰인 SAM 문서. Type 칸의 번호는 파일명 번호, 본문 Vehicle type 번호 순입니다(마우스를 올리면 표시). 그 달 같은 번호 주문을 보고 원인을 가릅니다 — 그 번호 주문이 없음 · PTO판/비PTO판 중 주문이 없는 쪽 · 같은 조건 주문이 다른 견적서에 붙음은 참고(고칠 것 아님), 같은 번호 주문 중 SAM 을 못 찾은 것이 있으면 고칠 것입니다 |
| 읽지 못한 파일 | 읽다가 건너뛴 SAM 파일과 이유 |
| 생산월 폴더(참고) | 폴더별로 읽은 파일 수와 인식한 모델 번호, 그 달 주문 수 |
필터 · 무시
- 생산월 시작 ~ 끝, 모델, 검색어로 좁혀 봅니다
- SAM 이 없는 과거 모델처럼 고칠 수 없는 줄은 체크(머리글 체크 = 보이는 줄 모두)한 뒤 선택 무시. 무시한 줄은 고칠 것 수와 탭의 빨간 숫자에서 빠지고, 무시됨 칩에서 누가 언제 무시했는지와 함께 보입니다
- 되돌리려면 무시됨에서 체크 후 무시 해제. 무시 목록은 SharePoint
06. exceptions/match-ignore.json에 저장되어 모든 Admin 에게 같게 보입니다
매칭 결과
- 모델별로 비교에 쓰인 SAM 파일, 대수, 상태를 보여 줍니다
- 캡·PTO는 파일명이 아니라 실제 코드로 판정하며, WINGS와 SAM이 다르면 ≠
모델명 변경
규칙은 model_mapping.xlsx의 모델명변경 시트 한 장(From · To · 메모)뿐입니다.
WINGS 모델명이 From 과 같으면 To 로 바꾸고(한 방향), 바뀐 이름으로 SAM 을 찾고 대시보드 Type 에도 그 이름을 씁니다.
To 가 또 다른 From 이면 이어서 바꿉니다. 편집 방법은 코드 관리와 같습니다(→ 08장).
- SAM 못 찾음 줄의 규칙 추가를 누르면 From 이 채워진 창이 열립니다. To 에는 원인 칸의 “그 달 비슷한 번호” 중 맞는 것을 적습니다
- 예전 규칙(대체번호·SAM별칭·옵션·차종)은 폐기했습니다. 예전 형식 파일을 처음 열거나 데이터를 다시 계산하면 표시치환은 그대로 옮기고, 예전 규칙 덕분에 붙어 있던 모델은 지금 데이터에서 찾아 자동으로 추가합니다(메모에 “자동 추가”)
- 차종(Actros·Arocs…)은 SAM 파일명에서 읽고, 없으면 같은 Baumuster → 같은 모델명 → 같은 번호의 다른 차에서 옮겨 채웁니다
08 · 코드 관리
비교에 쓰이는 모든 기준표가 SharePoint 04. code 폴더의 Excel로 관리됩니다.
이 화면에서 Excel을 열지 않고 브라우저에서 바로 고치고 저장할 수 있습니다.
순서
- 위쪽 파일 버튼에서 편집할 Excel을 고릅니다
- 시트 탭으로 편집할 시트를 고릅니다
- 🗂 카드 편집(행 하나를 폼으로) 또는 ▦ 표 편집(엑셀처럼 격자로) 중 하나로 수정합니다
- + 등록 — 새 항목 추가(카드 편집)
- + 행 추가 — 빈 행 추가(표 편집). 열 자체를 바꾸려면 표 편집을 쓰세요
- 행을 클릭하면 편집 창이 열리고, 창 안의 삭제로 행을 지웁니다
- 고치면 ● 저장되지 않은 변경 표시가 켜집니다
- ⭱ SharePoint에 저장 — 원본 Excel을 덮어씁니다 / ↺ 되돌리기 — 저장 전 상태로 복구 / ⬇ 다운로드 — 내 PC로 사본 저장
- ⟳ 데이터 다시 계산을 눌러야 비교 결과에 반영됩니다
09 · 데이터 다시 계산
상단 오른쪽 ⟳ 데이터 다시 계산은 SharePoint의 최신 WINGS와 SAM 생산월 폴더 전부, 그리고 기준표를 읽어 비교를 처음부터 다시 계산합니다.
언제 눌러야 하나
- 새 WINGS export를
02. WINGS_data에 올렸을 때 - SAM 견적서를 추가·교체했을 때
- 코드 관리나 모델 매칭에서 기준표를 고쳐 저장했을 때
알아둘 점
- 계산은 누른 사람의 브라우저에서 돌며 보통 1~3분 걸립니다. 그동안 탭을 닫지 마세요
- 결과는
05. output에 저장되어 모든 사용자에게 반영됩니다 - 진행 로그에 단계별 상황과 건너뛴 SAM 파일이 표시됩니다 — 실패가 있으면 여기서 원인을 확인하세요
- 로그인하지 않았거나 Excel 라이브러리가 차단된 환경에서는 실행되지 않습니다
10 · 판정 로직 상세
화면의 숫자가 왜 그렇게 나오는지를 결정하는 규칙입니다. 기준표를 고치기 전에 반드시 읽어 주세요.
10.1 두 소스에서 코드를 뽑는 방법
| WINGS (.xlsx/.csv) | SAM (.docx) | |
|---|---|---|
| 옵션코드 | Standard/Additional equipment 열의 텍스트에서 영숫자 3~5자 토큰을 모두 추출 | Equipment overview 표(없으면 Standard equipment 표)에서 추출. Standard/Special 구역은 문단 전체, Additional 구역은 줄 맨 앞 코드만 |
| 도색 | Paint … zone 열의 숫자 | Paint 섹션의 MB 1234 |
| 타이어 | 축별 Tyre key (+ Manufacturer key) | Tyres 섹션의 규격 문자열 |
| 모델 | Type (brief) → Type → Baumuster 순 | 본문 Vehicle type 및 파일명 |
JKTO)는 코드 사전에 등록된 경우에만 살아남습니다 —
일반 영어 단어를 코드로 오인하지 않기 위한 장치입니다.
10.2 WINGS 한 줄에 SAM 문서를 붙이는 순서
- 모델 번호를 정규화합니다 — 축 정보(
8x4) 제거,DNA제거, 영숫자만 대문자로 - 그 차의 생산월 폴더에서 같은 모델키를 찾습니다
- 없으면 이전 최대 6개월 폴더를 차례로 찾습니다 → 찾으면 SAM update요청 표시
- 후보가 여러 개면 점수가 가장 높은 문서를 고릅니다
캡 일치 +3 · Baumuster 일치 +2 · Subcategory 일치 +1
- 끝내 못 찾으면 No SAM
생산월(요청 납기)이 비어 있는 행은 최신 월 폴더부터 훑어 매칭하며, 이 경우 SAM update요청 판정은 하지 않습니다.
10.3 캡(Cab)과 PTO
- 캡은
cab.xlsx의 매핑(WINGS 캡 코드 → SAM 캡 variant, 예F1J → G5F)으로 판정합니다. 문서에 캡 코드가 있으면 그것이 1순위이고, 없을 때만 파일명 토큰을 봅니다. - PTO는 코드 설명에 “PTO”가 포함된 코드가 있는지로 판정합니다(문서 본문·파일명도 보조로 사용).
- PTO는 엄격한 필터입니다 — WINGS가 PTO 차량인데 SAM에 PTO 변형이 없으면 비PTO 문서로 넘어가지 않고 No SAM이 됩니다. 예전처럼 반대 변형과 비교하면 차이가 통째로 묻히기 때문입니다.
- 캡·PTO는 양쪽 값을 모두 남겨 화면에서 ≠로 표시합니다. 캡은 양쪽 모두 값이 있을 때만, PTO는 있다/없다가 갈릴 때 불일치로 봅니다.
10.4 상태(Match / Mismatch / No SAM)
| 상태 | 조건 |
|---|---|
| No SAM | 비교할 SAM 문서를 못 찾음. 이 행은 차이·Mandatory 값을 모두 비웁니다 |
| Mismatch | Only in SAM / Only in WINGS / 도색 / 타이어 중 하나라도 차이가 있음 |
| Match | 위 어느 것도 없음 |
SAM update요청은 상태가 아니라 별도 플래그입니다. 이전 달 문서로 대체 비교된 경우 Match/Mismatch는 그 대체본 기준으로 그대로 계산하고, 배지만 덧붙입니다.
10.5 차이 목록에서 빠지는 코드
Only in SAM / Only in WINGS를 만들 때 아래 코드는 제외됩니다. 대신 자기 칸에서 따로 다룹니다.
- Factory Control(공장관리코드) —
factory-control-codes.xlsx의 접두어(기본I·O·Z·U)와 개별코드(기본DUP0·A0B·E0D·E0Q·J7G). Factory Control Codes 칸에만 모아 보여 주고 상태 판정에는 쓰지 않습니다. - Mandatory(필수코드) — Mandatory Codes 칸에서 따로 셉니다.
PTO 여부는 pto-codes.xlsx로 판정합니다(→ 08장). 코드 설명에 “PTO”라는
글자가 있는지 훑던 예전 방식은 준비·제어 코드까지 PTO 로 넘겨 버렸습니다.
10.6 Mandatory(필수코드) 판정
- 필수코드는 카테고리(tractor / rigid / tipper / all)별로 적용됩니다.
그 차의 카테고리는 Baumuster 앞 6자리로 결정합니다(
model-category.xlsx, 표에 없으면 접두어 규칙으로 추정). - 그룹이 없는 코드는 한쪽에만 있으면 곧바로 누락으로 셉니다.
- 그룹이 있는 코드(예: 같은 기능의 대체 코드 묶음)는 그룹 단위로 봅니다 — “SAM에 그룹 중 하나라도 있는가”와 “WINGS에 하나라도 있는가”가 갈릴 때만 누락으로 셉니다. 같은 그룹 안에서 서로 다른 코드를 쓰는 것은 문제로 보지 않습니다.
10.7 MY(모델이어)
코드 V8Q~V8Z = 모델이어 끝자리 0~9 입니다(V8W → 6 → 2026).
SAM 코드가 1순위, 없으면 WINGS 코드로 보완합니다(No SAM 차량도 MY로 묶기 위함).
10.8 화면 값이 비어 있을 때 채우는 규칙
차종·축은 문서에 따로 없어 SAM 파일명에서 뽑습니다. 매칭이 없으면 비게 되므로,
같은 Baumuster를 가진 다른 행의 값으로 채웁니다(값이 하나로 모일 때만. 갈리면 비워 둡니다).
또 WINGS 모델 표기에 축이 섞여 들어오면(4153 K 8x4) 축은 축 칸으로 옮겨
같은 모델이 두 줄로 갈라지지 않게 합니다.
11 · 기준표 파일 사양
04. code · 03. model_rules 폴더의 파일입니다.
열 위치와 시트 이름이 곧 규칙이므로 순서를 바꾸거나 시트 이름을 바꾸면 인식되지 않습니다.
첫 줄은 항상 머리글로 간주해 건너뜁니다.
mandatory-codes.xlsx — 필수코드 시트: Mandatory
| 열 | 내용 | 비고 |
|---|---|---|
| A | 카테고리 | all / tractor / rigid / tipper. 비우면 all |
| B | 그룹 | 같은 값끼리 한 묶음. 비우면 단독 코드 |
| C | 코드 | 필수. 비면 그 행은 무시 |
| D | 설명 | 화면 툴팁·상세 창에 표시 |
| E | 비고 | 참고용(로직에 영향 없음) |
factory-control-codes.xlsx — 공장관리코드 시트: FactoryControl
| 열 | 내용 | 비고 |
|---|---|---|
| A | 유형 | 접두어(prefix) 또는 개별코드(code) |
| B | 코드 / 접두어 | 접두어는 한 글자만 유효. - 같은 안내 행은 무시 |
| C | 설명 | 참고용 |
pto-codes.xlsx — PTO 코드 시트: PTO
PTO 차량인지 아닌지를 정하는 유일한 기준입니다. WINGS 주문과 SAM 견적서 양쪽 모두
여기 PTO코드로 적힌 코드를 하나라도 가지면 PTO 로 봅니다.
PTO 차량과 비PTO 차량은 서로 비교하지 않으므로, 이 목록이 곧 매칭 기준입니다.
| 열 | 내용 | 비고 |
|---|---|---|
| A | 유형 | PTO코드(판정에 사용) 또는 제외(판정에서 뺌) |
| B | 코드 | 필수. - 같은 안내 행은 무시 |
| C | 설명 | 참고용 |
| D | 비고 | 왜 이렇게 분류했는지 적어 두는 칸 |
PTO코드로 두면 그 견적서가 통째로 PTO 로 분류돼, 같은 달의 비PTO 주문이
짝을 못 찾고 지난달 문서로 밀립니다. 기본값은 N6P(PTO 준비)와
U2K(오일레벨 제어)를 제외로 둡니다.
두 번째 시트 설명에_PTO포함(Ref)에 설명에 PTO 가 들어간 코드가 전부 있으니
미분류로 뜨는 새 코드가 있으면 검토해 주세요.
파일이 없으면 이 화면을 열 때(또는 다시 계산할 때) 기본값으로 한 번 만들어 둡니다. 이미 있으면 손대지 않으므로, 분류한 내용이 덮어써질 걱정은 없습니다.
cab.xlsx — 캡 매핑
A열 = WINGS 캡 코드, C열 = SAM 캡 variant. 둘 다 있어야 매핑이 만들어집니다(대문자로 저장).
model-category.xlsx — 모델 카테고리
A열 = Baumuster 앞 6자리, B열 = tractor / rigid / tipper.
이 셋이 아닌 값은 무시됩니다.
mbtruck-spec-data.xlsx — 코드 사전 시트: code_dict
B열 = 코드, C열 = 영문 설명. 화면의 코드 설명과 숫자 없는 코드의 인식에 함께 쓰입니다.
model_mapping.xlsx — 모델명 변경 (03. model_rules) 시트: 모델명변경
시트 한 장, A=From · B=To · C=메모. From 은 축(8x4)·DNA 를 뺀 WINGS 모델명 그대로, To 는 SAM 문서 번호와 같은 이름. 같은 From 이 두 줄이면 아래 줄이 이깁니다.
12 · 주의사항 · 한계
운영상 반드시 지킬 것
- SAM 폴더 이름은
YYYY-MM으로 시작해야 합니다. 아니면 그 달은 통째로 인식되지 않습니다. - WINGS 파일은 폴더에 최신 1개만 유효합니다. “최신”은 파일명의 13자리 타임스탬프 또는
YYYY-MM-DD가 1순위, 없으면 SharePoint 수정일이 2순위입니다. 파일명에 날짜를 넣어 두는 편이 안전합니다. - WINGS 파일에
Commission no.열이 없으면 빌드가 실패합니다. - 임시 파일(
~$…)과.docx가 아닌 파일은 무시됩니다. - 기준표를 고쳤으면 반드시 데이터 다시 계산까지 해야 합니다.
알려진 한계
- 결과의 정확도는 SAM 문서 양식에 달려 있습니다. 표 구조·섹션 제목이 바뀌면 코드 추출이 깨집니다.
- 코드 추출은 텍스트 패턴 기반이라, 설명문 안의 대문자 약어가 코드로 잡힐 여지가 있습니다 (숫자 없는 토큰은 사전 등록분만 통과시켜 이를 줄였습니다).
- 한 달에 여러 대가 있으면 이력관리는 합집합으로 봅니다. 차량별 차이는 ⚠ 배지로만 알려 줍니다.
- 동시 편집 병합이 없습니다. 같은 Excel을 둘이 고치면 나중에 저장한 쪽으로 덮어집니다.
- 계산이 브라우저에서 돌기 때문에 SAM 문서가 많아질수록 빌드가 느려집니다. 도중에 탭을 닫으면 중단됩니다.
- 로그인 게이트는 화면 보호(UX)입니다. 사이트는 정적 호스팅이라 URL을 아는 사람은 배포 사본 데이터에 접근할 수 있습니다. 대외비 자료를 배포 사본에 담지 마세요.
- 회사망에서 외부 CDN이 차단되면 Excel 처리·로그인 라이브러리가 로드되지 않을 수 있습니다 (로컬 사본을 우선 사용하도록 되어 있습니다).
13 · 문제 해결(FAQ)
| 증상 | 원인 / 조치 |
|---|---|
| 화면에 “출처: 배포 사본(빌드 결과 없음)” | 05. output을 읽지 못한 상태입니다. 로그인 여부와 SharePoint 권한을 확인하고
데이터 다시 계산을 한 번 실행하세요. |
| 특정 차량이 계속 No SAM | ① 생산월 폴더(및 직전 6개월)에 해당 모델 문서가 있는지 ② 모델 번호 표기가 다르면
model_mapping.xlsx의 정규화 규칙 ③ PTO 차량인데 PTO 문서가 없는 경우(→ 10.3)
④ 문서가 파싱에 실패해 건너뛰어졌는지(빌드 로그 확인) |
| SAM 문서를 올렸는데 반영이 안 됨 | 폴더 이름이 YYYY-MM으로 시작하는지 확인 → 데이터 다시 계산 실행 |
| 기준표를 고쳤는데 그대로임 | 저장 후 데이터 다시 계산을 하지 않았거나, 시트명·열 위치가 사양과 다릅니다(→ 11장) |
| 엉뚱한 SAM 파일과 비교됨 | 모델 매칭 → 매칭 결과에서 실제 붙은 파일을 확인하세요. 후보가 여러 개면 캡·Baumuster·Subcategory 점수로 고릅니다(→ 10.2). 문서 본문의 Baumuster/캡 코드를 바로잡는 것이 가장 확실합니다. |
| 저장 시 오류(403 / 권한) | 해당 SharePoint 폴더 쓰기 권한이 없습니다. 사이트 관리자에게 요청하세요. |
| “엑셀 라이브러리를 불러오지 못했습니다” | 사내망 차단 가능성. 새로고침 후 재시도하고, 계속되면 네트워크 담당자에게 문의하세요. |
| 로그인 창이 계속 돌거나 실패 | 브라우저 팝업 차단을 해제하고, 시크릿 창/다른 브라우저로 확인해 보세요. 그래도 안 되면 Entra 앱 등록의 Redirect URI 설정을 확인해야 합니다. |
| 이력관리에서 없던 변경이 생긴 것처럼 보임 | 그 달에 사양이 다른 차량이 섞여 합집합이 커진 경우입니다. ⚠ 배지를 확인하세요(→ 06장). |
14 · 용어 사전
| 용어 | 뜻 |
|---|---|
| SAM | 영업 견적 시스템. 여기서는 Internal quotation .docx 문서를 가리킵니다 |
| WINGS / AFAB | 주문·생산 관리 시스템에서 내려받은 주문 목록(export) |
| Commission no. | 차량 1대를 가리키는 주문 번호 |
| Baumuster | 공장 모델 코드(숫자). 앞 6자리로 카테고리를 판정합니다 |
| Changeability | 사양을 바꿀 수 있는 마지막 날짜. 이후에는 수정 불가 |
| Mandatory code | 해당 카테고리 차량에 반드시 들어가야 하는 코드 |
| Factory Control code | 공장 관리용 코드. 차이가 나도 불일치로 보지 않습니다 |
| PTO | 동력 인출 장치. 있고 없고가 사양을 크게 가르므로 매칭에서 엄격히 구분합니다 |
| Cab variant | SAM 문서·파일명에 쓰이는 캡 표기(예 G5F) |
| MY | 모델이어. 코드 V8Q~V8Z로 판정 |
| SAM update요청 | 생산월 폴더에 문서가 없어 이전 달 문서로 대신 비교했다는 표시 |