Files

권혁성 bfcd6178ea docs: [quality] 품질관리 시스템 기능 문서 작성

- README.md: 전체 개요, 역할별 프로세스 플로우, 메뉴 구조, 데이터 구조, API, 스토리보드 참조
- inspection-management.md: 제품검사 관리 (15개 검사항목, 상태판정, 캘린더뷰, 요청서/성적서 양식)
- performance-reports.md: 생산실적신고 (자동생성, 확정, 누락체크, 건기원 프로세스)
- quality-certification-audit.md: 품질인정심사 (기준/매뉴얼 심사 + 로트 추적 심사)
- INDEX.md에 품질관리 문서 등록

2026-03-09 22:36:15 +09:00

13 KiB

Raw Blame History

제품검사 관리 (Inspection Management)

작성일: 2026-03-09 상태: 운영 중 URL: /quality/inspections

1. 개요

1.1 목적

방화문 제품의 현장 출고 전 품질검사를 수행하고 검사성적서를 발행한다. 검사 완료 시 실적신고(PerformanceReport)를 자동 생성한다.

1.2 품질관리서 구조

품질관리서 (QualityDocument)
├── 기본정보: 채번, 현장명, 접수일, 검사자, 수주처
├── 관련자 정보 (options JSON):
│   ├── 건축공사장 정보
│   ├── 자재유통업자 정보
│   ├── 공사시공자 정보
│   └── 공사감리자 정보
├── 수주 연결 (QualityDocumentOrder, 1:N)
│   └── 개소 (QualityDocumentLocation, 1:N)
│       ├── 시공규격 (post_width, post_height)
│       ├── 검사 데이터 (inspection_data JSON)
│       └── 검사성적서 (Document EAV)
└── 실적신고 (PerformanceReport, 1:1)

1.3 화면 구성

목록 페이지 (슬라이드 5~6):

상단: 날짜 필터 (전체/전전월/전월/금월/어제/오늘) + 검색
통계 카드: 접수, 진행중, 완료 건수
테이블: 품질관리서번호, 번호, 수주처, 개소, 실적신고 필수정보, 검사시기, 검사자, 상태, 작성자, 접수일
하단: 캘린더 스케줄 (월간 뷰)

캘린더 뷰:

월 단위 표시, 상태 필터(전체/진행중/완료)
색상 구분: 완료(초록 배지), 진행중(파란 바)
검사 완료 건: 홍길동 - 현장명 / 완료 형태
검사 진행 건: 홍길동 - 현장명 / 진행중 형태 (날짜 범위 바)
클릭 시 해당 제품검사 상세 화면으로 이동

상세 페이지 (슬라이드 7~9):

기본 정보: 품질관리서번호, 현장명, 수주처, 접수일, 담당자, 연락처, 상태, 작성자
관련자 정보 4개 섹션 (실적 신고 시 필수 정보)
검사 정보: 검사방문요청일, 검사시작일, 검사종료일, 검사자
현장 주소: 우편번호 찾기 + 상세주소
수주 설정 정보: 수주 선택 버튼 → 수주별 개소 목록 (층수/부호/수주규격/시공규격/변경사유)
하단 버튼: 검사제품요청서 보기, 제품검사성적서 보기, 검사 완료, 수정

2. 상태 관리

2.1 품질관리서 상태

상태	코드	조건
접수	`received`	생성 직후, 수주 미연결
진행중	`in_progress`	수주 연결됨 또는 일부 검사 진행
완료	`completed`	모든 개소 검사 완료 후 `complete()` 호출

2.2 개소별 검사 상태 (자동 판정)

상태	코드	판정 기준
대기	`pending`	검사 데이터 없음 (15개 항목 0개 + 사진 없음)
진행중	`in_progress`	일부 항목 입력 또는 사진 미등록
완료	`completed`	15개 항목 전부 입력 + 사진 1장 이상

2.3 상태 자동 재계산

개소별 검사 저장 시 → 개소 상태 자동 판정 → 품질관리서 상태 재계산:

전부 pending → received
하나라도 completed 또는 in_progress → in_progress
전부 completed → in_progress (수동 complete() 필요)

3. 검사 항목

3.1 15개 검사 항목

#	키	분류	설명	판정값
1	`appearanceProcessing`	외관	가공 상태	pass/fail
2	`appearanceSewing`	외관	봉제 상태	pass/fail
3	`appearanceAssembly`	외관	조립 상태	pass/fail
4	`appearanceSmokeBarrier`	외관	차연재 상태	pass/fail
5	`appearanceBottomFinish`	외관	하부마감 상태	pass/fail
6	`motor`	기능	모터 작동	pass/fail
7	`material`	기능	소재 적합성	pass/fail
8	`lengthJudgment`	치수	가로 치수	OK/NG
9	`heightJudgment`	치수	세로 치수	OK/NG
10	`guideRailGap`	치수	가이드레일 간격	OK/NG
11	`bottomFinishGap`	치수	하부마감 간격	OK/NG
12	`fireResistanceTest`	시험	내화 시험	pass/fail
13	`smokeLeakageTest`	시험	차연 시험	pass/fail
14	`openCloseTest`	시험	개폐 시험	pass/fail
15	`impactTest`	시험	충격 시험	pass/fail

3.2 추가 데이터

키	설명	필수
`productImages`	제품 사진 URL 배열	완료 판정에 필수

4. 수주 연결

4.1 수주 선택

availableOrders(): 해당 수주처(client_id)의 미등록 수주 조회
모달에서 복수 수주 선택 가능

4.2 개소 자동생성

수주 연결 시 각 수주의 root node(층/부호)마다 개소(Location) 자동생성:

수주 A (3개 root node)
├── 1F A호 → Location 1
├── 2F B호 → Location 2
└── 3F C호 → Location 3

수주 B (2개 root node)
├── 지하1F → Location 4
└── 1F → Location 5

4.3 개소 데이터

필드	설명	출처
`order_item_id`	대표 OrderItem	root node의 첫 번째 품목
`post_width`	시공 가로	발주 규격에서 복사 (수정 가능)
`post_height`	시공 세로	발주 규격에서 복사 (수정 가능)
`change_reason`	변경 사유	규격 변경 시 입력

5. 문서 자동생성 (EAV)

5.1 제품검사요청서 (슬라이드 12~13)

Template ID: 66 (제품검사 요청서)
트리거: 품질관리서 생성/수정 시 syncRequestDocument() 호출
인쇄용 페이지 형태로 구분되어 표시 (인쇄, 공유, 닫기 버튼)

문서 구성:

┌─────────────────────────────────────────┐
│  제품검사요청서                            │
│  문서번호: ABC123 | 작성일자: 2025.11.11  │
│                                          │
│  승인라인: 작성 → 승인 → 승인 → 승인      │
│           홍길동   이름   이름   이름       │
│                                          │
│  ── 기본정보 ──                           │
│  수주처, 수주번호, 담당자, 연락처           │
│  현장명, 납품일, 총 개소, 접수일            │
│                                          │
│  ── 입력사항 (실적신고 필수 정보) ──        │
│  건축공사장: 현장명, 대지위치, 지번          │
│  자재유통업자: 회사명, 회사주소, 대표자명,   │
│               전화번호                     │
│  공사시공자: 회사명, 회사주소, 성명, 전화번호 │
│  공사감리자: 사무소명, 사무소주소, 성명,     │
│             전화번호                       │
│                                          │
│  ── 검사대상 사전 고지 정보 ──             │
│  No. 층수 부호 발주규격(가로/세로)          │
│              시공후규격(가로/세로) 변경사유   │
└─────────────────────────────────────────┘

주의 문구 (빨간색):

발주 사이즈와 시공 완료된 사이즈가 다를 시 실질 범위를 넣어야 한다
변경사유를 고지하여야 인정마을을 부착할 수 있다
사전고지를 하지 않음으로 발생하는 문제의 귀책은 신청업체에 있다

5.2 제품검사성적서 (슬라이드 14~15)

각 개소별 document_id로 EAV Document 참조
검사 결과(inspection_data)를 EAV 필드로 저장
개소별 페이지 단위: 1/50 형태의 페이지 네비게이션 (이전/이동/다음 버튼)