Files

권혁성 a320c85e94 docs: [quality] 품질관리 스토리보드 D1.9 분석 문서 작성

- 17장 슬라이드 기반 개발 참조용 MD 문서
- 화면별 상세 명세 (제품검사, 실적신고, 품질인정심사)
- 데이터 모델, 비즈니스 규칙, API 엔드포인트 설계 포함

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-05 16:37:31 +09:00

33 KiB

Raw Blame History

품질관리 스토리보드 명세 (D1.9)

소스: SAM_MES_경동기업_품질관리_Storyboard_D1.9_260224 (17 slides) 용도: API 설계 및 기능 구현 시 Claude 참조 문서 작성일: 2026-03-05

1. 전체 프로세스 플로우

1.1 역할 정의

역할	담당 업무
매출 거래처	주문(전화/카톡/팩스/메일)
견적/수주 담당자	견적 작성 → 수주 전환 → 수주서 작성 → 생산지시 생성
생산 담당자	생산 부서 할당 → 재고/원자재 체크 → 공정 작업 → 중간검사 → 생산 완료
출고 담당자	출고 대기 → 출고 완료
품질 담당자	제품검사 신청(거래처 요청) → 검사원 일정 관리 → 검사원 현장 방문 및 검사 진행 → 합격 여부 판정 → 실적 신고 관리 → 품질 인증 심사
자재 담당자	입고 등록 → 수입검사

1.2 프로세스 흐름

주문 접수 → 견적 작성 → 수주 전환 판단(미완료시 대기)
    → 수주서 작성(견적서 선택) → 생산지시 생성
    → 재고 소요량 충분? → (부족 시) 자재 담당자: 입고등록 → 수입검사
    → 생산 부서 할당 → 재고/원자재 투입 체크 → 공정 작업 진행 → 중간검사 → 생산 완료
    → 출고 대기 → 출고 완료
    → 품질 담당자: 제품검사 신청 → 검사원 일정 관리 → 현장 방문 및 검사 → 합격?
        → (합격) 실적 신고 관리 → 품질 인증 심사
        → (불합격) 재검사 루프 (점선으로 표시)

* 분할 수주/생산/출고는 1차 이후 반복 가능

2. 화면 명세

2.1 제품검사 목록 (슬라이드 2-3)

경로: 품질관리 > 제품검사관리 URL 제안: /quality/product-inspections

2.1.1 상단 요약 카드

필드	타입	설명
접수	number	접수 상태 건수
진행중	number	진행중 상태 건수
완료	number	완료 상태 건수

2.1.2 필터

필터	타입	옵션	기본값
기간	date_range	시작일~종료일	최근 1개월
상태 바로가기	button_group	전체/접수/전점별/진행/미완/어제/오늘	전체
검색	text	키워드 검색	-

2.1.3 목록 테이블

컬럼	필드명(추정)	타입	설명
No.	row_number	-	자동 번호
품질관리서 번호	quality_doc_number	string	품질관리서 고유번호
번호	id	integer	PK
수주처	client_name	string	거래처명
개소	location_count	integer	검사 대상 개소 수
실적신고 필수정보	required_info_status	string	"3건 누락", "4건 누락" 등 빨간색 표시
검사기간	inspection_period	date_range	시작일~종료일 (여러 줄 가능)
검사자	inspector_name	string	검사원 이름
상태	status	enum	접수/진행중/완료
작성자	created_by	string	등록자
접수일	received_date	date	접수 날짜

액션:

제품검사 등록 버튼 → 제품검사 상세 화면 (신규 생성 모드)
행 클릭 → 제품검사 상세 화면 (조회/수정 모드)

2.1.4 검사 스케줄 (캘린더)

목록 하단에 월간 캘린더 표시.

항목	설명
뷰	월간 캘린더
필터	상태 셀렉트 (전체/진행중/완료), 전체 V 토글
완료 스케줄	회색 바, 텍스트: "홍길동 - 현장명 / 완료"
진행중 스케줄	파란 바, 텍스트: "홍길동 - 현장명 / 진행중"
클릭 동작	제품검사 상세 화면으로 이동
표시 기간	검사시작일 ~ 검사종료일 기간으로 바 표시
접수 미표시	검사일 미정인 접수 건은 캘린더에 표시하지 않음

2.2 제품검사 상세 (슬라이드 4-6)

경로: 품질관리 > 제품검사관리 > 제품검사 상세 URL 제안: /quality/product-inspections/{id}

2.2.1 기본 정보 섹션

필드	필드명(추정)	타입	필수	설명
품질관리서 번호	quality_doc_number	string	Y	자동 채번
현장명	site_name	string	Y
수주처	client_name	string	Y	회사명 드롭다운
접수일	received_date	date	Y
담당자	manager_name	string	Y
담당자 연락처	manager_phone	string	Y
상태	status	enum	Y	접수/진행중/완료
작성자	created_by	string	Y	자동(로그인 사용자)

2.2.2 건축공사장 정보 (실적 신고 시 필수)

필드	필드명(추정)	타입
현장명	construction_site_name	string
대지위치	land_location	string
지번	lot_number	string

2.2.3 자재유통업자 정보 (실적 신고 시 필수)

필드	필드명(추정)	타입
회사명	material_company_name	string
회사주소	material_company_address	string
대표자명	material_ceo_name	string
전화번호	material_phone	string

2.2.4 공사시공자 정보 (실적 신고 시 필수)

필드	필드명(추정)	타입
회사명	contractor_company_name	string
회사주소	contractor_company_address	string
성명	contractor_name	string
전화번호	contractor_phone	string

2.2.5 공사감리자 정보 (실적 신고 시 필수)

필드	필드명(추정)	타입
사무소명	supervisor_office_name	string
사무소주소	supervisor_office_address	string
성명	supervisor_name	string
전화번호	supervisor_phone	string

2.2.6 검사 정보 섹션

필드	필드명(추정)	타입	필수	설명
검사방문요청일	inspection_request_date	date	Y
검사시작일	inspection_start_date	date	Y	상태가 '검사시작'에 도달하면 진행중으로 변경
검사종료일	inspection_end_date	date	Y
검사자	inspector_name	string	Y	검사원 선택

2.2.7 현장 주소

필드	필드명(추정)	타입	설명
우편번호	postal_code	string	우편번호 찾기 버튼으로 검색
주소	address	string	자동 입력
상세주소	address_detail	string	수동 입력

2.2.8 수주 설정 정보

설명: 납품 규격과 시공 후 규격이 다를 경우 변경사유를 입력하세요. 사이즈가 동일하면 자동으로 동일로 표시합니다.

수주 선택 버튼 → 수주 선택 팝업 호출

수주 목록 테이블 (접힌 상태):

컬럼	타입	설명
수주번호	string
현장명	string
납품일	date
개소	integer	해당 수주의 개소 수
삭제	button	휴지통 아이콘

수주 목록 테이블 (펼친 상태 - 행 클릭 시 아코디언 확장):

컬럼	타입	설명
층수	string	예: 1층, 2층
부호	string	예: 부호명
발주 규격 - 가로	number	mm 단위
발주 규격 - 세로	number	mm 단위
시공후 규격 - 가로	number	변경 시 직접 입력
시공후 규격 - 세로	number	변경 시 직접 입력
변경사유	string	규격 변경 시 입력
검사하기	button	제품검사 팝업 호출

하단 집계:

항목	설명
총 개소	전체 개소 수 합계
동일	발주 규격 = 시공후 규격인 개소 수
변경	발주 규격 != 시공후 규격인 개소 수

2.2.9 하단 액션 버튼

버튼	동작	조건
검사제품요청서 보기	검사제품요청서 팝업 호출	-
제품검사성적서 보기	제품검사성적서 팝업 호출	-
검사 완료	상태를 '완료'로 변경	모든 개소 검사 완료 시 활성화
수정	정보 저장	-

2.3 수주 선택 팝업 (슬라이드 7)

호출 위치: 제품검사 상세 > 수주 선택 버튼

항목	설명
검색	키워드 검색
표시 데이터	검사등록되지 않은 수주만 표시
선택 방식	체크박스 다중 선택
표시 정보	총 N건, N건 선택

목록 컬럼:

컬럼	타입	설명
체크박스	boolean	다중 선택
수주번호	string
현장명	string
납품일	date
개소	integer

액션:

선택 → 팝업 닫힘, 제품검사 상세 화면에 선택된 수주 목록 반영
취소 → 팝업 닫힘

2.4 제품검사 팝업 (슬라이드 8)

호출 위치: 제품검사 상세 > 수주 펼침 > 검사하기 버튼

제품 유형에 따라 2가지 검사 폼이 존재:

2.4.1 Type A: 갈모양 검사 (좌측 팝업)

상단 필드:

필드	타입	설명
제품명	text (readonly)	자동 표시
규격	text (readonly)	자동 표시
제품 사진 2장	file_upload	클릭하여 파일을 찾거나, 마우스로 파일을 끌어오세요

검사 항목 (각각 적합/부적합 토글):

검사항목	필드명(추정)	입력 방식
갈모양 가공상태	galmotype_processing	적합/부적합 버튼
갈모양 재봉상태	galmotype_sewing	적합/부적합 버튼
갈모양 조립상태	galmotype_assembly	적합/부적합 버튼
갈모양 연기차단재	galmotype_smoke_barrier	적합/부적합 버튼
갈모양 하단마감재	galmotype_bottom_finish	적합/부적합 버튼
모터	motor	적합/부적합 버튼

2.4.2 Type B: 치수/성능 검사 (우측 팝업)

검사 항목:

검사항목	필드명(추정)	입력 방식	설명
재질	material	적합/부적합 버튼
길이	length	number + 적합/부적합	실측값 입력
높이	height	number + 적합/부적합	실측값 입력
가이드레일 홈간격	guide_rail_gap	number + 적합/부적합	실측값 입력
하단마감재 간격	bottom_finish_gap	number + 적합/부적합	실측값 입력
내화시험, 차연시험, 개폐시험, 내충격시험	fire_smoke_open_impact_test	적합/부적합 버튼	4가지 시험 통합
특이사항	remarks	textarea	자유 입력

입력 방식 규칙:

디폴트: 적합값 입력/선택 상태 (오렌지=적합, 검정=부적합)
특이사항 인포박스 존재

액션:

취소 → 팝업 닫힘
검사 완료 → 검사 결과 저장, 팝업 닫힘

2.5 검사제품요청서 (슬라이드 9-10)

호출 위치: 제품검사 상세 > 검사제품요청서 보기 버튼 성격: 인쇄/공유 가능한 공식 문서 (팝업) URL 제안: /quality/product-inspections/{id}/request-document

2.5.1 문서 헤더

항목	설명
인쇄 버튼	브라우저 인쇄
공유 버튼	공유 기능
닫기 버튼	팝업 닫기
결재란	작성 / 승인 / 승인 (3단계)
문서번호	예: ABC123
작성일자	예: 2025년 11월 11일

2.5.2 기본정보

필드	소스
수주처 / 회사명	제품검사 상세 > 기본정보
수주번호	수주 설정 정보
담당자 / 담당자연락처	제품검사 상세 > 기본정보
현장명 / 현장주소	제품검사 상세
납품일	수주 정보
총 개소	수주 설정 합계
접수일	제품검사 상세 > 기본정보
검사방문요청일(현재예정)	제품검사 상세 > 검사정보

2.5.3 입력사항

섹션	필드	소스
건축공사장	현장명, 대지위치, 지번	제품검사 상세 2.2.2
자재유통업자	성명, 회사명, 회사주소, 전화번호	제품검사 상세 2.2.3
공사시공자	성명, 회사명, 회사주소, 전화번호	제품검사 상세 2.2.4
공사감리자	성명, 사무소명, 사무소주소, 전화번호	제품검사 상세 2.2.5

2.5.4 검사 요청 시 참고사항 (빨간 글씨)

발주 사이즈와 시공 완료된 사이즈가 다를 시, 실정 변경을 부착하셔야 됩니다.
제품검사를 위한 방문 전까지
변경사유를 고지하셔야 인정마필을 부착할 수 있습니다.
(사전고지를 하지 않으므로 발생하는 문제의 귀책은 신청업체에 있습니다.)

2.5.5 검사대상 사전 고지 정보 테이블

컬럼	설명
No.	순번
층수	층수
부호	부호
오픈사이즈 - 발주 규격 (가로/세로)	발주 시 규격
오픈사이즈 - 시공후 규격 (가로/세로)	시공 후 실측 규격
변경사유	규격 변경 사유

2.6 제품검사성적서 (슬라이드 11-12)

호출 위치: 제품검사 상세 > 제품검사성적서 보기 버튼 성격: 인쇄/공유 가능한 공식 문서 (팝업), 페이지네이션 있음 URL 제안: /quality/product-inspections/{id}/result-document

2.6.1 문서 헤더

결재란: 작성 / 승인 / 승인 (3단계, 검사요청서와 동일 구조)

2.6.2 기본정보

필드	설명
제품명
제품코드
수주처
현장명
제품 LOT NO
로트크기
검사일자
검사자

2.6.3 제품 사진

좌우 2장의 이미지 표시 영역 (IMG 플레이스홀더)

2.6.4 검사 항목 테이블

No.	검사항목	세부	검사기준	검사결과	검사주기	특징값	판정
1	갈모양	가공상태	사용상 해로운 결함이 없을 것	검사결과	-	특징값	적합/부적합 체크
1	갈모양	재봉상태	내화실에 의해 견고하게 접합되어야 함
1	갈모양	조립상태	엔드바의 견고하게 조립되어야 함
1	갈모양	연기차단재	엔드가이드 갈모사이 MV(L), W80, 가이드레일 W50 (홈에 설치)	판정: 합수량 시
1	갈모양	하단마감재	내부 부재정렬 삽입 유무
2	모터	-	인장제품과 동일사양
3	재질	-	WY-SC780 인쇄상태 확인
4	치수(오픈사이즈)	길이	수주 치수 +/- 30mm	실측값 입력			적합/부적합
4	치수(오픈사이즈)	높이	수주 치수 +/- 30mm	실측값 입력
4	치수(오픈사이즈)	가이드레일 홈간격	10 +/- 5mm (측정부위: 상·중·하 높이 100 이내)	측정값 (상+중+하)
4	치수(오픈사이즈)	간격	가이드레일과 하단마감재 통싸 25mm 이내
5	작동테스트	개폐성능	6mm 균열게이지 관통 +/- 150mm 이동 유무
6	내화시험	비차열	25mm 균열게이지 관통 유무
7	차연시험	공기누설량	25Pa 일 때 공기누설량 0.9m3/min-m2 이하		기간: 1회/5년		시험 성적서
8	개폐시험	-	제품의 원활한 작동
8	개폐시험	평균속도	전도개폐 2.5~6.5m/min		시험 성적서
8	개폐시험	자중강하	자중강하 3~7m/min
8	개폐시험	-	개폐 시 상부 및 하부 끝부분에서 자동정지
8	개폐시험	-	강하 중 일의의 위치에서 자동정지

2.6.5 하단

필드	설명
특이사항	텍스트 영역
종합판정	합격/불합격

2.6.6 페이지네이션

개소(제품) 단위로 페이지 구분
이전/다음 버튼
페이지 번호 직접 입력 이동 (예: 1 / 50)
디폴트: 현재 페이지 (수정 가능)

2.7 실적신고 목록 (슬라이드 13-15)

경로: 품질관리 > 실적신고관리 URL 제안: /quality/performance-reports

2.7.1 탭 구조

탭	설명
분기별 실적신고	기본 탭
누락체크	누락 건 확인

2.7.2 분기별 실적신고 탭

필터:

필터	타입	옵션	기본값
연도	select	연도 목록	현재 연도
분기	button_group	전체/1분기/2분기/3분기/4분기	전체
검색	text	키워드	-

상태 카운트:

상태	설명
확정	실적신고 확정 건수
미확정	미확정 건수
신고완료	신고 완료 건수
미신고	미신고 건수

목록 테이블:

컬럼	필드명(추정)	타입	설명
체크박스	selected	boolean	다중 선택
품질관리서 번호	quality_doc_number	string
작성일	created_date	date
현장명	site_name	string
수주처	client_name	string
개소	location_count	integer
필수정보	required_info_status	string	"3건 누락", "4건 누락" 빨간색 표시
확정상태	confirmation_status	enum	확정/미확정
확정일	confirmed_date	date	확정 시 날짜
메모	memo	string

액션 버튼:

버튼	동작	설명
선택 확정	선택한 목록을 확정 상태로 변경	체크박스 선택 필요
확정 해제	선택한 목록을 미확정으로 변경	체크박스 선택 필요
메모	메모 팝업 호출	체크박스 선택 필요
확정건 엑셀다운로드	확정된 건만 엑셀 다운로드

필터 상태 셀렉트: 전체/확정/미확정 (디폴트: 전체)

2.7.3 메모 팝업 (슬라이드 14)

항목	설명
표시 정보	품질관리서 N건, 총 N 개소
메모	textarea 입력
작성 버튼	클릭 시 선택된 목록의 메모에 일괄 적용
취소 버튼	팝업 닫힘

2.7.4 누락체크 탭 (슬라이드 15)

설명 문구:

실적신고 누락 체크
납품 완료된 수주건 중 제품검사 미등록 건 확인합니다.

누락 발생 원인
- 품질관리서 발행일 기준 분기에 포함되어야 하나, 공사 미완료로 다음 분기로 이월 시 누락
- 수주등록 시 다른 현장명으로 등록되어 제품검사 매핑 시 누락
- 납품 후 제품검사 등록이 누락된 경우

목록 테이블:

컬럼	타입	설명
품질관리서 번호	string
현장명	string
수주처	string
개소	integer
제품검사완료일	date
메모	string

비즈니스 로직: 납품 완료(출고 완료)되었으나 제품검사가 미등록이거나 기간이 지났지만 확정이 안된 목록

2.8 품질인정심사 - 기준/매뉴얼 심사 (슬라이드 16)

경로: 품질관리 > 품질인정심사 URL 제안: /quality/certification-audit

2.8.1 탭 구조

탭	진행률	설명
기준/매뉴얼 심사	2/15	기준 문서 및 매뉴얼 확인
로트 추적 심사	7/12	제품 로트 추적 확인

전체 심사 진행률: 9/27 (기준/매뉴얼 + 로트추적 합계)

기준/매뉴얼: N/N
로트추적: N/N

2.8.2 필터

필터	타입	옵션
연도	select	연도 목록
분기	button_group	전체/1분기/2분기/3분기/4분기
검색	text	키워드

2.8.3 좌측: 점검표 항목

트리 구조:

> 1. 제목
    [v] 1. 항목 --- 완료
    [v] 2. 항목 --- 완료
    [ ] 3. 항목
> 2. 제목
    [ ] 1. 항목
    [ ] 2. 항목
    [ ] 3. 항목

각 항목에 완료 체크 표시
항목 클릭 시 우측에 상세 표시
진행률: 완료 항목 수 / 전체 항목 수

2.8.4 우측 상단: 기준 문서화

항목	설명
항목명	선택된 점검표 항목명
소거	해당 없음 시 소거 처리
관련 기준 문서	연결된 문서명 + 다운로드 아이콘

2.8.5 우측 하단: 문서명

항목	설명
문서명	파일명 표시
미리보기	문서 미리보기 (이미지/PDF)
페이지 정보	예: 파일명.pdf, 1 / 1 페이지

2.8.6 완료 체크 박스

디폴트: 열림 상태
클릭: 완료 설정/해제 토글

2.8.7 기준/매뉴얼 확인 버튼

클릭: 확인 완료 스티커로 변경 표시

2.9 품질인정심사 - 로트 추적 심사 (슬라이드 17)

경로: 품질관리 > 품질인정심사 > 로트 추적 심사 탭 URL 제안: /quality/certification-audit (같은 페이지, 탭 전환)

2.9.1 좌측: 품질관리서 목록

표시 조건: 해당 분기로 실적신고 확정된 품질관리서

항목	설명
품질관리서 번호	예: KD-SS-2024-
해당 분기	예: 2025년 3분기
현장명
인정등록	인정등록 정보
수주코드 건수	예: 수주코드 2건
개소수
진행률	예: 14% (완료/전체)

클릭 시 → 우측에 수주코드 목록 표시

2.9.2 중앙: 수주코드 목록

표시 조건: 해당 품질관리서에 연결된 수주코드 목록

항목	설명
수주코드 번호	예: KD-SS-240921-19
수주처
수주일
개소 수
현장
개소별 제품코드 확인	완료 수 / 전체 개소 수 (예: 0건 확인)

클릭 시 → 우측에 해당 수주코드의 개소별 제품코드 목록 표시

2.9.3 우측 상단: 개소별 제품코드 목록

컬럼	설명
수주코드
일련번호
확인 버튼	확인/완료 토글

2.9.4 우측 하단: 확인 서류 목록

서류 종류	설명
수입검사 성적서
수주서
수주서, 작업일지
중간검사 성적서
납품확인서, 출고증, 제품검사 성적서, 품질관리서

각 서류 클릭 시 → 해당 문서 영역 열림/닫힘 토글
문서 미리보기 기능 제공 (이미지/PDF)

2.9.5 확인 서류 구조 (계층)

품질관리서
└── 수주코드
    └── 개소별 제품코드
        └── 확인 서류
            ├── 수입검사 성적서
            ├── 수주서
            ├── 작업일지
            ├── 중간검사 성적서
            ├── 납품확인서
            ├── 출고증
            ├── 제품검사 성적서
            └── 품질관리서

3. 데이터 모델 관계

3.1 핵심 엔티티 관계도

[품질관리서 quality_documents]
├── 1:N → [품질관리서_수주 quality_document_orders] → N:1 [수주 orders]
│         └── 1:N → [수주_개소 order_locations]
│                    ├── 발주규격 (가로/세로)
│                    ├── 시공후규격 (가로/세로)
│                    ├── 변경사유
│                    └── 1:1 → [제품검사결과 inspection_results]
│                               ├── 검사항목별 적합/부적합
│                               ├── 실측값
│                               ├── 사진 2장
│                               └── 특이사항
├── 건축공사장 정보 (JSON options 또는 별도 섹션)
├── 자재유통업자 정보
├── 공사시공자 정보
├── 공사감리자 정보
├── 검사정보 (요청일, 시작일, 종료일, 검사자)
└── 현장주소

[실적신고 performance_reports]
├── quality_document_id → FK [품질관리서]
├── 분기 (year, quarter)
├── 확정상태
├── 확정일
└── 메모

[품질인정심사 certification_audits]
├── 기준/매뉴얼 심사 항목
│   ├── 점검표 항목 (트리 구조)
│   ├── 기준 문서 연결
│   └── 완료 상태
└── 로트 추적 심사
    ├── 품질관리서 → 수주코드 → 개소별 제품코드
    └── 확인 서류 목록

3.2 options JSON 활용 후보

SAM 프로젝트 컬럼 추가 정책(FK/조인키만 컬럼, 나머지 options JSON)에 따라:

엔티티	options에 저장할 필드
품질관리서	건축공사장 정보, 자재유통업자 정보, 공사시공자 정보, 공사감리자 정보, 현장주소
수주_개소 검사결과	검사항목별 결과(적합/부적합), 실측값, 특이사항
실적신고	메모
품질인정심사 항목	소거 여부, 기준문서 연결 정보

4. 비즈니스 규칙

4.1 상태 머신

제품검사 상태

접수 → 진행중 → 완료
         ↑         |
         └─────────┘ (재검사 시)

상태	트리거	조건
접수	제품검사 등록 시	초기 상태
진행중	검사시작일 도달 또는 첫 검사 진행 시	검사자, 검사시작일 입력 완료
완료	검사 완료 버튼 클릭	모든 개소의 검사가 완료되어야 함

실적신고 확정 상태

미확정 → 확정 → 신고완료
          ↑       |
          └───────┘ (해제 시)

상태	트리거	조건
미확정	제품검사 완료 시 자동 생성
확정	선택 확정 버튼	실적신고 필수정보(건축공사장/자재유통업자/공사시공자/공사감리자) 모두 입력
신고완료	외부 신고 처리 후

4.2 실적신고 필수정보 검증

실적신고를 확정하려면 제품검사 상세의 다음 정보가 모두 입력되어야 함:

건축공사장 정보 (현장명, 대지위치, 지번)
자재유통업자 정보 (회사명, 회사주소, 대표자명, 전화번호)
공사시공자 정보 (회사명, 회사주소, 성명, 전화번호)
공사감리자 정보 (사무소명, 사무소주소, 성명, 전화번호)

누락 표시: 목록에서 "3건 누락", "4건 누락" 등 빨간색으로 표시 → 실적신고 시점에서는 반드시 입력해야 함

4.3 규격 변경 로직

발주 규격(가로/세로)과 시공후 규격(가로/세로) 비교
동일하면 자동으로 "동일" 분류
다르면 "변경" 분류 + 변경사유 필수 입력
하단 집계: 총 개소, 동일, 변경 카운트 표시

4.4 검사 항목 판정 기준

No.	항목	합격 기준
1	갈모양 - 가공상태	사용상 해로운 결함 없을 것
1	갈모양 - 재봉상태	내화실에 의해 견고하게 접합
1	갈모양 - 조립상태	엔드바 견고하게 조립
1	갈모양 - 연기차단재	MV(L) W80, 가이드레일 W50 홈에 설치
1	갈모양 - 하단마감재	내부 부재정렬 삽입 유무
2	모터	인장제품과 동일사양
3	재질	WY-SC780 인쇄상태 확인
4	길이	수주 치수 +/- 30mm
4	높이	수주 치수 +/- 30mm
4	가이드레일 홈간격	10 +/- 5mm (상중하 높이 100 이내)
4	간격	가이드레일과 하단마감재 통싸 25mm 이내
5	개폐성능	6mm 균열게이지 관통 +/- 150mm 이동 유무
6	내화시험	25mm 균열게이지 관통 유무
7	차연시험	25Pa 시 공기누설량 0.9m3/min-m2 이하
8	개폐시험 - 평균속도	전도개폐 2.5~6.5m/min
8	개폐시험 - 자중강하	3~7m/min
8	개폐시험 - 자동정지	상부/하부 끝, 임의위치 자동정지

4.5 누락체크 로직

납품 완료(출고 완료)되었으나 제품검사가 미등록인 건을 자동 감지:

품질관리서 발행일 기준 분기 포함 여부
공사 미완료로 다음 분기 이월 시 누락
수주등록 시 다른 현장명으로 등록되어 매핑 누락
납품 후 제품검사 등록 자체 누락

4.6 품질인정심사 로직

기준/매뉴얼 심사

점검표 항목을 트리 구조로 관리
각 항목별 기준 문서 연결
항목별 완료 체크
전체 진행률 = 완료 항목 / 전체 항목

로트 추적 심사

해당 분기 실적신고 확정 건 기준
품질관리서 → 수주코드 → 개소별 제품코드 3단계 드릴다운
각 제품코드별 확인 서류 8종 검증
확인 서류: 수입검사 성적서, 수주서, 작업일지, 중간검사 성적서, 납품확인서, 출고증, 제품검사 성적서, 품질관리서

5. API 엔드포인트 설계 (후보)

5.1 제품검사관리

Method	Endpoint	설명
GET	`/api/quality/inspections`	제품검사 목록 (필터: status, date_range, search)
GET	`/api/quality/inspections/stats`	상태별 카운트 (접수/진행중/완료)
GET	`/api/quality/inspections/schedule`	캘린더 스케줄 (필터: year, month, status)
POST	`/api/quality/inspections`	제품검사 등록
GET	`/api/quality/inspections/{id}`	제품검사 상세
PUT	`/api/quality/inspections/{id}`	제품검사 수정
PUT	`/api/quality/inspections/{id}/complete`	검사 완료 처리
GET	`/api/quality/inspections/{id}/orders`	연결된 수주 목록
POST	`/api/quality/inspections/{id}/orders`	수주 연결 추가
DELETE	`/api/quality/inspections/{id}/orders/{orderId}`	수주 연결 삭제
GET	`/api/quality/inspections/available-orders`	검사 미등록 수주 목록 (수주선택 팝업용)
POST	`/api/quality/inspections/{id}/orders/{orderId}/locations/{locationId}/inspect`	개소별 검사 결과 저장
GET	`/api/quality/inspections/{id}/request-document`	검사제품요청서 데이터
GET	`/api/quality/inspections/{id}/result-document`	제품검사성적서 데이터 (페이지네이션)

5.2 실적신고관리

Method	Endpoint	설명
GET	`/api/quality/performance-reports`	실적신고 목록 (필터: year, quarter, status, search)
GET	`/api/quality/performance-reports/stats`	상태별 카운트
PUT	`/api/quality/performance-reports/confirm`	일괄 확정 (body: ids[])
PUT	`/api/quality/performance-reports/unconfirm`	일괄 확정 해제 (body: ids[])
PUT	`/api/quality/performance-reports/memo`	일괄 메모 작성 (body: ids[], memo)
GET	`/api/quality/performance-reports/missing`	누락체크 목록
GET	`/api/quality/performance-reports/export`	확정건 엑셀 다운로드

5.3 품질인정심사

Method	Endpoint	설명
GET	`/api/quality/certification-audit/summary`	심사 진행률 요약
GET	`/api/quality/certification-audit/standards`	기준/매뉴얼 심사 점검표
PUT	`/api/quality/certification-audit/standards/{itemId}`	항목 완료/해제 토글
GET	`/api/quality/certification-audit/standards/{itemId}/documents`	항목 기준 문서
GET	`/api/quality/certification-audit/lot-tracking`	로트추적 품질관리서 목록
GET	`/api/quality/certification-audit/lot-tracking/{docId}/orders`	수주코드 목록
GET	`/api/quality/certification-audit/lot-tracking/{docId}/orders/{orderId}/products`	개소별 제품코드
PUT	`/api/quality/certification-audit/lot-tracking/{docId}/orders/{orderId}/products/{productId}/verify`	제품코드 확인 처리
GET	`/api/quality/certification-audit/lot-tracking/{docId}/orders/{orderId}/products/{productId}/documents`	확인 서류 목록

6. 메뉴 구조

품질관리
├── 제품검사관리        ← 슬라이드 2~12
│   ├── 제품검사 목록    (목록 + 캘린더)
│   └── 제품검사 상세    (상세 + 검사팝업 + 요청서 + 성적서)
├── 실적신고관리        ← 슬라이드 13~15
│   ├── 분기별 실적신고  (목록 + 메모팝업)
│   └── 누락체크        (목록)
└── 품질인정심사        ← 슬라이드 16~17
    ├── 기준/매뉴얼 심사 (점검표 + 문서확인)
    └── 로트 추적 심사   (3단계 드릴다운 + 서류확인)

7. 슬라이드-화면 매핑 (빠른 참조)

슬라이드	화면	섹션
1	전체 프로세스 플로우	1장
2	제품검사 목록 (테이블)	2.1
3	제품검사 목록 (캘린더)	2.1.4
4	제품검사 상세 (기본정보 ~ 공사시공자)	2.2.1~2.2.4
5	제품검사 상세 (공사감리자 ~ 수주설정 ~ 하단버튼)	2.2.5~2.2.9
6	제품검사 상세 (수주 펼침 - 규격 비교)	2.2.8
7	수주 선택 팝업	2.3
8	제품검사 팝업 (갈모양/치수)	2.4
9	검사제품요청서 (상단)	2.5
10	검사제품요청서 (하단 테이블)	2.5
11	제품검사성적서 (상단 + 검사항목)	2.6
12	제품검사성적서 (검사항목 계속 + 종합판정)	2.6
13	실적신고 목록 (분기별)	2.7
14	실적신고 메모 팝업	2.7.3
15	실적신고 누락체크	2.7.4
16	품질인정심사 (기준/매뉴얼)	2.8
17	품질인정심사 (로트추적)	2.9

33 KiB Raw Blame History