목차 열기
도면을 확인하고,
현재 재고를 공간에 연결하세요.
Wareview는 승인한 창고 레이아웃과 엑셀의 현재 재고를 연결해 위치별로 살펴보는 뷰어입니다. 도면과 위치를 먼저 검수한 뒤, 맞춤 양식이나 기존 재고 파일을 연결하세요.
엑셀 반영은 현재 재고 값을 갱신합니다. 입고·출고 거래 이력이나 회계 원장을 기록하지 않으며, 수량 변경 내역 복원 기능으로 사용하면 안 됩니다. 원본 엑셀은 별도로 보관하세요.
시작하기
운영 서버 주소로 접속해 로그인하면 소속 업체의 저장된 작업을 불러옵니다.
운영 화면의 단계 이름을 기준으로 안내합니다. 관리자나 업체 소유자가 승인한 레이아웃에서 위치 양식을 만들 수 있습니다.
권장 순서: 도면 가져오기 → 도면 컨펌 → 맞춤 입력서로 재고 작성의 다운로드 또는 기존 엑셀 AI 매핑의 엑셀 업로드 → 미리보기 확인 → SQLite에 재고 반영 → 3D 위치별 조회.
컨펌 전에는 재고 입력 경로가 열리지 않습니다. 승인된 도면의 위치 단위로 로케이션 ID를 발급한 뒤 재고를 연결합니다.
도면 가져오기
새 창고는 평면도에서 시작합니다. 실제 위치를 확인할 수 있는 선명한 도면을 사용하세요.
새 도면 또는 도면 시작 영역에서 PNG/JPG 파일을 선택합니다. 파일은 10MB 이하이며, 인식이 잘 되도록 글자와 랙 경계가 선명한 이미지를 사용하세요.
분석 서버가 준비되어 있으면 도면 분석을 선택합니다. 화면에 분석 대기·진행 상태가 표시됩니다. 분석이 오래 걸리면 분석 취소로 중단할 수 있습니다. 분석 작업은 서버 메모리에 보관되므로 서버를 재시작했거나 작업이 만료되면 원본으로 다시 요청하세요. 서버가 준비되지 않았거나 인식이 맞지 않으면 수동 편집 시작으로 직접 레이아웃을 만들 수 있습니다. 로컬 데모는 실제 AI 분석을 호출하지 않습니다. 샘플 도면은 실제 업체 도면이 아닌 기능 확인용입니다.
AI가 읽은 코드, 랙 수, 위치, 크기, 단수는 제안값입니다. 랙 개수가 맞아도 위치와 크기가 틀릴 수 있으므로 원본과 각각 비교하세요. 이를 확인 없이 재고에 연결하지 마세요. 코드가 불분명하면 임의로 확정하지 말고 실제 창고 표기와 대조해 고칩니다.
업로드 화면에 AI 분석 제공자 설정이 필요합니다 또는 “AI 서버 준비 안 됨”이 보이면 자동 분석을 사용할 수 없습니다. 이미지 업로드 자체가 분석 완료를 뜻하지 않습니다. 관리자에게 서버 준비를 요청하거나 수동 편집으로 계속하세요.
레이아웃 검수와 승인
실제 창고와 화면을 비교하고, 재고를 연결할 위치를 먼저 확정합니다.
랙 위치와 표시를 맞추기
- 레이아웃 확인에서 평면 배치와 원본 도면을 비교합니다.
- 랙을 선택해 위치 코드·이름·구역을 확인하고, 틀린 값은 수정합니다.
- 랙이 실제 위치와 같은 순서·방향인지 확인합니다. 겹침이나 경계 밖 배치는 먼저 바로잡습니다.
전체와 개별 치수를 검토
- 치수 확인하기에서 창고의 실측 가로·세로를 입력하고 적용합니다.
- 랙을 선택해 X/Z 위치, 너비, 깊이, 높이, 선반 단수를 따로 점검합니다.
- 표시된 통로 검토는 참고용입니다. 실제 안전 규격 판정으로 간주하지 마세요.
도면 컨펌 절차
작업 흐름에서 도면 컨펌을 누르면 확인 창이 열립니다. 전체 치수를 확인하고, “랙 위치·크기·번호와 원본의 미해결 항목” 및 “실제 랙 높이·단수” 확인란을 체크한 뒤 도면 최종 컨펌을 선택합니다. 치수 미확정 또는 형상 오류가 있으면 먼저 수정해야 합니다.
컨펌은 단별 고유 로케이션 ID를 등록하고 재고 양식을 여는 기준입니다. 초안 편집은 승인본과 분리되어 있습니다. 기존 재고가 연결된 위치를 삭제하거나 단수를 줄이려면 먼저 재고 데이터에서 해당 행을 다른 승인 위치로 연결하거나 미지정으로 바꾸세요. 연결 재고가 남아 있으면 컨펌이 거부됩니다. 기존 승인본과 재고는 새 도면 컨펌이 성공할 때까지 유지됩니다.
위치 고정 맞춤 엑셀 작성
검수된 위치를 기준으로 파일을 받은 다음, 각 위치의 현재 수량을 채웁니다.
작업 흐름의 맞춤 입력서로 재고 작성에서 다운로드를 선택합니다. 이 파일은 승인된 창고 전체의 현재 재고를 담습니다. 위치별 기본 입력 행이 포함되고, 현재 재고 행과 미지정 재고도 함께 들어갑니다.
맞춤 입력서의 재고입력 시트에서만 값을 채웁니다. A:G(locationId, 위치코드, 구역, 랙ID, 칸, 단, 입력행ID)는 위치 보호 정보이므로 편집하지 마세요. H:K만 입력합니다: H SKU, I 상품명, J 수량, K 단위. 나머지 위치목록, 사용안내, 양식정보 시트는 참고용입니다. 한 행의 수량 칸에는 숫자만 쓰고 단위는 별도 열에 적으세요. 예를 들어 J열에 24, K열에 EA를 입력합니다. 24 EA를 수량 칸 하나에 함께 입력하지 마세요.
현재 양식에 위치당 기본 빈 행이 있습니다. 행을 추가하거나 삭제하지 마세요. 위치별 행이 모자라면 화면에서 최신 전체 입력서를 다시 다운로드하고, 기존 현재 재고를 포함한 새 파일에서 이어서 입력합니다. 빈 SKU·수량 행은 입력 자리이며, 수량 0은 0개 재고를 뜻합니다.
맞춤 입력서는 전체 현재 재고 교체용입니다. 기존 행을 비우거나 파일에서 빠뜨리면 기존 재고가 유지되는 것이 아니라 제외될 수 있습니다. 반영 미리보기에서 기존 제외/감소 행과 수량을 확인하고, 확인란을 체크해야 반영할 수 있습니다.
도식은 입력 개념 설명용 예시이며 실제 업체 데이터나 다운로드 파일의 스크린샷이 아닙니다.
기존 엑셀 연결과 검증
파일을 선택해 열 연결을 확인하고, 위치가 확실한 행만 반영합니다.
품질 확인용 도면·재고·정답 10종 열기 — 기본 배치부터 위치 누락·수량 오류까지 비교할 수 있습니다. 별도 테스트 업체에서 진행하세요.
재고가 입력된 샘플 엑셀 다운로드 · 합성 재고 10행입니다. 기존 엑셀 AI 매핑으로 업로드하고 실제 도면의 승인 위치를 선택하세요.
기존 엑셀 AI 매핑에서 엑셀 업로드를 눌러 XLSX, XLS, CSV 파일을 선택합니다. 원본 파일은 별도로 보관하세요. 업체의 기존 양식이 민감한 정보를 포함하면 필요한 재고 열만 남긴 복사본을 준비합니다.
AI 매핑 제안은 시트, 제목 행, 고유 로케이션 ID, 외부 위치 표기, SKU / 품목코드, 상품명, 수량, 단위 열을 제안합니다. 화면의 제안 출처가 “AI 매핑 제안”이어도 원본 값 미리보기와 열 선택을 확인하세요. 틀리면 필드별 선택 목록에서 직접 바꾸고 변경한 매핑으로 재검증을 누릅니다. 이름과 문맥이 같은 수량 열이 여러 개라면 AI가 선택했더라도 자동 제안을 보류합니다. 실제 현재 재고 열을 직접 선택하세요. AI 제안 자체가 재고 데이터를 수정하거나 위치를 확정하지는 않습니다.
위치 ID가 맞으면 우선 연결합니다. 위치 ID가 없을 때는 코드가 한 위치에만 해당하는 경우 연결할 수 있습니다. 같은 코드가 여러 위치를 가리키거나 코드를 찾지 못하면 임의 연결하지 않고 보류합니다.
미일치·중복 보류 행은 3D 재고 합계에 포함되지 않습니다. 위치가 없거나 모호한 행은 먼저 위치 없는 유효 재고를 미지정으로 반영을 선택하고 재검증하면 행별 위치 선택이 나타납니다. 현장에서 확인한 위치로 연결하고 다시 검증하거나 미지정으로 남깁니다. 존재하지 않는 고유 ID는 원본에서 고치거나 그 열 매핑을 해제합니다. 불확실한 재고를 가까운 랙에 대신 배정하지 마세요.
서버 검증 · 미리보기 갱신을 눌러 연결/미지정/오류 행과 단위별 합계를 확인합니다. 원본 행의 위치를 수정할 수 있고, 확실하지 않은 행은 위치 없는 유효 재고를 미지정으로 반영을 체크해 미지정으로 둘 수 있습니다. 이 파일의 유효 행으로 창고 전체 현재 재고를 교체한다는 확인란을 체크하세요. 기존 행이 빠지거나 수량이 감소할 때는 표시된 제외·감소 행과 단위별 수량도 확인하고 별도 확인란을 체크한 뒤 SQLite에 재고 반영을 누릅니다.
엑셀 반영은 SQLite의 창고 전체 현재 재고 스냅샷을 교체합니다. 업로드 파일에 없는 기존 품목이 자동으로 유지되지 않습니다. 반영 전 전체 교체 범위와 제외/감소 건수를 확인하세요. 중복 행 합산은 원본 행과 상품명이 일치하는지 확인한 경우에만 선택하고, 단위가 다른 수량을 더해 하나의 합계로 보지 마세요. 이미 새 도면을 컨펌했거나 재고를 반영했다면 이전 파일은 구버전이므로 최신 맞춤 입력서를 다시 발급하세요.
3D 위치별 재고 확인
연결이 끝나면 공간에서 랙을 찾아 현재 수량을 확인할 수 있습니다.
공간 탐색
- 창고 레이아웃에서 마우스로 드래그해 3D를 회전하고 휠로 확대·축소합니다.
- 랙 또는 단별 로케이션을 선택하면 위치 ID, 코드와 상세 재고가 열립니다. 좌우 회전, 확대, 평면 보기로 선반을 살펴보세요.
- 원본 도면과 비교하기로 승인된 도면과 레이아웃을 대조합니다.
재고 조회
- 재고 데이터에서 품목 코드·품목명·수량, 위치 미지정 건수와 로케이션 연결을 살펴봅니다.
- 연결된 행은 승인된 랙과 단에 표시됩니다. 미지정 행은 목록에서 확인하고, 현장 위치를 알게 되면 해당 행의 위치 선택에서 연결할 수 있습니다.
- 수량과 단위는 별도 값입니다. 합계는 단위별로 읽고 EA와 BOX처럼 다른 단위를 합산하지 마세요.
- 재고 히트맵은 선택 단위의 연결 수량을 색으로 보여줍니다.
이 화면에 작업 경로나 입고→검수→보관→피킹→출고 시연이 보이는 경우, 레이아웃을 이용한 시뮬레이션입니다. 실제 입출고를 기록하거나 재고 수량을 변경하지 않습니다.
문제 해결
오류 상태를 확인할 때 원본 도면과 엑셀을 함께 보관하면 원인을 찾기 쉽습니다.
자주 보는 안내
AI 분석 서버가 준비되지 않았습니다. 자동 분석 대신 수동 편집을 선택하거나 관리자에게 로컬 모델 상태를 문의하세요.
위치 미일치 또는 중복 보류가 나옵니다. 최신 승인 양식을 다시 받고, 위치 ID를 보존했는지 확인하세요. 코드가 여러 위치에서 반복되면 현장 확인 후 위치를 선택하세요.
도면과 3D 크기가 맞지 않습니다. 전체 가로·세로와 개별 랙 너비·깊이·높이·단수를 다시 확인합니다. 치수는 실측값으로 보정하세요.
이전 재고가 사라졌거나 예상과 다릅니다. 새 파일 반영은 현재 재고 스냅샷 갱신입니다. 원본 엑셀을 확인해 복원하고, 문제가 계속되면 관리자에게 반영 시간과 파일명을 알려주세요.
로그아웃하거나 화면을 새로 열었습니다. 운영 업체 데이터는 사용자 계정으로 로그인한 Mac 운영 서버에서 확인합니다. 공개 사이트는 구버전 데모이며 운영 업체의 저장 데이터를 보여주지 않습니다. 로그아웃 뒤에는 운영 데이터가 현재 브라우저 데모에 남아 있지 않습니다.
관리자 참고
처음 실행할 때 AI 분석 제공자를 준비하고, 준비 여부를 운영 화면에서 확인합니다.
AI 서버 연결
현재 로컬 검증 구성은 Wareview → 로컬 ChatMock → Luna 6입니다. ChatMock은 원격 모델로 도면과 매핑에 필요한 데이터를 전달하는 프록시이며, Mac에서 모델 자체를 실행하는 LM Studio와 다릅니다. 서버의 공급자·주소·모델 ID·인증값을 설정하고 재시작합니다. ChatMock은 VISION_PROVIDER=chatmock, VISION_MODEL=gpt-6-luna, VISION_REASONING_EFFORT=high를 사용합니다. 인증값은 서버 .env에만 보관합니다. 아래는 LM Studio를 선택할 경우의 절차입니다.
Vision 모델명은 설치된 모델과 테스트 결과에 따라 결정합니다. 이미지 입력을 지원하는 모델을 로드하고 서버가 모델을 사용할 수 있을 때까지, 사용자는 수동 편집 후 같은 도면 컨펌 절차로 진행할 수 있습니다.
- Mac mini에서 LM Studio를 실행하고 Vision 입력이 가능한 모델을 내려받아 로드합니다.
- LM Studio의 로컬 서버를 시작합니다. 로컬 Wareview 서버와 같은 Mac에서 접속되는지 확인합니다.
- 서버 폴더의 최신 .env.example을 참고해 환경 설정을 준비하고, Vision 공급자를 LM Studio로 선택합니다. 로컬 서버 주소, LM Studio에 표시되는 실제 모델 ID, 호환 요청 형식과 시간 제한을 설정합니다. 모델명은 임의의 예시값으로 채우지 않습니다.
- `.env`는 Mac의 서버 프로세스에서만 읽을 수 있도록 두고, 설정을 갱신한 뒤 Wareview 서버를 재시작합니다.
- 로그인된 운영 화면의 도면 가져오기에서 “분석 준비됨” 상태를 확인하고 테스트 PNG/JPG로 결과를 점검합니다. “분석 준비됨”은 서버 설정이 채워졌다는 뜻입니다. 실제 모델 로드·응답 속도까지 보장하지 않으므로 작은 시험 도면으로 먼저 확인합니다.
LM Studio 로컬 사용은 API 키 없이 설정할 수 있지만, 키를 사용하는 구성이라면 서버의 비밀 환경 설정에만 둡니다. API 키나 비밀번호를 이 매뉴얼, 브라우저 화면, 엑셀 파일에 적지 마세요. 이 절차는 관리자용 설정 안내이며 LM Studio 화면의 모델명·실행 상태는 설치 버전에 따라 다를 수 있습니다.
운영은 단일 Mac mini의 로컬 API와 SQLite에서 이뤄집니다. 공개 사이트는 구버전 데모입니다. 업체 등록·로그인으로 접근하는 운영 공간과 데모 데이터를 혼합하지 마세요.