DOC-SUB-FLOW-001 — 문서 제출·결재 흐름
상위 허브: [[DOC-000-Document-Domain-Hub]] 용어 기준: [[DOC-CON-001-terms-definition]]
문서 역할
DOC-SUB-FLOW-001은 Document 도메인 · Submit(제출) 하위 영역에서, 조직이 제출 유형을 준비하고 직원이 Hereby Works에서 서류를 제출하며 관리자가 결재하기까지의 업무 순서를 정의하는 Flow 문서이다.
본 문서는 「서류 제출」 플로우만 다룬다. 문서(증명서) 발급 신청, 서류 요청, 자격증/면허는 각각 별도 Flow에서 관리한다.
이 문서는 흐름과 단계 연결만 다룬다. 파일 필수 여부, 유형별 상세 규칙, 상태 전환 조건, 화면 UI는 각 Policy·State·Screen 문서를 따른다.
더 쉽게 말하면
"제출 유형 설정 → 직원 서류 제출 → 관리자 승인/반려" 가 어떤 순서로 이어지는지 정리한 흐름도이다.
- 기획: Policy·Screen 작성 전 전체 단계를 한눈에 본다.
- QA: 정상·분기 시나리오의 단계 순서를 검증한다.
- 개발: API·알림·상태 연동 구현 전 선후 관계를 맞춘다.
반드시 포함해야 하는 내용 (체크리스트)
| 항목 | 본 문서 섹션 |
|---|---|
| 전체 프로세스 요약 | §0 |
| 제출 유형 등록/관리 흐름 | §1 |
| 서류 제출·결재 흐름 | §2 |
| 관리자 결재 흐름 | §3 |
| 예외·분기 | §4 |
| 상태 변화 요약 | §5 |
| 관련 문서 | §연결 문서 |
이 문서에서 다루지 않는 것
| 항목 | 담당 |
|---|---|
| 용어 정의(구분·유형·신청일·상태) | [[DOC-CON-001-terms-definition]] |
| 제출 유형·양식 상세 | [[DOC-SUB-POL-002-type-setting]] |
| Works 제출 조건(파일·제목 필수 등) | [[DOC-SUB-POL-003-works-submit]] |
| 상태 전환·재제출 규칙 | DOC-STATE-001-Document-State-Definition (미작성) |
| 화면 UI·버튼 | Screen 문서 (미작성) |
| DB·API 구조 | docs/reference/, 구현 코드 |
| QA 상세 케이스 | QA 문서 (미작성) |
| 문서(증명서) 발급 신청 | 별도 Flow (미작성) |
| 서류 요청 (Works 요청 탭) | 별도 Flow (미작성) |
| 자격증/면허 | docs/policy/01_Domains/document/03-License (미작성) |
적용 범위
- Hereby Works 서류 제출 탭을 통한 Document 업로드 → 문서 결재에서의 승인·반려까지.
- 제외: 증명서 발급, 서류 요청, 자격증/면허, 전자서명(e-sign), 계약서 전용 업무 ([[DOC-CON-001-terms-definition#제외-범위]]).
작성 기준
각 단계 표는 아래 열을 사용한다.
| 열 | 설명 |
|---|---|
| 단계 | 순서 번호·이름 |
| 수행 주체 | 직원, 관리자, 시스템 |
| 입력 | 해당 단계에 필요한 정보 |
| 처리 | 수행 작업 요약 |
| 산출 | 생성·변경되는 데이터·상태 |
| 관련 정책 | Policy 링크 |
| 관련 화면 | Screen / 앱 (미작성 시 앱명만) |
0. 서류 제출 프로세스
Document Submit 영역 중 서류 제출은 설정 → 제출 → 결재 세 축으로 본다.
| 축 | 요약 |
|---|---|
| 설정 | 조직이 제출 유형을 준비 (§1) |
| 제출 | 직원이 Works 서류 제출 탭에서 파일·유형을 올림 (§2) |
| 결재 | 관리자가 문서 결재에서 검토 후 승인·반려 (§3) |
초안 메모 「직원: 문서 제출 → 관리자 승인 / 반려」 는 제출 → 결재 축에 해당한다.
1. 제출 유형 등록/관리 흐름
조직이 직원에게 제공할 제출 유형을 준비하는 선행 흐름이다. 직원 제출 전에 반영되어 있어야 한다.
자세한 정의·커스텀 규칙은 [[DOC-SUB-POL-002-type-setting]]을 따른다.
| 단계 | 수행 주체 | 입력 | 처리 | 산출 | 관련 정책 | 관련 화면 |
|---|---|---|---|---|---|---|
| 1-1 | 관리자 | 조직별 제출 유형 목록 | 기본 제공: 건강검진결과, 기타 등. 자격증/면허는 본 Flow 범위 밖 ([[DOC-SUB-POL-002-type-setting]]) | Works 서류 제출 모달 유형 선택지 | [[DOC-SUB-POL-002-type-setting]] | 미정 (전용 설정 페이지) |
| 1-2 | 시스템 | 설정된 유형 | Works·API에 유형 목록 노출 | — | [[DOC-SUB-POL-002-type-setting]] | — |
1.1 설정 완료 후
설정이 반영되면 직원은 [[DOC-SUB-POL-003-works-submit]]에 정의된 조건으로 §2을 시작한다.
미정 (커스텀 설정): 제출 유형 커스텀은 문서 관리 접근 권한이 있는 사용자가 수행한다. 전용 신규 페이지가 필요하며, 해당 화면에 대한 read·write 권한은 별도 개발이 필요할 것으로 예상된다. (§미정 사항)
2. 서류 제출·결재 흐름
Works 서류 제출 탭에서 파일을 첨부해 제출하는 흐름이다.
용어·구분: [[DOC-CON-001-terms-definition]] (구분=제출).
| 단계 | 수행 주체 | 입력 | 처리 | 산출 | 관련 정책 | 관련 화면 |
|---|---|---|---|---|---|---|
| 2-1 | 직원 | 유형, 파일(필수), 메모(선택) | Works 서류 제출 탭에서 제출하기 | — | [[DOC-SUB-POL-003-works-submit]] | Works 결재 > 서류관리, 제출 모달 |
| 2-2 | 시스템 | 업로드 파일 메타 | 저장·Document 생성 | 구분=제출, 신청일, 상태=대기 | [[DOC-CON-001-terms-definition]] | — |
| 2-3 | 시스템 | 새 Document | 결재 권한자에게 알림 | notification | — | — |
| 2-4 | 관리자 | 대기 건 목록 | 문서 결재에서 보기·미리보기 | — | — | team-manager document-management / admin embed |
| 2-5a | 관리자 | 승인 | 승인 처리 | 상태=승인 | DOC-STATE-001 (미작성) | 결재 미리보기 모달 |
| 2-5b | 관리자 | 반려, 사유 | 반려 처리 | 상태=반려 | DOC-STATE-001 (미작성) | 동일 |
초안 정리: 직원: 문서 제출 → Y: 관리자 승인 / N: 관리자 반려 → 단계 2-1 ~ 2-5.
3. 관리자 결재 흐름
문서 결재 화면에서 직원이 제출한 Document만 본 Flow의 결재 대상이다.
문서 요청, 증명서 발급, 자격증/면허 결재는 다른 페이지·Flow에서 다룬다.
| 단계 | 수행 주체 | 입력 | 처리 | 산출 | 관련 정책 | 관련 화면 |
|---|---|---|---|---|---|---|
| 3-1 | 관리자 | 필터(상태·팀·신청일·검색 등) | 제출 건 목록 조회 | — | — | team-manager document-management, admin embed |
| 3-2 | 관리자 | 행 선택 보기 | 첨부 파일 미리보기(iframe 등) | — | — | doc-preview 모달 |
| 3-3 | 관리자 | 대기 건만 | 모달에서 승인 또는 반려(사유) | 상태 변경 | DOC-STATE-001 (미작성) | 동일 |
| 3-4 | 시스템 | 상태 변경 | (선택) 직원·결재자 알림 | notification | — | — |
4. 예외·분기 흐름
| 상황 | 흐름 요약 | 상세 |
|---|---|---|
| 취소 | Document cancelled | 취소 주체·재신청 — DOC-STATE-001 (미작성) |
| 반려 후 | 상태=반려 | 새 건으로 재제출 (§미정 사항) |
| 승인 후 수정 | 일반적으로 불가 | Policy·State 문서 확정 후 반영 |
| 결재 범위 밖 | 관리 범위 밖 직원 | 권한·스코프 — [[AUTH-000-Authorization-Domain-Hub]] |
5. 상태 변화 요약
Flow 관점 상태 변화. 표기·enum 매핑은 [[DOC-CON-001-terms-definition#5-상태]].
[직원 서류 제출 완료] → 대기
[관리자 승인] → 승인
[관리자 반려] → 반려
[취소 처리] → 취소종료 상태: 승인, 반려, 취소.
연결 문서
| 구분 | 문서 |
|---|---|
| 용어 | [[DOC-CON-001-terms-definition]] |
| 유형·양식 | [[DOC-SUB-POL-002-type-setting]] |
| Works 제출 | [[DOC-SUB-POL-003-works-submit]] |
| 제출 용어 | [[DOC-SUB-POL-001-terms]] |
| 상태(예정) | DOC-STATE-001-Document-State-Definition |
| 작성 가이드 | [[DOC-GUIDE-Domain-Document-Structure]] |
| 자격증/면허(예정) | 03-License |
미정 사항
| 항목 | 현재 |
|---|---|
| 제출 유형 커스텀 | 문서 관리 접근 권한 보유자가 설정. 전용 신규 페이지 필요. 화면 read·write 권한은 개발 필요 (§1) |
| 반려 후 재제출 | 기존 건 수정이 아니라 새 Document를 생성해 다시 제출 |
DOC-SUB-POL-001-terms, DOC-SUB-POL-002, DOC-SUB-POL-003 본문 | 초안만 존재 — Policy 확정 시 Flow 단계 링크 갱신 |
변경 시 영향받는 문서
- [[DOC-CON-001-terms-definition]]
- [[DOC-SUB-POL-001-terms]]
- [[DOC-SUB-POL-002-type-setting]]
- [[DOC-SUB-POL-003-works-submit]]
DOC-STATE-001-Document-State-Definition(작성 시)- Document Screen 문서 (작성 시)