From b48d3a505f714ea3a6f20d054c1bbf7289d131bb Mon Sep 17 00:00:00 2001 From: chpark Date: Thu, 7 May 2026 20:29:24 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EC=82=AC=EC=9A=A9=EC=9E=90=20=EB=A7=A4?= =?UTF-8?q?=EB=89=B4=EC=96=BC=20HTML=20=EC=B6=94=EA=B0=80=20(public/manual?= =?UTF-8?q?.html)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit URL: https://momotogether.com/manual.html - 거래처(USER) 가이드: 회원가입 / 출고 요청 / 발주 이력 / 회원정보 수정 - 관리자(ADMIN) 가이드: 발주서 관리·출고처리·거래명세표·인라인 편집·세금계산서 발행 - 마스터 관리: 품목·거래처·매입처·창고·제조사 - 매입/입고: 매입 발주·입고·재고 - 통계: 대시보드·월간/일자별/원가마진 + 엑셀 다운로드 - 전체 업무 흐름도 - FAQ: 택배 라인 / 권한 / 메일 / STUB / 모바일 단일 HTML 파일 — 인쇄 가능, 모바일 대응, 외부 폰트 X Co-Authored-By: Claude Opus 4.7 (1M context) --- public/manual.html | 440 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 440 insertions(+) create mode 100644 public/manual.html diff --git a/public/manual.html b/public/manual.html new file mode 100644 index 0000000..2946787 --- /dev/null +++ b/public/manual.html @@ -0,0 +1,440 @@ + + + + + +모모유통 ERP 사용자 매뉴얼 + + + +
+ +
+

모모유통 ERP 사용자 매뉴얼

+
유통관리 시스템 v0.6 · 발주 → 출고 → 정산 → 전자세금계산서까지
+
+ 도메인 · momotogether.com + 대상 · 거래처 · 모모유통 임직원 · 시스템 관리자 + 업데이트 · 2026-05-07 +
+
+ + + + +
+

1. 시스템 개요

+

+ 모모유통 ERP는 본사가 도매처에서 물품을 사들여 자체 창고에 적재하고, + 가입된 소매 대리점(거래처)이 시스템에서 출고를 요청하면 담당자가 검수·승인하여 출고하는 유통관리 솔루션입니다. +

+

주요 기능

+
+
거래처 발주품목 검색 → 카트 → 택배/용차 추가 → 발주 요청
+
출고 처리담당자 일괄 승인 + 거래명세표 메일 자동 발송
+
입금 관리입금 등록 → 미수금 추적
+
전자세금계산서출고/입금 후 별도 발행 (국세청 직접 연동 대비 골격)
+
통계 / 그래프일별·월별·업체별·원가/마진 분석 + 엑셀 다운로드
+
회원 권한제한수량 해지 / 숨김품목 보기 등 거래처별 특수권한
+
+ +

역할 구분

+ + + + +
역할설명
거래처 USER가입한 소매 대리점. 발주만 가능.
관리자 ADMIN모모유통 임직원. 품목/창고/회원 마스터 관리 + 출고/입금 처리 + 통계.
+
+ + +
+

2. 로그인 · 회원가입

+

로그인 (URL: /login)

+
    +
  1. 아이디 이메일 또는 사번 형태(관리자) 입력
    2. +
  2. 비밀번호 입력 후 [로그인]
    3. +
  3. 성공 시 자동 이동 → 출고 요청 화면(/m/orders/new)
    4. +
+
모든 사용자는 로그인 후 출고 요청 화면으로 이동합니다. 관리자는 좌측 메뉴에서 [출고/정산] 등으로 이동.
+ +

회원가입 (URL: /signup)

+

거래처 회원가입 전용. 모모유통 직원은 가입 X, 관리자가 직접 등록.

+ + + + + + + + + +
필드필수설명
이메일Y로그인 ID로 사용
비밀번호Y8자 이상
업체명Y거래명세표에 표시
대표자N
연락처Y휴대폰
주소Y배송지
사업자등록번호N전자세금계산서 발행 시 필수
+
비밀번호 분실 시 관리자가 [마스터 관리 → 거래처 회원 관리]에서 초기화하거나 신규 비번 발급. 본인은 [회원정보 수정] 화면에서 변경 가능.
+
+ + +
+

3. 거래처(USER) 가이드

+ +

3.1 출고 요청 (URL: /m/orders/new)

+

로그인 직후 자동으로 이 화면이 열립니다. 품목 카드를 카트에 담고 [발주 요청] 버튼으로 전송합니다.

+ +

화면 구성

+
+
/m/orders/new
+
+
🛒 발주 장바구니 [N개]면세 ₩ — | 과세 ₩ — | 합계 ₩ —  [발주 요청]
+
＋ 택배 추가 / ＋ 용차 추가전체 삭제
+
품목 검색: [품목명/코드] 전체/면세/과세[조회]
+
품목 카드 그리드 (이미지 · 단가 · 재고)＋ 담기
+
+
+ +

사용 단계

+
    +
  1. 품목 검색품목명/코드 입력 후 [조회]. 면세/과세 필터 가능.
    2. +
  2. ＋ 담기 버튼품목 카드의 [＋ 담기] 클릭 → 카트에 1개 추가. 같은 품목 다시 누르면 수량 +1.
    3. +
  3. 수량 조정카트의 [−] / [＋] 또는 숫자 직접 입력. 재고/한도(max_order_qty) 자동 클램프.
    4. +
  4. 택배/용차 추가택배 전용 품목을 담으면 자동으로 택배 라인 1줄 추가. 수동 추가는 카트의 [＋ 택배 추가] / [＋ 용차 추가].
    5. +
  5. 택배/용차 단가 · 수량기본 단가는 택배 4,000원 / 용차 5,000원. 직접 수정 가능. 같은 종류 버튼 다시 누르면 수량 +1.
    6. +
  6. [발주 요청] 클릭합계 + 품목수 확인 모달 → [발주]. 성공 시 발주번호(ORD-YYYYMMDD-NNNN) 부여.
    7. +
+ +

품목 카드 배지

+ + + + + +
배지의미
면세부가세 면제 품목
택배택배 전용 — 카트에 담으면 택배 라인 자동 추가
"1회 한도 ≤ N"1회 발주 최대 수량 제한 (관리자 권한 부여 시 무시)
+ +

3.2 내 발주 이력 (URL: /m/orders)

+
    +
  • 전체 발주 이력을 상태별로 조회
    • +
  • 출고완료(APPROVED)/입금완료(PAID)/계산서발행(INVOICED) 건은 거래명세표 엑셀 다운로드 가능
    • +
  • [엑셀] 버튼으로 전체 이력을 .xlsx 로 내려받기
    • +
+ + + + + + + +
상태의미
출고요청거래처가 발주 요청, 담당자 처리 대기
출고완료담당자 승인 후 재고 차감 + 거래명세표 메일 발송됨
입금완료대금 입금 등록 완료
계산서발행전자세금계산서 발행 완료
취소담당자 반려 또는 본인 취소
+ +

3.3 회원정보 수정 (URL: /profile)

+

헤더 우측의 자기 이름을 클릭하면 진입.

+
    +
  • 기본 정보 업체명·대표자·연락처·이메일·주소·사업자번호 수정
    • +
  • 비밀번호 변경 현재 비번 확인 후 새 비번 (4자 이상) 입력
    • +
+
+ + +
+

4. 관리자(ADMIN) 가이드

+ +

4.1 발주서 관리 · 출고처리 · 거래명세표 (URL: /m/admin/orders)

+

좌측 발주 리스트에서 선택하면 우측에 거래명세표 미리보기가 표시됩니다. 체크박스 다중 선택 후 [출고]를 누르면 일괄 처리됩니다.

+ +

화면 구성 (2분할)

+
+
/m/admin/orders — 좌:발주 리스트 | 우:거래명세표 미리보기
+
+
좌측상태 필터 · 체크박스 · ORDER-YYYYMMDD-NNNN · 일자 · 업체 · 합계 · 상태
+
우측거래명세표 [엑셀 다운로드] · ＋ 택배/용차 추가 · 라인 인라인 편집 · 합계
+
+
+ +

출고 처리 단계

+
    +
  1. 발주 선택좌측 리스트에서 출고요청 상태 발주를 체크박스로 선택 (전체선택 헤더 체크박스 가능)
    2. +
  2. [출고] 버튼상단 녹색 [출고] 클릭 → 확인 모달 → 일괄 승인
    3. +
  3. 자동 처리① 재고 차감 ② 거래명세표 .xlsx 자동 생성 ③ 거래처 이메일로 거래명세표 본문 + 첨부파일 발송 ④ 상태 → APPROVED
    4. +
  4. 결과 알림성공/실패 건수 + 메일 발송 실패 건수가 모달로 표시
    5. +
+ +

거래명세표 인라인 편집 (REQUESTED 상태에서만)

+
    +
  • [＋ 택배 추가] / [＋ 용차 추가] — 같은 종류가 이미 있으면 수량 +1, 없으면 신규 1줄 (단가 4,000/5,000 기본)
    • +
  • 택배/용차 행은 인라인 입력칸 — 담당자명·단가·수량 즉시 수정, ✓ 클릭 → 저장 / × 클릭 → 삭제
    • +
  • 품목(ITEM) 라인은 보호되어 이 화면에서 수정 불가
    • +
  • 택배/용차 라인이 품목보다 위쪽에 표시 (관행)
    • +
  • 변경 시 발주 합계(total_supply/vat/amount/delivery/charter)는 백엔드에서 자동 재집계
    • +
+ +

출고/입금 완료 후

+

거래명세표 하단에 [세금계산서 발행 (과세)] / [계산서(면세)] 버튼이 노출. 클릭 시 /api/m/einvoices/issue 호출 → 발행 결과 모달 (승인번호/처리방식).

+ +
현재 stub 모드 — 발행은 DB 기록만 수행, 국세청에 실제 전송 X. 사업자 공동인증서 + 홈택스 ERP 연계 승인 후 NTS_ESERO_MODE=test|prod 환경변수 전환 시 활성화.
+ +

4.2 입금 관리 (URL: /m/admin/payments)

+
    +
  • 출고 완료된 발주의 입금 등록
    • +
  • 입금일 / 입금액 입력 → 상태 PAID 로 전환, paid_amount/paid_date 갱신
    • +
+ +

4.3 계산서 발행 (URL: /m/admin/invoices)

+
    +
  • 월말 일괄 거래명세서/계산서 발행 (자체 PDF/엑셀)
    • +
  • 국세청 전송 X — 사업자가 홈택스에서 직접 신고하는 형태
    • +
+ +

4.4 전자세금계산서 (URL: /m/admin/einvoices)

+

출고/입금 완료된 발주에 대해 별도로 전자(세금)계산서를 발행하고 이력을 관리하는 전용 메뉴.

+

화면 구성

+
    +
  1. 발행 가능 발주 리스트출고완료/입금완료 상태 발주가 표시됨. 한 줄당 [세금계산서] 버튼.
    2. +
  2. 발행 클릭확인 모달 → /api/m/einvoices/issue 호출 → 결과 모달 (승인번호/처리방식)
    3. +
  3. 발행 이력날짜 범위·상태·거래처별 필터, [엑셀] 다운로드
    4. +
+

발행 어댑터 (env: EINVOICE_PROVIDER)

+ + + + + +
값동작비용
manual (기본)자체 거래명세서, DB 기록만0원
nts국세청 e-세로 직접 연동 (XMLDSig + SOAP)인증서 연 4~5만원
popbill(향후) Popbill REST API건당 100~150원
+

상태 머신

+

DRAFT → QUEUED → SENT → ACK | FAIL | CANCELED

+ +

4.5 마스터 관리

+ +

① 품목 관리 (/m/admin/items)

+
    +
  • 등록 / 수정 / 이미지 업로드 / 삭제(soft)
    • +
  • 주요 필드: +
      +
    • 면세/과세 — 라디오. 면세 품목은 부가세 0.
      • +
    • 발주 제한수량 (max_order_qty) — 1회 발주 최대 수량. 공란/0 = 제한 없음.
      • +
    • 숨김 처리 (is_hidden) — '숨김' 선택 시 일반 회원에게는 카드가 안 보임. 권한자만 노출.
      • +
    • 택배 전용 (requires_delivery) — '택배전용' 선택 시 카트에 담기면 택배 라인 자동 추가, 발주 시 택배 없으면 차단.
      • +
    • 제조관리 — 소비기한·원산지·입고가·보관온도·바코드·메모 (JSONB attributes).
      • +
    +
    • +
+ +

② 거래처 회원 관리 (/m/admin/customers)

+
    +
  • 거래처(user_type='C') 회원 목록 + 정보/권한 수정
    • +
  • 특수 권한 토글 두 가지: +
      +
    • 제한수량 해지 (unlimited_qty='Y') — 모든 품목의 1회 발주 한도를 무시하고 재고만큼 발주 가능
      • +
    • 숨김처리 보기 (view_hidden='Y') — 숨김 품목도 발주 화면에 노출
      • +
    +
    • +
  • 관리자 패널(/admin-panel)의 사용자 폼에서도 같은 권한 수정 가능
    • +
+ +

③ 매입처 / ④ 창고 / ⑤ 제조사

+ + + + + +
메뉴경로역할
매입처 관리/m/admin/vendors매입 발주처 등록 (도매처)
창고 관리/m/admin/warehouses적재 창고 + 픽업/입출고 분류
제조사 관리/m/admin/makers품목 제조사 마스터
+ +

4.6 매입/입고

+ + + + + +
메뉴경로역할
매입 발주/m/admin/procurements매입처에 보낼 발주서 작성
입고 처리/m/admin/inbounds발주한 품목 입고 등록 → 재고 증가
재고 관리/m/admin/inventory현재 재고 + 입출고 이력
+ +

4.7 통계 · 대시보드

+ + + + + + +
메뉴경로설명
대시보드/m/dashboard전체 요약
월간 매출/m/admin/statistics업체별 면세/과세/총 매출 (TOP15 막대그래프) + 엑셀
일자별 매출/m/admin/statistics/daily일별 매출 추이 (스택 막대 + 건수 라인) + 엑셀
원가/마진/m/admin/statistics/margin품목별 매출/원가/마진 TOP10 + 마진율 + 엑셀
+

모든 통계 화면 우상단의 [엑셀 다운로드] 버튼으로 .xlsx 파일을 받을 수 있습니다.

+
+ + +
+

5. 전체 업무 흐름도

+ 
+[거래처 USER]                       [관리자 ADMIN]
+  │                                    │
+  ① 출고 요청 작성  ─────────────►  발주서 관리 (/m/admin/orders)
+  (품목+택배/용차)                       │ 체크 + [출고] 버튼
+                                         ▼
+                                   ② 재고 차감
+                                   ③ 거래명세표 메일 발송  (status = APPROVED)
+                                         │
+  ④ 입금 ──────────────────────►  입금 관리 (/m/admin/payments)
+                                         │ 입금 등록
+                                         ▼  (status = PAID)
+                                         │
+  ⑤ 거래명세표 / 세금계산서  ◄──── 전자세금계산서 (/m/admin/einvoices)
+                                         │ [세금계산서 발행] 클릭
+                                         ▼  (status = INVOICED)
+                                   ⑥ 통계 / 매출 / 원가 마진 분석
+                                       (/m/admin/statistics/*)
+
+
+ + +
+

6. 자주 묻는 질문 / 문제 해결

+ +

Q. 발주 요청 시 "택배 전용 품목이 포함되어 택배 라인이 필요합니다" 메시지

+

A. 카트에 택배 배지 품목이 들어 있으면 반드시 택배 라인이 1줄 이상 있어야 합니다. 자동 추가되어야 정상이지만 안 되면 [＋ 택배 추가] 수동 클릭.

+ +

Q. 1회 발주 한도가 너무 작아서 더 못 담아요

+

A. 품목별 max_order_qty 제한입니다. 관리자가 [거래처 회원 관리]에서 해당 회원에게 제한수량 해지 권한을 부여하면 무시됩니다.

+ +

Q. 숨김 품목을 보고 싶어요

+

A. 일반 회원에게는 노출되지 않습니다. 관리자가 [거래처 회원 관리]에서 숨김처리 보기 권한을 부여하면 카드가 보입니다.

+ +

Q. 출고 처리 후 거래명세표 메일이 안 갔어요

+

A. 출고 모달의 결과창에 "메일 N건 실패" 표시가 있습니다. 거래처 이메일 주소를 [거래처 회원 관리]에서 확인하고 SMTP 환경변수를 점검합니다 (SMTP_HOST/PORT/USER/PASS/FROM).

+ +

Q. 전자세금계산서 발행 시 "STUB-OK" 가 떠요

+

A. 현재 NTS_ESERO_MODE=stub 입니다. 국세청에 실제 전송하지 않고 DB 기록만 합니다. 운영 활성화 절차:

+
    +
  1. 사업자용 공동인증서 발급 (한국정보인증/SignKorea, 연 4~5만원)
    2. +
  2. 홈택스 → 전자세금계산서 ERP 연계 신청 → 테스트 ID/PW 승인
    3. +
  3. .env.production 에 NTS_ESERO_MODE=test, NTS_ESERO_USER_ID/PW, NTS_ESERO_CERT_PATH/PW 설정
    4. +
  4. 테스트 환경에서 100건 모범 발행 검증 → NTS_ESERO_MODE=prod 전환
    5. +
+ +

Q. 비밀번호를 까먹었어요

+

A. 관리자가 [관리자 패널 → 사용자 관리]에서 신규 비밀번호로 초기화. 시스템 관리자(admin)도 같은 방법.

+ +

Q. 모바일에서 화면이 잘 안 맞아요

+

A. 발주 작성·통계·관리자 화면 모두 반응형으로 설계되어 있습니다 (375px ~). 헤더는 사용자명 + 로그아웃만 노출. 좌측 메뉴는 햄버거 토글로 접기/펴기.

+ +
+

+ 문서 버전: v0.6 — 2026-05-07 · 모모유통 ERP +

+
+ +
+ +