RPS PLM 시스템 사용자 매뉴얼

핵심 시나리오

1. 견적요청 등록 — 영업관리 > 견적관리 [+ 견적요청등록]. 주문유형/고객사/유무상/접수일/품목 입력.
2. 견적작성 — 행 선택 후 [견적작성]. 일반/장비 템플릿 중 선택 → 신규 차수 생성.
3. 결재상신 — 견적서가 작성된 행에서 [결재상신] → Amaranth 팝업 → 결재완료까지 대기.
4. 수주 확정 — 결재완료 시 자동으로 contract_result 가 변경되어 주문서관리에 노출됨.

⚠ 가드 조건 ① 견적서 미작성 → 결재상신 불가 ② 결재중·결재완료 건은 재상신 차단 ③ 수주확정(0000964/0000968) 행은 품목 추가/삭제 불가

제품 양산 전 단계의 부품(PART)과 설계 BOM(E-BOM)을 관리합니다. 설계변경(ECR)이 발생하면 E-BOM 의 차수가 올라가고, 변경 이력은 [설계변경 리스트]에서 추적됩니다.

수주 → M-BOM 분해 → 구매리스트 → 견적요청서 → 품의서(승인) → 발주서 → 입고 → 수입검사 순서로 진행됩니다. Amaranth 와는 거래처/계정과목 마스터를 실시간 동기화합니다.

발주서관리에서 행을 선택하면 다음 액션이 가능합니다:

• 양식 선택 — [발주서 작성] 클릭 시 양식 선택 모달이 뜹니다.
  • 일반 양식 — 국내 표준 한글 양식
  • 외주 양식 — 외주 가공 협력사용 양식
  • 영문 양식 — 해외 거래처용 영문 발주서
• 로고 / 직인 — 폼 상단에 RPS 로고, 하단에 자동으로 회사 직인 이미지가 합쳐집니다 (frontend/public/images/rps-stamp-seal.png).
• 📄 PDF 다운로드 — 양식 미리보기에서 [PDF 다운로드] 클릭 → 발주번호로 파일 저장.
• 📧 메일 발송 — [메일발송] 버튼 → 거래처 메일 자동 첨부 + PDF 동봉. SMTP_SEND_SWITCH 활성 시 실 발송.
• 읽기전용 모드 — 결재 완료된 발주서는 자동으로 읽기전용으로 잠금.

• /purchase/inbound — 전체 입고 리스트. 상단 [+ 입고등록] 으로 발주서 행 선택 → 수량 / 입고일 / 검사여부 입력.
• /purchase/inbound-by-item — 품목별 집계. 같은 part_no 의 분할 입고를 한 행에 합산.
• /purchase/inbound-by-date — 입고일별 마감. 일자 단위 [마감정보입력] → 매입 마감 처리 + Amaranth 계정과목 연계.

입고 후 창고로 들어온 자재를 관리합니다. 두 메뉴 모두 풀-CRUD + 인라인 액션을 지원합니다.

✓ 흐름 ① 입고 확정 → 자재리스트 자동 추가 ② 생산팀 [불출의뢰서] 작성 → 부서/창고/품목/수량 지정 ③ 자재팀 [불출 처리] → 실제 출고 + 재고 차감 + 이력 기록

M-BOM 으로 생산계획을 수립하고 작업지시번호 단위로 실적을 입력합니다. 장비 생산은 별도 메뉴(생산계획&실적관리(장비))에서 처리합니다.

• M-BOM 관리 — 구조 트리 + 본 편집(품목 추가/삭제) + 변경이력
• 반제품/원자재 소요량 — 계획 대비 필요 자재 자동 계산
• 생산실적 — 작업지시 단위 양품/불량 등록 (반제품검사와 inspection_group_id 로 연계)

품질관리는 4단계로 흐릅니다:

불량 발생 → 책임부서로 통보 → 수정완료 시 재생수량 가산 → 최종양품수량 자동 산정. 자세한 내용은 6. 품질관리 메뉴 가이드.

출하 완료 → 매출 인식 → Amaranth 로 세금계산서 발행. 고객 클레임은 CS 메뉴로 접수되어 분석/조치 후 종결됩니다.

위치: 관리자 > 자동화 관리 > 외부 커넥션 관리

외부 시스템(ERP / 마스터 / 공공 API) 과의 모든 연결을 한 곳에서 관리합니다. 두 종류의 탭이 있습니다:

┌────────────────────────────────────────────────────────────────────────────┐
│  외부 커넥션 관리   외부 데이터베이스 및 REST API 연결 정보를 관리합니다.   │
├────────────────────────────────────────────────────────────────────────────┤
│  [🗄 데이터베이스 연결]  [🌐 REST API 연결]  ← 탭 전환                       │
│                                                                            │
│  🔍 [연결명 또는 URL로 검색...]  [전체 ▾]  [전체 ▾]   총 7건   [+ 새 연결] │
├──────────────────────┬─────────────┬──────────────────────┬────────────────┤
│ 연결명               │ 회사         │ 기본 URL              │ 상태   테스트  │
├──────────────────────┼─────────────┼──────────────────────┼────────────────┤
│ Amaranth - 계정과목   │ COMPANY_16  │ https://erp.rps...    │ 활성   [테스트] │
│ Amaranth - 부서       │ COMPANY_16  │ https://erp.rps...    │ 활성   [테스트] │
│ Amaranth - 거래처     │ COMPANY_16  │ https://erp.rps...    │ 활성   [테스트] │
│ Amaranth - 결재       │ COMPANY_16  │ https://erp.rps...    │ 활성   [테스트] │
└──────────────────────┴─────────────┴──────────────────────┴────────────────┘

각 행의 [테스트] 버튼을 누르면 실제 호출이 발생하고 성공 / 실패 로 즉시 결과가 표시됩니다.

1. 프론트 → POST /api/sales/estimate/:id/amaranth-approval
2. JWT 에서 userId 추출 → user_info.emp_seq 조회 (없으면 401)
3. 최신 차수 estimate_template.objid 추출 → target_objid
4. amaranth_approval 기존 매핑 조회 (target_type + target_objid)
   • 없음 → 신규 approKey = UB_ + UUID
   • status ∈ {reject, delete, create} → 재상신: 새 approKey 발급
   • 그 외 → 기존 approKey 재사용
5. [외부 커넥션 관리]에서 Amaranth - 결재 레코드 조회 + 자동 복호화
6. wehago-sign 헤더 생성 (HMAC-SHA256, transaction-id, timestamp)
7. empSeq AES-128-CBC 암호화 (KST yyyyMMddHHmmss▦empSeq)
8. SSO URL 발급 API 호출 → fullUrl 수신
9. amaranth_approval INSERT 또는 UPDATE
10. 프론트로 {fullUrl, approKey, status} 반환
11. 프론트가 window.open(fullUrl, "amaranthApproval", "width=1200,height=900")

로그인 후 메인 화면(/dashboard)에서 보여지는 위젯형 대시보드입니다. 회사별로 위젯 구성이 다릅니다.

• 매출 추이 — 월별 매출 합계 라인 차트
• 수주 잔량 — 미출하 수주 막대 차트
• 리스크 / 알림 — 기상특보 / 교통사고 / 환율 (외부 API 자동 갱신, 10분 간격)
• To-Do — 결재 대기, 마감 임박 견적, 미입고 발주

위치: 관리자 > 화면 관리 > 대시보드 리스트

• 회사별 대시보드 신규 생성 / 위젯 배치 / 권한 설정
• 위젯 종류: 카드 / 라인 차트 / 막대 차트 / 파이 차트 / 그리드 / 외부 URL embed
• 저장된 대시보드는 /dashboard/{dashboardId} 경로로 접근

위치: 관리자 > 화면 관리 > 화면관리

┌─────────────────────────────────────────────────────────────────────────┐
│  ● 하이큐마그 영업 수주관리 화면                              #6456  [↻] │
├─────────────────────────────────────────────────────────────────────────┤
│  sales_order_detail                                                      │
│                                                                          │
│  메인 테이블:  sales_order_detail                                        │
│  컴포넌트:    버튼 4                                                     │
├──────────────────────────────────┬──────────────────────────────────────┤
│  🗄 테이블                    1  │  ▼ 미리보기 영역                      │
│  ┌────────────────────────────┐  │  ● 하이큐마그 영업 수주관리 화면      │
│  │ sales_order_detail         │  │                                      │
│  │ 메인 · 0 컬럼 사용중  [설정]│  │       ⌛ 화면 로딩 중...               │
│  └────────────────────────────┘  │                                      │
│                                  │                                      │
│  🔘 버튼                      4  │                                      │
│  [수주 등록 · MODAL · 플로우 1]  │                                      │
│  [수정     · EDIT  · 플로우 1]  │                                      │
│  [삭제     · DELETE          ]  │                                      │
│  [출하계획 · OPENMODALWITHDATA] │                                      │
│                                  │                                      │
│  → 데이터 흐름                0  │                                      │
│  데이터 흐름이 없어요             │                                      │
│                                  │                                      │
│           [↗ 화면 디자이너에서 편집]                                       │
└──────────────────────────────────┴──────────────────────────────────────┘

화면 카드 한 장에 ① 메인 테이블 / ② 버튼 N 개 / ③ 데이터 흐름 N 개 / ④ 미리보기 가 통합되어 있어 설정 변경 즉시 결과가 우측에 표시됩니다.

한 화면에 메인 1개 + 조인 테이블 N개를 함께 매핑할 수 있습니다.

┌─ 조인 추가 ────────────────────────────────────────────┐
│  메인:   sales_order_detail                             │
│           └── ON customer_objid = ?                     │
│  조인 1: client_mng       (LEFT JOIN)                   │
│           └── client.objid = sales.customer_objid       │
│           └── 노출 컬럼: client_nm                       │
│  조인 2: part_mng         (LEFT JOIN)                   │
│           └── part.objid = sales.product_objid          │
│           └── 노출 컬럼: part_no, part_name              │
└─────────────────────────────────────────────────────────┘

조인된 컬럼은 자동으로 partner_name 같은 별칭으로 그리드에 합쳐 보입니다.

버튼 카드 → [편집] → "플로우 연결" 화면에서 시각적 노드 편집기로 동작을 구성합니다:

┌─ 플로우 편집기 (DataFlowDesigner) ─────────────────────┐
│                                                         │
│   [버튼 클릭]                                            │
│        │                                                │
│        ▼                                                │
│   ┌──────────────────┐                                  │
│   │ 입력 검증         │  ← 필수 컬럼 null 체크 등         │
│   └──────────────────┘                                  │
│        │                                                │
│        ▼                                                │
│   ┌──────────────────┐                                  │
│   │ SQL 실행          │  → INSERT INTO sales_order...   │
│   └──────────────────┘                                  │
│        │                                                │
│        ▼                                                │
│   ┌──────────────────┐                                  │
│   │ 외부 커넥션 호출  │  → Amaranth 결재상신             │
│   └──────────────────┘                                  │
│        │                                                │
│        ▼                                                │
│   ┌──────────────────┐                                  │
│   │ 토스트 + 새로고침 │                                  │
│   └──────────────────┘                                  │
└─────────────────────────────────────────────────────────┘

경로: /COMPANY_16/quality/incoming-request

발주서 단위로 입고/검사 요청 현황을 한 줄씩 보여줍니다. 검사 디테일이 아직 없으면 "미요청", 있으면 "요청중"/"요청완료".

필터 (12종)

품의서 No · 발주서 No · 프로젝트번호 · 품번 · 품명 · 공급업체 · 입고결과 · 제품구분 · 검사여부 · 요청현황 · 요청자 · 요청일 범위

그리드 컬럼 (12개)

품의서 No · 발주서 No · 프로젝트번호 · 제품구분 · 품번 · 품명 · 공급업체 · 입고결과 · 요청일 · 요청자 · 검사여부 · 요청현황

경로: /COMPANY_16/quality/incoming-mgmt

검사자가 실제 검사를 진행하여 합/불 판정과 불량률(검사수량 대비)을 입력하는 화면입니다.

주요 컬럼 (19개)

검사일 · 검사자 · 품의서 · 발주서 · 프로젝트번호 · 제품구분 · 품명(모델명) · 부품품번 · 부품명 · 공급업체 · 입고일 · 입고수량 · 입고결과 · 검사수량 · 불량수량 · 불량률 · 검사현황 · 검사성적서(첨부파일)

불량률 = SUM(defect_qty 서브쿼리) / inspection_qty × 100, 소수점 2자리.

경로: /COMPANY_16/quality/process-inspection

작업 중 SPC 검사. 마스터 1건당 디테일 N건(검사항목)을 SUM 으로 집계하여 한 줄로 표시.

필터 (10종, 2행)

• 1행: 프로젝트번호 · 제품구분 · 품번 · 품명 · 작업환경상태 · 측정기
• 2행: 검사일 범위 · 검사자 · 검사결과 · 진행공정

그리드 컬럼 (9개)

검사일 · 검사자 · 프로젝트번호 · 제품구분 · 품번 · 품명 · 검사수량 합계 · 검사결과(OK/NG) · 첨부파일

경로: /COMPANY_16/quality/semi-product-inspection

반제품 입고에 대한 양품/불량 판정. 단일 테이블(pms_quality_semi_product_inspection)에 양품 마스터(DATA_TYPE='GOOD')와 불량 행('DEFECT')을 동일 INSPECTION_GROUP_ID 로 묶어 저장합니다.

자동 산정 컬럼

모든 업무 화면의 표는 동일한 DataGrid 컴포넌트로 통일됩니다.

• 컬럼 드래그 — 헤더 ⋮⋮ 영역을 드래그해 컬럼 순서 변경
• 정렬 — 헤더 클릭 (asc/desc 토글)
• 필터 — 헤더 옆 깔때기 아이콘 → 고유값 체크박스 다중 선택
• 인라인 편집 — 셀 더블클릭 (편집 가능 컬럼만)
• 🔃 새로고침 / 📊 차트 / ⬇ 엑셀 다운로드 / ⚙ 컬럼 표시 설정 — 그리드 우상단 툴바
• 페이지 사이즈 — 우하단 드롭다운 (10/15/20/50/100)