문서관리
개요
이 화면은 무엇인가요? 문서관리마스터를 체계적으로 등록하고 관리하는 목록 화면입니다. 이 기록은 ISO 9001 7.5(문서화된 정보) 요구사항을 충족합니다.
누가 사용하나요?
- 📝 문서 관리자: 문서를 등록하고 이력을 관리합니다
- 👨💼 QA 매니저: 문서를 검토·승인합니다
언제 사용하나요?
- 신규 문서 작성 시
- 문서 개정·폐기 시
- 인증 심사 대비 문서 현행화 시
주요 기능
1. 문서관리마스터 등록 및 관리
무엇을 하나요?: 문서관리마스터 정보를 등록하고 상태를 관리합니다.
어떻게 사용하나요?:
- 화면에서 새로 만들기 버튼을 선택합니다
- 필수 항목을 입력합니다
- 관련 정보를 추가 입력합니다
- 저장 버튼을 클릭합니다
💡 팁: 필수 항목(✅ 표시)을 모두 입력해야 저장이 가능합니다.
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 문서코드 | document_code | VARCHAR | ✅ | - |
| 문서제목 | document_title | VARCHAR | ✅ | - |
| 문서유형 | document_type | 절차서 / 지침서 / 규정 / 기준서 / 양식 / 외부문서 / 매뉴얼 | ✅ | - |
| 문서등급 | document_level | Level1_매뉴얼 / Level2_절차서 / Level3_지침서 / Level4_양식기록 | - | |
| 현재버전 | current_version | VARCHAR | - | |
| 개정번호 | revision_number | INT | - | |
| 시행일 | effective_date | DATE | - | |
| 만료일 | expiry_date | DATE | - | |
| 보존연한 | retention_years | INT | - | |
| 작성자ID | author_id | UUID | 시스템 users 테이블 참조 | |
| 검토자ID | reviewer_id | UUID | 시스템 users 테이블 참조 | |
| 승인자ID | approver_id | UUID | 시스템 users 테이블 참조 | |
| 부서ID | department_id | UUID | 시스템 departments 테이블 참조 | |
| 배포목록 | distribution_list | TEXT | JSON 배열: 배포 대상 목록 | |
| ISO조항참조 | iso_clause_ref | VARCHAR | - | |
| 상태 | status | 초안 / 검토중 / 승인 / 배포 / 폐기 / 임시보류 | ✅ | - |
| 문서파일 | document_file | TEXT | - | |
| 대체문서ID | supersedes_id | UUID | qms_document_master 테이블 참조 (document_code 표시) | |
| 개정횟수 | revision_count | INT | 집계: qms_document_revisions.id COUNT |
자주 묻는 질문 (FAQ)
Q. 이 화면의 데이터는 어떤 인증 심사에서 활용되나요?
ISO 9001, IATF 16949, AS9100, ISO 13485 등 인증 심사 시 이 화면의 데이터가 증적 자료로 활용됩니다. 감사 추적 기능으로 변경 이력이 자동 기록됩니다.
Q. 데이터를 수정하면 이력이 남나요?
네, 이 화면은 감사 추적(Audit Trail) 기능이 활성화되어 있어 모든 변경 이력이 자동으로 기록됩니다. 수정 전/후 값, 수정자, 수정일시가 기록되어 규정 준수를 위한 증적으로 활용됩니다.
실무 시나리오
시나리오: 문서관리 신규 등록
문서관리 업무를 수행하기 위해 새 데이터를 등록합니다.
- 문서관리 화면에서 새로 만들기를 선택합니다
- 필수 항목을 입력합니다
- 관련 참조 데이터를 선택합니다
- 입력 내용을 확인하고 저장합니다
- 필요 시 상태를 변경하고 후속 프로세스를 진행합니다
📋 기술 참고 정보 (개발자/관리자용)
테이블 정보
qms_document_master 테이블은 이 화면의 데이터를 저장합니다.
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 부서 연결 (department_id 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 상세
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 문서코드 | document_code | VARCHAR | ✅ | - |
| 문서제목 | document_title | VARCHAR | ✅ | - |
| 문서유형 | document_type | 절차서 / 지침서 / 규정 / 기준서 / 양식 / 외부문서 / 매뉴얼 | ✅ | - |
| 문서등급 | document_level | Level1_매뉴얼 / Level2_절차서 / Level3_지침서 / Level4_양식기록 | - | |
| 현재버전 | current_version | VARCHAR | - | |
| 개정번호 | revision_number | INT | - | |
| 시행일 | effective_date | DATE | - | |
| 만료일 | expiry_date | DATE | - | |
| 보존연한 | retention_years | INT | - | |
| 작성자ID | author_id | UUID | 시스템 users 테이블 참조 | |
| 검토자ID | reviewer_id | UUID | 시스템 users 테이블 참조 | |
| 승인자ID | approver_id | UUID | 시스템 users 테이블 참조 | |
| 부서ID | department_id | UUID | 시스템 departments 테이블 참조 | |
| 배포목록 | distribution_list | TEXT | JSON 배열: 배포 대상 목록 | |
| ISO조항참조 | iso_clause_ref | VARCHAR | - | |
| 상태 | status | 초안 / 검토중 / 승인 / 배포 / 폐기 / 임시보류 | ✅ | - |
| 문서파일 | document_file | TEXT | - | |
| 대체문서ID | supersedes_id | UUID | qms_document_master 테이블 참조 (document_code 표시) | |
| 개정횟수 | revision_count | INT | 집계: qms_document_revisions.id COUNT |
데이터 관계
참조하는 테이블
- 문서개정이력 (1:N) 문서마스터→개정이력
- 문서관리마스터 (1:N) 문서마스터→대체문서(자기참조)
참조받는 테이블
- 문서관리마스터 (1:N) 문서마스터→대체문서(자기참조)
- 직원 (1:N) 직원→문서마스터(작성자)
- 직원 (1:N) 직원→문서마스터(검토자)
- 직원 (1:N) 직원→문서마스터(승인자)
- 부서 (1:N) 부서→문서마스터(부서)
- 전자서명정책 (1:N) 전자서명정책→문서마스터(적용정책)
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 문서코드 | link | - | ✅ |
| 문서제목 | 기본 | - | ✅ |
| 문서유형 | tag | - | ✅ |
| 문서등급 | tag | - | ✅ |
| 현재버전 | 기본 | - | ✅ |
| 개정번호 | 기본 | - | ✅ |
| 상태 | badge | - | ✅ |
| 시행일 | 기본 | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 문서유형 | select |
| 문서등급 | select |
| 상태 | select |