1. 시스템 개요 및 특징

1.1 3개 시스템 소개

시스템	파일명	주요 기능
V164 자재코드매칭	`자재코드매칭_V164_firebase.html`	자재 코드DB 관리, 내역서 품명/규격으로 자재코드 자동 매칭, 학습 기능
v1.2.22 계약대비발주현황	`계약대비발주_v1_2_22_firebase.html`	계약서 등록, 계약 항목별 발주 비율 분석, V164 코드 연동 매칭
v3.4.47 발주서관리시스템	`발주서_관리시스템_v3_4_47_firebase.html`	발주서 작성·관리·인쇄, 업체·자재·현장 마스터, 세금계산서 대조

1.2 시스템 연동 관계

V164

자재코드매칭

코드DB·학습DB
(PC 로컬)

→

v1.2.22

계약대비발주현황

계약서 등록
Firestore 저장

↔

v3.4.47

발주서관리시스템

발주서 작성
Firestore 저장

연동 방향	내용
V164 → V1.2.22	자재 코드DB·학습DB·규칙이 Firestore 클라우드에서 직접 공유. V1.2.22에서 "V163 코드 검증" 버튼으로 미매칭 항목 자동 보완
V1.2.22 ↔ V3.4.47	Firebase Firestore 클라우드에서 발주 데이터 실시간 공유 (별도 파일 교환 불필요)
공통	Firebase 로그인 후 사용 (최초 1회, 이후 자동 유지)

v3.4.47 / v1.2.22부터 Firestore 클라우드 전환 완료 — 모든 직원이 실시간으로 같은 데이터를 사용합니다. 별도 서버 실행 불필요.

1.3 클라우드 전환 전/후 비교 (신규 직원 필독)

항목	이전 방식 (v3.4.46)	현재 방식 (v3.4.47)
접속 방법	server.bat 실행 → localhost:9090	웹 주소 바로 접속
데이터 저장	각 PC 브라우저 내부	Firebase 클라우드 (전 직원 공유)
로그인	PC별 비밀번호	이메일/비밀번호 (Firebase)
데이터 공유	JSON 백업 파일로 교환	실시간 자동 공유
백업 필요성	필수 (PC 분실 시 데이터 소실)	선택 (클라우드에 항상 보관)
여러 PC 사용	불편 (매번 백업/복원 필요)	어디서나 동일 데이터

2. 시작하기 — 웹 접속 및 로그인

server.bat 설치나 Python 설치 불필요! 웹 주소만 알면 됩니다.

2.1 접속 방법

화면	주소
메인 홈 (추천)	`https://untech-poju.web.app`
v3.4.47 발주서 관리시스템	`https://untech-poju.web.app/발주서_관리시스템_v3_4_47_firebase.html`
v1.2.22 계약대비발주	`https://untech-poju.web.app/계약대비발주_v1_2_22_firebase.html`
V164 자재코드매칭	`https://untech-poju.web.app/자재코드매칭_V164_firebase.html`

메인 홈(https://untech-poju.web.app)에서 각 시스템 카드를 클릭하면 바로 이동합니다. 북마크(즐겨찾기)에 저장해 두세요.

2.2 로그인 (Firebase 인증)

웹 주소 접속 시 로그인 화면이 자동으로 표시됩니다.

관리자로부터 받은 이메일 주소와 비밀번호를 입력합니다.

"로그인" 버튼을 클릭합니다.

로그인 성공 시 시스템 메인 화면으로 전환됩니다.

이후 같은 브라우저에서는 자동 로그인 유지 (재로그인 불필요).

계정이 없으면 관리자(유수문님)에게 계정 등록 요청. 임의 가입 불가.

로그아웃은 우상단 "로그아웃" 버튼. 개인 PC에서는 로그아웃 없이 사용해도 됩니다.

비밀번호 분실 시

관리자(유수문님)에게 연락 → 비밀번호 재설정 메일 발송
또는 관리자가 Firebase Console에서 직접 재설정 가능

2.3 데이터 저장 구조 (Firestore 클라우드)

데이터는 Google Firebase 클라우드(Firestore)에 실시간 저장됩니다. PC를 교체해도, 다른 PC에서 접속해도, 항상 같은 최신 데이터를 볼 수 있습니다.

데이터 종류	저장 위치	특징
발주서, 업체, 자재, 현장	Firebase Firestore	전 직원 실시간 공유, 클라우드 영구 보관
계약서, 계약 항목	Firebase Firestore	동일
자재 코드DB (V164)	Firebase Firestore	전 직원 실시간 공유 ☁️
학습DB, 매칭규칙 (V164)	Firebase Firestore	전 직원 실시간 공유 ☁️
로그인 세션	브라우저 (Firebase Auth)	자동 유지

V164부터 자재코드매칭도 Firestore 클라우드로 전환 완료. 모든 시스템이 클라우드 저장됩니다.

데이터가 사라지는 경우는 거의 없습니다. Firebase 클라우드는 99.99% 가용성을 보장합니다.

3. V164 자재코드매칭 시스템 V164

내역서(견적서)의 품명·규격을 코드DB와 비교하여 자재 코드를 자동 매칭하고, 매칭 결과를 학습하여 다음 분석 시 정확도를 높이는 시스템입니다.

3.1 화면 구성

영역	설명
상단 상태바	📚 LEARNED (학습건수) / ✂️ RULES (자동규칙 수) / 🗄 코드DB N건
① 발주서(기준)	코드DB 패널. 자재코드/품명/규격 목록 (3열 형식)
② 내역서(대상)	매칭 대상 내역서 붙여넣기 영역 (품명/규격 2열 형식)
분석 시작 버튼	코드DB와 내역서를 비교하여 자동 매칭 실행
우상단 아이콘	💾 백업 내보내기 / 📂 백업 가져오기(복원)

3.2 코드DB 관리

① 코드DB 불러오기

엑셀에서 코드 / 품명 / 규격 3열 데이터를 선택하고 복사(Ctrl+C)합니다.

① 발주서(기준) 패널의 빈 영역에 붙여넣기(Ctrl+V)하거나, 업로드 버튼으로 CSV 파일을 업로드합니다.

상단에 코드DB N건 ✓ 표시되면 로드 완료입니다.

3.3 내역서 분석 및 코드 매칭

매칭할 내역서에서 품명 / 규격 2열을 선택하고 복사(Ctrl+C)합니다.

② 내역서(대상) 패널에 붙여넣기(Ctrl+V)합니다.

"🔍 분석 시작" 버튼을 클릭합니다.

결과 목록에서 매칭 결과를 확인합니다:

🟢 매칭됨: 코드DB에서 자재코드 자동 검색 완료
🟡 유사매칭: 유사한 품목 발견, 검토 필요
🔴 미매칭: 코드DB에 없는 품목, 수동 연결 필요

미매칭 항목을 클릭하여 코드DB에서 직접 선택합니다. 선택 시 자동으로 학습됩니다.

3.4 학습 기능 (LEARNED / RULES)

항목	설명
LEARNED	수동 매칭 시 "이 품명 = 이 코드"를 기억. 다음 분석 시 자동 적용
RULES	특정 키워드 패턴에 코드를 자동 연결하는 규칙. 빠른 일괄 매칭 가능

학습이 쌓일수록 자동 매칭 정확도가 높아집니다. 처음에는 수동으로 연결하면서 학습을 축적하세요.

3.5 V164 백업 및 복원

V164부터 코드DB·학습DB·규칙이 Firestore 클라우드에 저장됩니다. PC 교체 시에도 동일한 데이터를 사용할 수 있습니다.

백업 (내보내기)

우상단 💾 저장 아이콘을 클릭합니다.

JSON 백업 파일이 다운로드됩니다. (코드DB + 학습DB + 규칙 포함)

구글 드라이브 공유 폴더에 저장합니다.

복원 (가져오기)

우상단 📂 불러오기 아이콘을 클릭합니다.

저장해 둔 V164 백업 JSON 파일을 선택합니다.

상태바에 복원된 건수가 표시됩니다.

4. 계약대비발주 현황 시스템 v1.2.22

공사현장별 계약서를 등록하고, 발주서 데이터와 연결하여 계약 항목별 발주 집행률을 실시간 분석하는 시스템입니다.

4.1 화면 구성 및 탭 설명

탭	기능
대시보드	현장별 계약금액·발주금액·실행률 한눈에 확인
계약서 관리	계약 내역서 등록, 항목별 코드 매칭, V164 연동
계약대비발주	계약 항목별 발주 집행률 상세 분석
발주현황	코드별·현장별 발주 집계 현황
백업/복원	데이터 백업 및 복원 (Firestore 기반)

4.2 계약서 관리

① 계약서 신규 등록

계약서 관리 탭을 클릭합니다.

"+ 새 계약 등록" 버튼을 클릭합니다.

현장명, 계약처, 계약금액을 입력합니다.

계약 내역서(엑셀)의 항목을 복사하여 붙여넣기합니다.

"저장"을 클릭합니다. Firestore에 즉시 저장됩니다.

4.3 계약대비발주 분석

계약대비발주 탭 → 상단 현장 선택 드롭다운에서 분석할 현장을 선택합니다.

계약 항목별 발주금액·집행률이 표시됩니다.

각 항목 행을 클릭하면 해당 항목의 발주서 상세 목록이 표시됩니다.

4.5 V164 코드 연동

v1.2.22부터 발주 데이터는 Firebase Firestore에서 자동 로드됩니다. 별도 백업 파일 가져오기 불필요.
V164 학습DB 업데이트 후 V1.2.22에서 📚 학습DB ↺ 새로고침 버튼을 눌러 최신 데이터를 반영하세요.

4.6 백업 및 복원

Firestore 클라우드에 자동 저장되므로 필수 백업은 불필요합니다. 중요한 시점(월말, 분기말)에 JSON 백업을 다운로드해 두는 것을 권장합니다.

백업/복원 탭을 클릭합니다.

"전체 백업 다운로드"를 클릭하여 JSON 파일을 저장합니다.

복원 시: 복원 영역에 JSON 파일 드래그 또는 선택합니다.

5. 발주서 작성 v3.4.47

발주서 작성 탭은 시스템의 핵심입니다. 업체를 선택하고 품목을 입력한 후 저장하면 Firestore 클라우드에 즉시 보관됩니다.
저장 전 반드시 "미발주/재발주 품목 체크"로 수량·단가 누락 여부를 확인하세요!

5.1 새 발주서 작성 순서

STEP 1 — 업체(공급자) 선택

화면 우측 "공급자" 검색창에 업체명 또는 초성을 입력합니다.
예) "삼" 입력 → "삼보자재", "삼광건설" 등 목록 자동 표시

드롭다운에서 업체를 선택하면 사업자번호, 주소, 담당자, 계좌번호가 자동으로 채워집니다.

업체가 목록에 없으면 마스터 관리 → 업체관리 탭에서 먼저 등록하세요. 등록 즉시 모든 직원 화면에 반영됩니다.

STEP 2 — 헤더 정보 입력

항목	설명	비고
발주번호	저장 시 자동 생성 (예: PO-20260315-001)	자동
발주일자	오늘 날짜 자동 입력, 클릭하여 수정 가능	자동
현장명	드롭다운에서 등록된 현장 선택 (필수)	✅ 필수
납기요청일	기본값: 오늘 + 3일. 엑셀 붙여넣기 시 날짜 숫자 자동 변환	-
납기장소	현장 선택 시 현장주소 자동 입력, 수정 가능	자동
비고	발주서 상단 참고사항 자유 입력	-

5.2 품목 입력 방법

방법 A — 직접 입력 (소량 품목)

"+ 품목 행 추가" 버튼을 클릭하면 새 행이 추가됩니다.

각 셀을 클릭하여 입력합니다:

컬럼	입력 내용	비고
자재코드	V164 코드DB의 자재코드 입력	없으면 공란 가능
품명	자재 품명	✅ 필수
규격	자재 규격 (예: Ø25×6M)	-
단위	EA, M, KG, SET 등	-
수량	발주 수량 (숫자)	⚠️ 0이면 미발주로 체크됨
단가	단가 (숫자, 원 단위)	⚠️ 0이면 재발주 체크됨
금액	수량 × 단가 자동계산	자동

행을 삭제하려면 해당 행 우측 "✕" 버튼을 클릭합니다.

방법 B — 엑셀에서 복사 붙여넣기 (다량 품목, 권장)

엑셀에서 품목 데이터(자재코드, 품명, 규격, 단위, 수량, 단가 등)를 선택하고 Ctrl+C로 복사합니다.

발주서 하단의 "엑셀에서 품목 복사 붙여넣기로 일괄 추가" 패널을 클릭하여 펼칩니다.

패널 안의 텍스트 영역에 Ctrl+V로 붙여넣기합니다.

열 매핑 드롭다운에서 각 열이 어떤 항목인지 확인·조정합니다.

"품목 추가" 버튼을 클릭하면 한 번에 여러 행이 입력됩니다.

엑셀의 날짜 숫자(예: 46027)는 자동으로 날짜(2026-01-05)로 변환됩니다. 납기일 입력 시 유용합니다.

엑셀에서 복사 시 수량 또는 단가가 비어 있으면 0으로 입력됩니다. 붙여넣기 후 반드시 5.5절의 "미발주/재발주 품목 체크"를 실행하세요.

5.3 발주서 저장 및 인쇄

품목 입력 완료 후 "💾 발주서 저장" 버튼을 클릭합니다.

저장 성공 시 발주번호(PO-YYYYMMDD-NNN)가 자동 부여되고, Firestore에 즉시 저장됩니다.

저장 즉시 다른 직원 화면에도 반영됩니다 (F5 새로고침 후 확인).

인쇄 시 "🖨️ 인쇄 미리보기" 버튼 클릭 → 인쇄 창에서 Ctrl+P를 누릅니다.

인쇄 설정: 용지 A4, 여백 기본값, 배경 그래픽 옵션 체크 (도장·로고 인쇄를 위해 필수).

5.4 발주서 상태 관리

각 발주서에 상태를 지정하여 처리 현황을 관리할 수 있습니다.

상태	의미	사용 시점
🆕 신규	발주서 작성 직후 기본 상태	발주서 저장 시 자동 지정
⚙️ 진행	업체에 발주 완료, 납품 대기 중	발주 확인 후 수동 변경
✅ 완료	납품 완료 또는 세금계산서 처리 완료	납품 확인 후 수동 변경
❌ 취소	발주 취소됨	발주 취소 시 수동 변경

발주 현황 탭에서 해당 발주서 행을 클릭하여 열기

발주서 상단 "상태" 드롭다운에서 변경

"💾 발주서 저장"으로 저장

5.5 📋 미발주/재발주 품목 체크 (저장 전 필수 확인!)

발주서 작성 중 수량이 0이거나 단가가 0인 품목이 있으면 자동으로 경고 패널이 표시됩니다.
이 기능으로 실수로 빠뜨린 수량·단가를 저장 전에 반드시 점검하세요.

구분	조건	의미 및 조치
🔴 수량=0	수량 항목이 0	미발주 품목. 실제 발주 수량을 입력하거나, 의도적 샘플이면 "재발주 대상 제외"
🟡 단가=0	단가 항목이 0	단가 미입력. 업체 견적 확인 후 단가 입력 필요 (금액=0으로 발주서 인쇄됨)
🔵 샘플/무상	품명에 "샘플", "무상" 포함	자동으로 재발주 대상에서 제외됨

체크 패널 버튼 기능

버튼	동작
전체선택	모든 품목 체크
전체해제	모든 체크 해제
재발주 대상만	샘플/무상 제외, 수량/단가=0 품목만 자동 선택
📥 체크항목 엑셀	선택한 품목을 엑셀 파일로 다운로드 (재발주 요청서 활용)
📋 클립보드 복사	선택 품목을 탭 구분 형식으로 복사 (메일·메모장에 바로 붙여넣기)

수량=0 또는 단가=0인 채로 저장하면 발주서에 금액이 0원으로 인쇄됩니다.
실수 발주를 방지하기 위해 저장 전 이 체크 패널을 반드시 확인하세요.

실무 활용 팁: 엑셀에서 품목을 붙여넣기한 직후, "재발주 대상만" 버튼을 눌러 빠진 항목을 즉시 확인하고 "📥 체크항목 엑셀"로 보완 요청 목록을 뽑으세요.

6. 발주 현황 v3.4.47

저장된 모든 발주서를 목록으로 조회, 편집, 삭제하고 다양한 형식으로 내보내는 탭입니다.

6.1 발주서 목록 조회 및 기본 필터

필터 항목	사용법	팁
🔍 검색창	업체명, 현장명, 발주번호, 품명 등 자유 검색	두 글자 이상 입력 시 즉시 필터링
🏗️ 현장 선택	특정 현장의 발주서만 표시	보라색 테두리 드롭다운
상태 선택	신규 / 완료 / 취소	"신규" 선택 시 미처리 발주서만 확인
날짜 범위	발주일 기준 시작일~종료일	이번 달 발주 조회 시 활용

6.2 고급 필터

① 계약연결 상태 필터 (초록색 테두리 드롭다운)

옵션	의미	활용
❌ 미연결	발주서의 품목이 계약코드와 하나도 연결 안 됨	계약연결이 필요한 발주서 목록 파악
⚠️ 일부연결	일부 품목만 계약코드와 연결됨	계약연결 미완료 발주서 추적
✅ 전체연결	모든 품목이 계약코드와 연결됨	집계가 완전히 반영되는 발주서 확인
⬜ 코드없는품목 포함	자재코드가 없는 품목이 포함된 발주서	코드 입력이 필요한 발주서 식별

② 품목상태 필터 (빨간 테두리 드롭다운)

옵션	의미	활용
🔴 수량/단가=0 포함	한 품목이라도 수량 또는 단가가 0인 발주서	미발주/재발주 대상 발주서 전체 조회
수량=0 포함	수량이 0인 품목이 있는 발주서	미발주 확인
단가=0 포함	단가가 0인 품목이 있는 발주서	단가 미입력 발주서 찾기
✅ 전부 정상	수량, 단가 모두 정상인 발주서만	정상 처리된 발주서만 집계 시 활용

신규 입사자 체크포인트: "🔴 수량/단가=0 포함" 필터로 전체 미발주 발주서를 한 번에 확인하고, 각 발주서를 열어 5.5절의 체크 기능으로 수정하세요.

6.3 발주서 편집 및 삭제

목록에서 수정할 발주서 행을 클릭합니다.

발주서 작성 탭으로 자동 이동하며 해당 발주서가 로드됩니다.

내용 수정 후 "💾 발주서 저장"을 클릭합니다. 기존 데이터가 덮어씌워집니다.

삭제 시: 발주서 하단 "🗑️ 삭제" 버튼 클릭 → 확인 팝업에서 승인합니다.

삭제한 발주서는 복구가 어렵습니다. 삭제 전 반드시 확인하세요. 취소 상태로 변경 후 보관하는 것을 권장합니다.

6.4 엑셀 내보내기 종류

발주 현황 탭 상단에 4가지 내보내기 버튼이 있습니다. 현재 필터 조건이 적용된 데이터가 내보내집니다.

버튼	파일 내용	활용 용도
⬇️ CSV 요약	발주서별 요약 (발주번호, 업체, 현장, 합계금액)	현황 빠른 확인, 경량 데이터
📊 품목상세 엑셀	모든 발주서의 품목 행 전체 (자재코드·품명·수량·단가 포함)	품목별 집계, 회계 처리
📦 자재현황 엑셀	자재코드별 발주 현황 집계 (동일 코드 발주 합산)	자재 사용량 분석, 재고 관리 참고
📋 ERP 발주집계표	ERP 입력용 형식으로 정리된 발주 집계표	외부 ERP 시스템 연동, 회계 부서 제출

실무 팁: 월말 마감 시 "📊 품목상세 엑셀"로 해당 월 전체 발주 내역을 내려받아 회계팀에 전달하세요. "🏗️ 현장 선택" 필터로 현장별 내보내기도 가능합니다.

6.5 납기일 날짜변환

엑셀에서 날짜를 복사·붙여넣기하면 납기일이 숫자(예: 46027)로 저장되는 경우가 있습니다.
이 경우 발주서에 납기일이 숫자로 인쇄됩니다. 아래 방법으로 일괄 변환하세요.

발주 현황 탭 검색 영역 우측의 "📅 납기일 날짜변환" 버튼을 클릭합니다.

시스템이 전체 발주서를 검사하여 숫자 형태의 납기일을 날짜(YYYY-MM-DD)로 자동 변환합니다.

변환 완료 메시지에서 처리된 건수를 확인합니다.

v3.4.47부터 붙여넣기 시 자동 변환되지만, 이전에 입력된 데이터가 숫자로 남아 있는 경우 이 버튼으로 일괄 정리하세요.

7. 마스터 관리 v3.4.47

업체, 자재, 현장 기준 데이터를 관리합니다. 모든 데이터는 Firestore에 즉시 저장되어 전 직원이 공유합니다.
발주서 작성 전에 업체·현장을 먼저 등록해 두어야 발주서 작성이 원활합니다.

7.1 업체 관리

① 업체 신규 등록

마스터 관리 → 업체관리 서브탭을 클릭합니다.

"+ 업체 추가" 버튼을 클릭하면 입력 폼이 표시됩니다.

아래 항목을 입력합니다:

항목	설명	필수
업체명	업체 상호명 (발주서·세금계산서에 표시됨)	✅
사업자번호	000-00-00000 형식. 세금계산서 자동 매칭에 필수	✅
대표자	대표자 이름 (발주서 인감란에 표시)	-
업태/종목	사업 분류	-
주소	업체 주소	-
담당자명 / 전화 / 팩스	연락 담당자 정보	-
이메일	발주서 이메일 전송 시 사용	-
은행 / 계좌번호	대금 지급 계좌 정보	-

사업자번호를 정확히 입력해야 세금계산서 탭에서 자동 매칭이 됩니다. 반드시 000-00-00000 형식으로 입력하세요.

② 업체 검색 및 수정

업체관리 탭 상단 검색창에서 업체명 또는 사업자번호로 검색합니다.
목록에서 업체를 클릭하면 수정 폼이 열립니다. 수정 후 "저장"을 클릭합니다.
삭제 시 "삭제" 버튼을 클릭합니다. 해당 업체로 작성된 발주서는 삭제되지 않습니다.

7.2 현장 관리

① 현장 신규 등록

마스터 관리 → 현장관리 서브탭을 클릭합니다.

"+ 현장 추가" 버튼을 클릭합니다.

항목	설명	필수
현장명	현장 식별 이름 (발주서 현장 선택 드롭다운에 표시됨)	✅
현장주소	발주서 작성 시 납기장소에 자동 입력됨	권장
현장소장	소장 이름 및 연락처	-
발주처	원청사/시행사 이름	-
공사 기간	착공일~준공일	-

현장주소를 등록해 두면 발주서 작성 시 현장 선택만으로 납기장소가 자동 채워집니다. 매번 직접 입력할 필요가 없습니다.

7.3 자재 관리

자주 사용하는 자재(품명·규격·단위·단가)를 등록해 두면 발주서 작성 시 자재 검색으로 빠르게 입력할 수 있습니다.

① 자재 신규 등록

마스터 관리 → 자재관리 서브탭을 클릭합니다.

"+ 자재 추가" 버튼을 클릭합니다.

항목	설명	필수
자재코드	V164 코드DB와 일치하는 코드 입력 (계약연결에 사용)	✅
품명	자재 품명	✅
규격	자재 규격 (예: Ø25×6M, 100×100)	-
단위	EA, M, KG, SET, BOX 등	-
기준단가	발주서 입력 시 기본 단가로 자동 입력됨	-

실무 팁: 자재 마스터에 기준단가를 입력해 두면, 발주서에서 자재코드로 검색 시 단가가 자동 채워집니다. 견적 시간을 단축할 수 있습니다.

자재 마스터의 자재코드는 V164 코드DB의 코드와 동일하게 맞춰야 계약연결 기능에서 정확히 매칭됩니다.

8. 세금계산서 v3.4.47

업체로부터 받은 세금계산서를 등록하고, 발주 금액과 대조하여 청구 현황을 관리합니다.

8.1 세금계산서 등록

세금계산서 → "등록/관리" 서브탭을 클릭합니다.

홈택스 또는 전자세금계산서에서 내용을 복사합니다.

텍스트 입력 영역에 붙여넣기(Ctrl+V)합니다.

"🔍 파싱 미리보기" → 내용 확인 → "✅ 입력 완료 (저장)"을 클릭합니다.

8.2 발주 대조표 (청구율 확인)

컬럼	설명
발주금액	해당 업체로의 발주서 금액 합계
세금계산서 공급가	등록된 세금계산서 공급가액 합계
차이	발주금액 - 세금계산서 공급가
청구율	세금계산서 / 발주금액 × 100%

상태	조건	의미
100% 일치	차이 0원	완전 청구
분할납품	세금계산서 < 발주금액	미청구 금액 있음
초과청구	세금계산서 > 발주금액	확인 필요

8-2. 📊 통계/분석 탭 v3.4.47

발주 데이터를 기간·현장·업체별로 집계하여 경영 현황을 분석하는 탭입니다.
테이블 행을 클릭하면 해당 조건으로 자동 필터링되는 인터랙티브 방식입니다.

화면 상단 — 필터 조건

필터	설명
기간 (년/월)	연도·월 선택. 월을 "전체월"로 선택하면 연간 합계 표시
현장	특정 현장만 집계. "전체현장" 선택 시 모든 현장 합산
업체	특정 업체만 집계
상태	신규/완료/취소 필터
⬇️ 엑셀 내보내기	현재 필터 조건의 통계 결과를 엑셀로 저장

KPI 카드 (4개)

카드	표시 내용
총 발주건수	조회 기간의 발주서 총 건수
총 발주금액	공급가액 합계 (VAT 제외)
평균 발주금액	발주서 1건당 평균 금액
완료율	전체 중 완료 상태 비율 (%)

월별 발주 현황 테이블

년월, 발주건수, 공급가액, VAT포함, 완료건, 신규건을 월별로 표시
행 클릭 → 해당 월로 자동 필터링. 다시 클릭 시 해제
전년 동월과 비교하여 증감 추세 파악에 활용

현장별 / 업체별 발주 현황

테이블	컬럼	활용
🏗️ 현장별	현장명, 건수, 공급가액	현장별 발주 규모 비교, 예산 집행 현황 파악
🏢 업체별	업체명, 건수, 공급가액	주요 협력사 거래 규모 확인, 업체 의존도 분석

업체별 테이블에서 업체 행을 클릭하면, 화면 아래 "🔍 자재 상세 분석" 카드가 열리며 해당 업체로 발주한 자재 현황을 상세히 확인할 수 있습니다.

자재 상세 분석 (업체 클릭 시 표시)

선택 업체의 자재코드별 발주 건수·금액 집계
동일 자재를 반복 발주한 이력 확인 가능
단가 추이 분석 (동일 자재의 발주 단가 변동 확인)
✕ 닫기 버튼으로 상세 패널 닫기

월말 정산 시 "업체별 발주 현황"에서 각 업체의 이번 달 발주 총액을 확인하고, 세금계산서 청구금액과 비교하세요.

8-3. 🔗 계약연결 탭 v3.4.47

발주서의 자재코드와 v1.2.22 계약대비발주 시스템의 계약코드를 연결(매칭)하는 탭입니다.
연결이 완료되어야 계약대비발주 현황 탭에서 발주 집행률이 정확히 계산됩니다.

계약연결이 필요한 이유

예시: 계약서에 "PVC관 Ø100" 항목이 있고, 발주서에 자재코드 "PVC-100"으로 발주했다면,
이 두 개를 연결해야 "PVC관 Ø100 항목의 발주율 = 계약 수량 대비 발주 수량 %"가 자동 계산됩니다.
연결하지 않으면 발주율이 0%로 표시됩니다.

사용 방법

계약연결 탭을 클릭합니다. (상단 네비게이션에서 "🔗 계약연결" 버튼)

상단 "현장 선택" 드롭다운에서 연결할 현장을 선택합니다.

연결 현황 요약이 표시됩니다:

✅ 연결됨: N건 / ❌ 미연결: N건 / 연결률 N%

"⚡ 자동연결" 버튼을 클릭합니다. 자재코드와 계약코드가 동일한 항목을 자동으로 연결합니다.

자동연결 후 남은 미연결 항목은 목록에서 직접 계약코드를 선택하여 수동 연결합니다.

연결 완료 후 v1.2.22 계약대비발주 탭에서 집행률이 업데이트됩니다.

발주 현황 탭에서 일괄 계약연결

발주 현황 탭에서 여러 발주서 체크박스를 선택합니다.

"🔗 선택항목 계약연결" 버튼(보라색)을 클릭합니다.

선택한 발주서의 자재코드가 계약코드와 자동 매칭됩니다.

계약연결은 발주서 저장 후 진행하세요. 발주서 저장 전에는 연결할 코드가 없습니다.

8-4. 📜 히스토리 탭 (활동 로그) v3.4.47

시스템에서 발생한 모든 작업(발주서 저장·수정·삭제, 마스터 등록·삭제, 백업·복원 등)이
자동으로 기록되는 활동 로그입니다. 누가, 언제, 무엇을 했는지 추적할 수 있습니다.

기록되는 활동 종류

활동 코드	의미	예시
PO_SAVE	발주서 신규 저장	"PO-20260315-001 저장 (삼보자재 / 현장A)"
PO_EDIT	기존 발주서 수정	"PO-20260315-001 수정"
PO_DELETE	발주서 삭제	"PO-20260315-001 삭제"
SUP_SAVE	업체 등록/수정	"업체 '삼보자재' 저장"
SUP_DELETE	업체 삭제	"업체 '삼보자재' 삭제"
MAT_SAVE	자재 등록/수정	"자재 'PVC-100' 저장"
SITE_SAVE	현장 등록/수정	"현장 '현장A' 저장"
BACKUP	JSON 백업 파일 생성	"백업 파일 다운로드"
RESTORE	백업 파일로 복원	"백업 복원 완료"

필터 및 조회

상단 히스토리 탭 클릭 (또는 네비게이션에서 "📜 히스토리" 버튼)

우측 필터 드롭다운으로 조건을 설정합니다:

전체 PC / 특정 PC: 특정 사용자(PC) 기준으로 필터
전체 액션 / 특정 액션: PO_SAVE, PO_DELETE 등 특정 작업만 조회

"🔄 새로고침" 버튼으로 최신 로그를 불러옵니다.

실무 활용 예시

상황	히스토리 활용 방법
발주서가 갑자기 없어졌을 때	PO_DELETE 필터로 삭제 이력 확인 → 누가/언제 삭제했는지 파악
발주서 금액이 바뀐 것 같을 때	PO_EDIT 필터 → 해당 발주번호 수정 이력 확인
특정 직원의 작업 내역 확인	PC 필터에서 해당 직원 PC명 선택
최근 백업/복원 시점 확인	BACKUP·RESTORE 필터로 마지막 백업 날짜 확인

히스토리는 Firestore의 activityLog 컬렉션에 저장됩니다. 설정에 따라 90일간 보관됩니다. 관리자(유수문님)가 보관 기간을 조정할 수 있습니다.

9. 백업/복원

9.1 Firebase 모드에서의 백업 개념

Firebase Firestore에 모든 데이터가 실시간 저장되므로 이전 방식(매일 백업 필수)과 다릅니다.
다음 경우에 백업을 권장합니다:
• 월말/분기말 스냅샷 보관
• 대량 데이터 삭제 전 안전망
• 회사 자체 데이터 보관 정책에 따라

9.2 시스템별 백업 방법

시스템	백업 방법	파일 형식	필요성
V164	우상단 💾 아이콘 클릭	`자재매칭_통합백업_YYYY-MM-DD.json`	선택 권장 (Firestore 저장)
v1.2.22	백업/복원 탭 → "전체 백업 다운로드"	`계약대비발주_백업_YYYYMMDD.json`	선택 권장
v3.4.47	백업/복원 탭 → "📥 전체 백업 다운로드"	`YYYYMMDDHHMMSS_발주서백업.json`	선택 권장

9.3 복원 방법

복원 시 Firestore의 현재 데이터가 백업 파일로 덮어쓰기됩니다. 복원 전 현재 상태 백업 권장.

각 시스템의 백업/복원 탭을 클릭합니다.

복원 영역에 JSON 파일을 드래그하거나 파일 선택 버튼으로 선택합니다.

확인 팝업에서 "확인"을 클릭합니다.

복원 완료 후 자동 새로고침됩니다.

10. 팀 계정 관리 (Firebase Authentication)

10.1 계정 구조

Firebase Authentication으로 직원 계정을 관리합니다. 최대 10명까지 등록 가능.

항목	내용
계정 방식	이메일 / 비밀번호
관리자	유수문님 (Firebase Console 접근 권한)
최대 사용자	10명
비용	무료 (Firebase 무료 플랜)

10.2 신규 직원 계정 등록 절차

관리자(유수문님)가 Firebase Console에서 진행:

Firebase Console (console.firebase.google.com) 접속

프로젝트 untech-poju 선택

Authentication → Users 탭 → "Add user" 버튼 클릭

직원 이메일 / 임시 비밀번호 입력 후 추가

직원에게 이메일과 임시 비밀번호 전달

직원이 최초 로그인 후 비밀번호 변경 가능

10.3 일상적인 사용 흐름

상황	절차
작업 시작	웹 브라우저에서 https://untech-poju.web.app 접속 → (자동 로그인 유지)
다른 PC에서 작업	동일 주소 접속 → 로그인 → 동일한 데이터 바로 사용
퇴근 시	그냥 브라우저 닫기 (데이터 자동 저장됨)
데이터 공유	불필요 (Firestore 실시간 자동 동기화)
월말 백업	백업/복원 탭에서 JSON 다운로드

11. 자주 묻는 질문 (FAQ)

Q1. 처음 접속했는데 에러가 떠요

인터넷 연결 상태 확인
주소 확인: https://untech-poju.web.app (http가 아닌 https)
Chrome 브라우저 사용 권장

Q2. 로그인이 안 돼요 (비밀번호 오류)

이메일/비밀번호 대소문자 확인

비밀번호 분실 시 관리자(유수문님)에게 연락

관리자가 Firebase Console에서 비밀번호 재설정 메일 발송 가능

Q3. 로그인은 됐는데 데이터가 안 보여요

처음 접속하는 경우 데이터가 없는 것이 정상입니다.
기존 로컬 백업 데이터가 있다면: 백업/복원 탭 → JSON 파일로 복원하세요.

Q4. 내가 저장한 발주서가 다른 직원 화면에도 즉시 보이나요?

예! Firestore 실시간 동기화로 저장 즉시 모든 직원 화면에 반영됩니다.
다른 직원이 화면을 새로고침(F5)하면 바로 확인할 수 있습니다.

Q5. V164 코드DB를 다른 PC에서 쓰려면?

V164부터 Firestore 클라우드 저장으로 전환되었습니다.

V164에 로그인하면 모든 PC에서 동일한 데이터를 바로 사용할 수 있습니다.

구글 드라이브에 저장

별도 백업/복원 없이 바로 사용하세요.

Q6. 여러 명이 동시에 같은 발주서를 수정하면?

동시 편집 시 마지막으로 저장한 내용이 유지됩니다.
같은 발주서를 두 명이 동시에 열어 수정하는 것은 피해 주세요.

Q7. 인쇄가 이상하게 나와요

반드시 Chrome 브라우저에서 인쇄하세요.
용지 크기: A4, 여백: 기본값으로 설정합니다.
배경 그래픽 옵션을 활성화해야 도장/로고가 인쇄됩니다.

Q8. 데이터가 사라진 것 같아요

Firebase Firestore는 클라우드에 안전하게 보관됩니다. 거의 사라지지 않습니다.
필터 조건이나 현장 선택이 잘못되어 안 보이는 경우가 대부분입니다.
필터를 "전체"로 초기화하고 다시 확인해 보세요.

진짜 문제인 경우: 관리자(유수문님)에게 연락하세요.

Q9. 회사 밖(자택, 현장)에서도 사용할 수 있나요?

예! 인터넷이 연결된 어디서든 https://untech-poju.web.app으로 접속하여 사용할 수 있습니다.
스마트폰/태블릿 브라우저에서도 접속 가능합니다.

Q10. 엑셀에서 복사한 날짜가 숫자로 표시돼요

엑셀에서 복사 시 날짜가 숫자(예: 46027)로 붙여넣기되는 경우가 있습니다.
v3.4.47부터 자동 변환 기능이 추가되어 붙여넣기 시 자동으로 날짜(2026-01-05)로 변환됩니다.

㈜유앤테크

통합 발주관리 시스템 매뉴얼 (v3.4.47 / v1.2.22 / V164)

경기도 부천시 원미구 조마루로385번길 122 삼보테크노타워 1902호

☎ 032-324-1201 | untech1201@naver.com

🌐 https://untech-poju.web.app