HBAD272_공제 산정 모드
(Hereby) 관리자 패널 > 설정 > 공제 관리 > 공제 산정 모드
| 앱 | 관리자 패널 (HBAD) |
| 대상 사용자 | 조건1 [설정 수정] 권한 |
| 프로토타입 | /workspace/group/deduction-screens/mockup-tax-report-mode.html 장면 ③ 「공제 산정 모드 설정」 통합 화면 (§A+§B 한 페이지) · 장면 ② 세무 운영 모드 · 장면 ① [[HBHR283]] 리포트 / mockup-deduction-v2.2.html 장면 ⑥ (산정 모드 카드 원안) |
| 관련 정책 | [[POL_공제_판정]] · [[POL_공제_계산·확정]] · [[POL_공제_잠정·정산]] · [[POL_공제_경계]] · [[POL_법정공제]] (컨플 19333121) 참조만 |
| Status | draft (콸 리뷰 게이트 대기) |
| Owner | 카나 |
| 부모 | [[HBAD270_설정 (조직 설정·내 정보)]] |
| 하위 또는 관련 | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] · [[HBHR283_월 마감 공제 요약 리포트]] · [[HBAD271_법정 요율 안내]] |
개요
- 📋 제안 — 골격 Phase 1 미구현 기획 화면이다 (IA 19529769, 기획서 화면 ④ · FIG §7 결정 1). 아래 UI 문구·카드·라디오는 모두 목업 기준 기획 문구이며 라이브 확정 원문이 아니다. develop 실측(2026-09-21): 산정 모드·세무 운영 모드 화면·라우터·RBAC 토큰 전부 미구현 — 저장 원천(
statutory.*파라미터 스토어·조직 설정)은 (추정) 표기다. - 이 화면은 두 개의 조직 단위 설정을 한 페이지에 묶는다. §A 공제 산정 모드 = "무엇으로 계산하는가"(당월 계산 vs 공단 고지 기반 — FIG §7 결정 1·2, flex 정률/고지 이원화 §2-3). §B 세무 운영 모드 = "누가 어떻게 확정·검토하는가"(트랙 Z 담당자 셀프 확정 / 트랙 T 세무사 검토 — 정본 컨플 28082177, C안 확정 콸 2026-09-21).
- 두 축은 직교한다. 어느 산정 모드를 골라도 두 트랙 중 하나를 고른다(4종 조합). 어느 모드·트랙이든 Layer 4 대사(공단 고지액 대조)가 뒤를 잇는다(FIG §7 결정 1, 5-Layer 누락 방어).
- 모드별 법적 책임 경계(자체 계산 vs 고지 vs 외부 import)는 법률 검토 대기다(FIG §7 결정 4). 본 사양서는 판정·책임 규칙을 정의하지 않는다 — [[POL_공제_판정]] · [[POL_법정공제]] 참조. 전환 시 효력 = 다음 귀속월부터 (실제 적용 시점·소급 규칙 미결).
- 표기 신뢰도 3단 분류 —
✓ 확인= develop 코드·컨플 정본으로 실측한 사실 /? 추정= 관례·유사 화면 기반 추정(본문 "(추정)") /TBU= 미정·미구현. 이 화면은 UI 전체가 미구현이라 UI 문구 = 목업 기준 기획 문구, 저장 원천·procedure·RBAC 토큰 =? 추정/TBU, 확정 사실은 C안(콸 2026-09-21)·FIG 결정·PoC 실측뿐이다.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-08-24 | 카나 | PM | 최초 작성 (IA 19529769 기준 · 📋 제안 골격 Phase 1 미구현 기획 · 산정 모드 4종 카드) |
| 2026-09-21 | 카나 | PM | v3 개정: 세무 운영 모드(트랙 Z 셀프 확정 / 트랙 T 세무사 검토) 절 추가 · 트랙 T 기본=리포트 검토(C안 초기) · [[HBHR283]] 연계 |
| 2026-09-21 | 카나 | PM | 정식 사양서 승격: func-spec 형식 전환 — §A(당월 계산/고지 기반)·§B(세무 운영 모드) 통합 · 변경 확인 다이얼로그(HBAD272-1) 별도 표 · 모드 조합 4종 케이스표 · Empty/에러/권한 행 보강 · 화면 플로우 mermaid 정비 · 통합 화면 목업(장면 ③) 참조. 콸 리뷰 게이트 대기 — PR 금지 |
Data I/O
조직 단위 두 설정(§A 산정 모드 · §B 세무 운영 모드)을 저장하는 화면이다. 미구현 기획이라 procedure·파라미터 키는 모두 (추정)/TBU이며 지어내지 않는다. 저장 원천은 조직 설정 파라미터 스토어(statutory.* 계열, 키명 TBU)로 추정한다([[HBAD270_설정 (조직 설정·내 정보)]] 참조).
Server → Client
| 변수 | DB 엔티티.컬럼 (추정) | 값 없을 때 | 비고 |
|---|---|---|---|
${calcMode.selected} | organization_parameters / statutory.calcMode (키명 TBU) | 미선택 시 기본 모드(당월 계산, 추정) 또는 선택 유도 (01) | §A · 조직 단위 단일 선택 (FIG §7 결정 1) |
${calcMode.perItem} | 항목별 차등 설정 (원천 TBU) | 단일 모드 적용 (차등 미지원 추정) | §A · 항목별 차등 가능 여부 = FIG 설계 대기 |
${calcMode.options} | 산정 모드 정의 (당월 계산/고지 기반 · 하위 수동·import) | - | flex 정률 vs 고지 이원화 (FIG §2-3) |
${taxOps.mode} | statutory.taxOpsMode (키명 TBU) | 미설정 시 기본 트랙(Z 또는 선택 유도, 추정) (100) | §B · 트랙 Z/T |
${taxOps.reviewMethod} | statutory.taxOpsReviewMethod (키명 TBU) | 트랙 T 기본 = "리포트 검토(C안 초기)" | §B · 트랙 T 하위 옵션 |
${mode.responsibility} | 모드별 책임 안내 문구 (원천 TBU) | 법률 검토 대기 시 안내 placeholder | 책임 경계 = 법률 검토 대기 (FIG §7 결정 4) |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| §A 산정 모드 선택 저장 | 선택 모드(당월 계산/고지 기반 · 하위 수동/import) | sdk.settings.update() (추정) TBU | settings:write (추정) |
| §B 세무 운영 모드 저장 | 선택 트랙(Z/T) + 트랙 T 하위 옵션(reviewMethod) | sdk.settings.update() (추정) TBU | settings:write (추정) |
tRPC 표기는 웹 클라이언트가 직접 호출하는 인터페이스(설정 저장)로 분류한다. 실 procedure·파라미터 키는 미구현이라 TBU — 지어내지 않는다.
외부 통합 (모드별)
| 외부 시스템 | 데이터 | 동기/비동기 | 비고 |
|---|---|---|---|
| 공단 EDI / 파일 | 공단 고지액 (고지 기반 모드의 진실 원천 · Layer 4 대사) | 비동기 | EDI/파일 업로드 = 진실 원천 (FIG §7 결정 1). 고지값 입력 경로(수동/공단 연동) TBU |
| 이카운트 | 외부 계산 xlsx import → 커밋 (import 하위 모드) | 비동기 | 왕복 = 외부 계산 import · 파서 완성 전제 (FIG §7 결정 2) |
| 세무사 (트랙 T · C안 초기) | 월 마감 요약 리포트 export(PDF/xlsx) → 회신 | 비동기 (시스템 밖 루프) | [[HBHR283]] export 리뷰 루프 (B형). 계정 방식(A)은 추후 |
화면 플로우 (Mermaid)
한 페이지에서 §A 산정 모드와 §B 세무 운영 모드를 각각 조직 단위 단일 선택한다. 변경 시 확인 다이얼로그가 "다음 귀속월부터 적용" 효력 시점을 안내한 뒤 저장한다. 어느 조합을 골라도 공단 고지액 대사(Layer 4)로 이어진다(FIG §7 결정 1). 모드별 책임 경계는 법률 검토 대기(§7 결정 4).
§A 공제 산정 모드 사양표
산정 모드는 "무엇으로 공제를 산출하는가"를 정하는 조직 단위 설정이다. 축 = 당월 계산(정률·수식, 예측치) vs 공단 고지 기반(고지액 반영) 이원화(FIG §2-3·§7 결정 1). 그 외 수동 입력 / 이카운트 import 를 하위·보조 모드로 둔다(FIG §7 결정 2, 파서 완성 전제).
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 진입 조건 | - | • 조건1 [설정 수정] 인증 시 "설정 > 공제 관리" 하위 "공제 산정 모드"로 진입, 그 외 hide- CASE01 [미보유]: 진입 차단 (분기 상세 TBU) | RBAC · [[POL_권한(RBAC)]] | 📋 제안 골격 Phase 1 |
| 01 | 초기 상태 | Output | • 진입 시 §A 산정 모드 · §B 세무 운영 모드 두 절을 한 페이지에 노출, 현재 선택값 강조 - CASE01 [미선택]: 기본 모드(당월 계산, 추정) 강조 또는 선택 유도 안내 • 상단 안내문 "조직이 공제를 어떻게 계산하고(산정 모드), 누가 어떻게 확정·검토할지(세무 운영 모드)를 설정해요" (원문 카피 · 목업 기준) | ${calcMode.selected} · ${taxOps.mode} (추정) | 두 설정 한 페이지 · 조직 단위 |
| 10 | 산정 모드 선택 | Radio | • §A 절 제목 "공제 산정 모드" (원문 카피) • 당월 계산 / 공단 고지 기반 2지를 카드형 라디오로 표시 → 선택 시 조직 단위 반영 → 저장(30) - CASE01 [항목별 차등]: 항목별 차등 가능 여부 = FIG 설계 대기, 현재 단일 모드 적용(추정) | ${calcMode.options} · flex 정률/고지 이원화 (FIG §2-3) | 골격 Phase 1 · 차등 TBU |
| 10-E | ㄴ Empty (모드 목록 없음) | Text | • 산정 모드 정의(${calcMode.options})를 못 받으면 카드 영역 자리에 안내 노출 — 문구 원문 TBU (미구현)- CASE01 [로딩 실패]: 저장 버튼(30) disabled 처리 여부 TBU · 재시도 동선 TBU | ${calcMode.options} | Empty 문구 TBU · 지어내지 않음 |
| ㄴ11 | ㄴ 당월 계산 카드 | Card | • 카드 제목 "당월 계산" (기획 문구 — 목업 기준) • 설명: hereby 요율(수식 컬럼)로 당월 공제를 자동 산출 — 예측치 성격 • 선택 시: 당월 계산(정률·수식) 모드로 조직 설정 (FIG §4-2(a) 정률=수식 컬럼) | InsuranceCalculator (추정) · [[HBAD271_법정 요율 안내]] | 정률=수식 컬럼 · 산출=예측치 |
| ㄴ12 | ㄴ 공단 고지 기반 카드 | Card | • 카드 제목 "공단 고지 기반" (기획 문구 — 목업 기준) • 설명: 공단 EDI/파일 업로드가 진실 원천, Layer 4 대사로 확정 (고지·정산 개념 [[POL_공제_잠정·정산]]) • 선택 시: 고지 기반 모드로 조직 설정 (FIG §7 결정 1) | 공단 EDI/파일 · Layer 4 대사 · [[POL_공제_잠정·정산]] | 진실 원천 = 고지액 · 고지값 입력 경로 TBU |
| ㄴ13 | ㄴ 수동 입력 (하위) | Card | • 카드 제목 "수동 입력" (기획 문구 — 목업 기준) • 설명: 담당자가 공제액을 직접 입력 • 선택 시: 수동 모드로 조직 설정 (FIG §7 결정 1) | 공제 원장 (추정) | 직접 입력 · 입력 검증 화면 분리 여부 TBU |
| ㄴ14 | ㄴ 이카운트 import (하위) | Card | • 카드 제목 "이카운트 import" (기획 문구 — 목업 기준) • 설명: 외부 계산 xlsx를 import 후 커밋 (파서) • 선택 시: 외부 계산 import 모드로 조직 설정 (FIG §7 결정 2 · 파서 완성 전제) | 이카운트 · 파서(스캐폴드) · [[HBHR270_전자서명 발송·eCount 연동 시트 (2섹션)]] | 왕복=외부 import · 파서 미완성 |
| 20 | 모드별 책임 안내 | Info | • 각 모드의 법적 책임 경계 안내 — 라벨 "모드별 책임 안내" (기획 문구 — 목업 기준) - 자체 계산(당월) vs 고지 vs 외부 import 별 책임 경계 구분 - CASE01 [법률 검토 대기]: 확정 문구 미정, placeholder 안내 (FIG §7 결정 4) | [[POL_공제_판정]] · [[POL_법정공제]] | 🔴 법률 검토 대기 · 문구 TBU |
| 30 | 산정 모드 저장 | Button | • 선택한 산정 모드를 조직 설정에 저장 → 변경 확인 다이얼로그(HBAD272-1) 경유 • 클릭 시: organization_parameters/statutory.* 반영(추정) → 저장 성공 피드백(동선 TBU)- CASE01 [성공]: 선택 모드 강조 반영 · CASE02 [실패]: 에러 피드백 (80) | sdk.settings.update() (추정) · statutory.calcMode (추정) | 저장 동선 TBU · 확인 다이얼로그 경유 |
| 80 | 에러·실패 | - | • 모드 저장 실패 시 피드백 = TBU (미구현) | - | TBU |
| 90 | 권한별 차이 | - | • 조건1 [설정 수정] 없으면 진입/수정 차단- 세무사·일반 역할 노출 여부 = TBU | RBAC · [[POL_권한(RBAC)]] | 권한 분기 TBU |
산정 모드 카드 표 — 기획 문구·목업 기준
| # | 카드 제목 (기획 문구) | 축 | 산출 성격 | 진실 원천 | 근거 (FIG) |
|---|---|---|---|---|---|
| 1 | 당월 계산 | 당월 계산 | 자동 산출 (예측치) | hereby 요율 수식 | §4-2(a) 정률=수식 컬럼 |
| 2 | 공단 고지 기반 | 고지 기반 | 고지액 반영 | 공단 EDI/파일 업로드 | §7 결정 1 · §2-3 이원화 |
| 3 | 수동 입력 (하위) | 보조 | 직접 입력 | 담당자 입력값 | §7 결정 1 |
| 4 | 이카운트 import (하위) | 보조 | 외부 계산 반영 | 이카운트 xlsx | §7 결정 2 (파서 전제) |
어느 모드든 Layer 4 대사(공단 고지액 대조)가 뒤를 잇는다(FIG §7 결정 1). 모드별 책임 경계는 법률 검토 대기(§7 결정 4). 항목별 차등 적용 가능 여부는 FIG 설계 대기 — 현재 조직 단위 단일 적용(추정).
§B 세무 운영 모드 사양표
세무 운영 모드는 "누가 어떻게 확정·검토하는가"를 정하는 조직 단위 설정이다. §A 산정 모드와 직교하며(어느 산정 모드든 두 트랙 중 하나를 고른다), 세무 운영 프로세스 2트랙 정본(컨플 28082177)을 화면화한다.
두 트랙
- 트랙 Z — 담당자 셀프 확정: 세무사 없이 담당자가 직접 확정한다. 게이트 5종(fail-safe·요율 게이트·계산 진단·lineage·[[HBHR283_월 마감 공제 요약 리포트]])이 세무사 검사를 대신한다. 확정 플로우 = 담당자가 셀프 확정 버튼을 누른다(최종 점검 = HBHR283 리포트).
- 트랙 T — 세무사 검토: 세무사가 검토한 뒤 확정한다.
CASE [C안 확정 (콸 2026-09-21)]— 세무사 접근은 초기엔 시스템 밖 export 리뷰 루프(리포트를 PDF/엑셀로 내보내 세무사에게 넘기고 회신을 받는 B형)로 시작하고, 계정 방식(A, 세무사가 시스템에 직접 접속)은 추후 전환(disabled). 확정 플로우 = 검토 요청(리포트 발행·전달) → 확인 태그(검토 의견 기록=확인됨) → 확정.
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 100 | 세무 운영 모드 절 | - | • §A 산정 모드 아래 별도 절 "세무 운영 모드" 노출 (원문 카피 · 목업 기준) - 안내문 "공제를 최종 확정하는 방식을 골라요. 조직 전체에 적용됩니다" (원문 카피) - CASE01 [미설정]: 기본 트랙(Z 또는 선택 유도, 추정) | ${taxOps.mode} (추정) · statutory.* (추정) | v3 신설 · 미구현 |
| 110 | 트랙 선택 | Radio | • "담당자 셀프 확정 (Z)" / "세무사 검토 (T)" 2지 카드형 라디오 (원문 카피) • 각 옵션 아래 확정 플로우 차이 설명 노출 → 선택 시 조직 단위 반영 → 저장(140) - CASE01 [T 선택]: 트랙 T 하위 옵션(120) 노출 · CASE02 [Z 선택]: 하위 옵션 hide | ${taxOps.mode} | 조직 단위 단일 선택 |
| ㄴ111 | ㄴ 트랙 Z 설명 | Text | • "세무사 없이 담당자가 직접 확정해요. 게이트 5종(fail-safe·요율 게이트·계산 진단·lineage·월 마감 요약 리포트)이 세무사 검사를 대신합니다." (원문 카피) • 확정 플로우 문구 "월 마감 요약 리포트로 최종 점검 → 담당자가 셀프 확정 버튼을 눌러요" (원문 카피) | [[HBHR283]] · 게이트 5종 | |
| ㄴ112 | ㄴ 트랙 T 설명 | Text | • "세무사가 검토한 뒤 확정해요. 기본은 리포트를 내보내 검토받는 방식(C안 초기)이고, 세무사 계정 접속(A)은 추후 지원 예정입니다." (원문 카피) • 확정 플로우 문구 "리포트 발행·전달 → 세무사 검토중 → 회신(확인됨 태그) → 확정. 수정 요청이면 시트 수정 후 재발행." (원문 카피) | [[HBHR283]] export 루프 | C안 확정 (콸 2026-09-21) |
| 120 | 트랙 T 하위 옵션 | Radio | • 트랙 T 선택 시 "세무사 검토 방식" 노출: - ㄴ "리포트 검토 (기본) — 월 마감 요약 리포트를 export해 세무사에게 전달하고 회신을 받아요" (원문 카피) · 선택됨 (C안 초기) - ㄴ "세무사 계정 — 세무사가 시스템에 직접 접속해 검토해요" (원문 카피) · 비활성 disabled + "추후" 배지 - CASE01 [계정 방식 클릭]: disabled → 무반응 (전환 시점 미정) | ${taxOps.reviewMethod} (추정) | A안 disabled + "추후" 표기 |
| 130 | 전환 시 효력 | Info | • .ds-notice --info "전환 시 효력 — 모드 변경은 다음 귀속월부터 적용돼요. 진행 중인 귀속월은 기존 모드를 유지합니다. (실제 적용 시점·소급 여부 = 미결)" (원문 카피)- CASE01 [효력 규칙 미확정]: 실제 적용 시점·소급 여부 = 미결 표기 | 귀속월 경계 · [[POL_공제_계산·확정]] | 🔴 다음 귀속월부터 — 미결 |
| 140 | 저장 | Button | • 선택 트랙(+트랙 T 하위 옵션)을 조직 설정에 저장 → 변경 확인 다이얼로그(HBAD272-1) 경유 • 버튼 라벨 "설정 저장" (원문 카피) - CASE01 [성공]: 반영 · CASE02 [실패]: 에러 (동선 TBU) | statutory.taxOpsMode/taxOpsReviewMethod (추정) | 저장 동선 TBU · 확인 다이얼로그 경유 |
| 150 | 현재 조합 요약 | Output | • §A 선택 × §B 선택을 한 줄로 요약 노출 — "현재 조합 {산정 모드} × {세무 운영 모드} → {조합 ①-④ 월간 플로우 1줄}" (기획 문구 · 목업 기준) - CASE01 [보조 모드(수동·import) 선택]: 조합 번호 대신 "보조 모드 — 진실 원천만 치환, 동일 원리로 조합" 안내 • 조합 정의는 아래 「모드 조합 4종」 표 | ${calcMode.selected} × ${taxOps.mode} | 목업 장면 ③ · 저장 전 미리보기 |
| 180 | 에러·실패 | - | • 트랙·검토 방식 저장 실패 시 피드백 = TBU (미구현) · 실패 시 이전 선택값 롤백 여부 TBU - CASE01 [무반응]: 미구현 상태라 동작 없음 — 구현 시 버그 후보로 재확인 필요 | - | TBU |
| 190 | 권한별 차이 | - | • 조건1 [설정 수정] 없으면 진입/수정 차단- 세무사 역할 노출(트랙 T 계정 방식) = 추후·TBU | RBAC | 권한 분기 TBU |
C안 확정 (콸 2026-09-21): 트랙 T의 세무사 검토는 초기엔 시스템 밖 export 리뷰 루프로 시작하고, 계정 방식(A)은 추후 전환한다. 검토 루프의 상태 흐름(발행→검토중→확인됨/수정요청→재발행)은 [[HBHR283]]이 정의한다.
세무 운영 모드 확정 플로우 차이
| 트랙 | 확정 주체 | 확정 전 | 확정 트리거 | 근거 |
|---|---|---|---|---|
| Z 셀프 확정 | 담당자 | [[HBHR283]] 요약 리포트 최종 점검 | 담당자 "셀프 확정" 버튼 | 게이트 5종이 세무사 대체 (컨플 28082177) |
| T 세무사 검토 (기본=리포트 검토, C안 초기) | 담당자 (세무사 검토 반영) | 리포트 발행 → 세무사 export 전달 → 검토중 | 검토 의견 = "확인됨" 태그 후 확정 | C안: 시스템 밖 export 루프 (콸 2026-09-21) |
변경 확인 다이얼로그 사양표 (HBAD272-1)
§A·§B 모드 변경 저장(30·140) 시 노출되는 확인 모달. 효력 시점을 안내한 뒤 확정한다.
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| d00 | 노출 조건 | Modal | • 저장(30/140) 클릭 시 노출, 그 외 hide | 저장 액션 | 📋 제안 |
| d10 | 제목·요약 | Text | • 제목 "설정을 변경할까요?" (기획 문구 · 원문 TBU) • 변경 전→후 모드 요약 (예: "당월 계산 → 공단 고지 기반") | ${calcMode.selected}·${taxOps.mode} | 원문 TBU |
| d20 | 효력 시점 안내 | Info | • "모드 변경은 다음 귀속월부터 적용돼요. 진행 중인 귀속월은 기존 모드를 유지합니다." (원문 카피 · 130과 동일 문구) - CASE01 [효력 규칙 미확정]: 소급 여부 미결 | 귀속월 경계 · [[POL_공제_계산·확정]] | 🔴 미결 |
| d30 | 확정·취소 | Button | • "설정 저장" 확정 → sdk.settings.update()(추정) 반영 · "취소" → 다이얼로그 닫힘, 변경 폐기- CASE01 [성공]: 토스트 · CASE02 [실패]: 에러 피드백 (동선 TBU) | sdk.settings.update() (추정) | 동선 TBU |
모드 조합 4종 — 월간 플로우 차이
§A(당월 계산 / 고지 기반) × §B(트랙 Z / 트랙 T) = 4종 조합. 조합별 월간 플로우 차이를 1줄로 요약한다(어느 조합이든 Layer 4 대사가 뒤를 잇는다).
| 조합 | 산정(§A) | 세무 운영(§B) | 월간 플로우 요지 (1줄) |
|---|---|---|---|
| ① | 당월 계산 | 트랙 Z 셀프 확정 | hereby 요율 수식으로 당월 자동 산출 → 게이트 5종·[[HBHR283]] 점검 → 담당자 셀프 확정 → Layer 4 대사 |
| ② | 당월 계산 | 트랙 T 세무사 검토 | 당월 자동 산출 → [[HBHR283]] 발행·export → 세무사 검토중 → "확인됨" 태그 후 확정 → Layer 4 대사 |
| ③ | 고지 기반 | 트랙 Z 셀프 확정 | 공단 고지액(EDI/파일) 반영 → [[HBHR283]] 점검 → 담당자 셀프 확정 → Layer 4 대사(고지액 대조가 곧 원천) |
| ④ | 고지 기반 | 트랙 T 세무사 검토 | 공단 고지액 반영 → [[HBHR283]] 발행·export → 세무사 검토중 → "확인됨" 후 확정 → Layer 4 대사 |
설정 변경의 다운스트림 영향
| 설정 | 바뀌는 것 | 영향 받는 화면·산출물 | 영향 시점 | 근거 |
|---|---|---|---|---|
| §A 산정 모드 | 공제액의 진실 원천(수식 / 고지액 / 담당자 입력 / 외부 xlsx) | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] 계산·커밋 · [[HBAD271_법정 요율 안내]] 참조 요율 · 명세서 잠정 표시 | 다음 귀속월 (소급 미결) | FIG §7 결정 1·2 |
| §A 보조 모드(import) | 외부 파서 경로 활성 | 이카운트 import·파서(스캐폴드, 미완성) | 파서 완성 전제 · TBU | FIG §7 결정 2 |
| §B 세무 운영 모드 | 확정 주체·확정 전 관문 | [[HBHR283_월 마감 공제 요약 리포트]] 발행·검토 상태 흐름 · 확정 버튼 동선 | 다음 귀속월 (소급 미결) | 2트랙 정본 (컨플 28082177) · C안 |
| §B 트랙 T 검토 방식 | 세무사 접근 경로(export 루프 / 계정) | [[HBHR283]] export(PDF·xlsx)·검토 의견 기록 | C안 초기 = export 루프 · 계정(A) 추후 | C안 확정 (콸 2026-09-21) |
| 공통 | 없음 — 어느 조합이든 유지 | Layer 4 대사(공단 고지액 대조) | 상시 | FIG §7 결정 1 |
수동 입력·이카운트 import는 §A의 보조 하위 모드로, 각 트랙과 동일 원리로 조합된다(진실 원천만 담당자 입력값/이카운트 xlsx로 치환). 명세서 잠정 표시([[POL_공제_잠정·정산]])는 고지 기반·정산 전 상태에서 노출.
권한 요청 / 분기 요약
| 시나리오 | 트리거 | 결과 화면 | 비고 |
|---|---|---|---|
CASE01 [권한 보유 진입] | 조건1 [설정 수정] 인증 진입 | §A 산정 모드 + §B 세무 운영 모드 통합 화면 · 현재 값 강조 | 기본 |
CASE02 [미선택] | 모드 미설정 조직 진입 | 기본값(당월 계산 · 트랙 Z, 추정) 또는 선택 유도 | 초기 상태 |
CASE03 [산정 모드 변경] | §A 카드 선택 후 저장 | 변경 확인 다이얼로그(HBAD272-1) → statutory.calcMode 반영(추정) | 다음 귀속월 효력 |
CASE04 [고지/import 모드] | 고지 기반·이카운트 import 선택 | 외부 원천 대사·파서 경로 안내 | Layer 4 대사 연동 |
CASE05 [세무 운영 = 트랙 Z] | 셀프 확정 트랙 선택 | 담당자 셀프 확정 플로우 · [[HBHR283]] 최종 점검 | v3 신설 |
CASE06 [세무 운영 = 트랙 T · C안 확정] | 세무사 검토 트랙 선택 (기본=리포트 검토) | 하위 옵션 노출 · export 리뷰 루프 · 계정 방식(A) disabled | v3 신설 · 시스템 밖 리뷰 |
Open Question
- §A 산정 모드 저장 파라미터 키·procedure명 확정 (
statutory.calcMode/organization_parameters추정). TBU. - §A 항목별 차등 적용 가능 여부 — 조직 단위 단일 모드인지, 항목별(국민연금·건강보험 등) 차등 선택 가능한지 = FIG 설계 대기. TBU.
- §B 세무 운영 모드 저장 원천·키·procedure (
${taxOps.mode}·${taxOps.reviewMethod}추정). develop 실측(2026-09-21): 세무 운영 모드·세무사 검토·셀프 확정 관련 코드·RBAC 토큰 전무. TBU. - 전환 시 효력 규칙 — "다음 귀속월부터"의 실제 적용 시점(월초 경계/저장 시점), 진행 중 귀속월 소급 여부. 미결.
- 고지 기반 모드의 고지값 입력 경로 — 수동 입력인지 공단 EDI 연동인지, 업로드 UX·검증. TBU.
- 모드 변경 이력 감사 — 조직 모드 변경 이력(누가·언제·전→후)의 감사 로그 보존(감사로그 2년 원칙). TBU.
- 트랙 T 계정 방식(A) 전환 시점·요건 — 세무사 계정·권한·조직 초대 모델. 현재 "추후" 표기, 미정.
- RBAC 실토큰 —
settings:write(추정)의 실제 토큰명·스코프, 세무사·일반 역할 노출 분기. TBU. - 트랙별 확정 트리거와 [[HBHR280]] 6종 커밋·[[HBHR283]] 리포트 상태(확인됨 태그)의 게이트 정합. TBU.
- 미선택 조직의 실제 기본값이 "당월 계산·트랙 Z"인지 "선택 강제"인지. 현재 (추정). TBU.
- 모드별 책임 안내(20)의 확정 문구 — 자체 계산 vs 고지 vs 외부 import 책임 경계, 법률 검토(FIG §7 결정 4) 결과 대기. TBU.
- 이카운트 import 하위 모드의 파서 완성 상태·업로드 UX — 현재 스캐폴드·파서 미완성(FIG §7 결정 2). TBU.
- 수동 입력 하위 모드의 입력·검증 화면(별도 화면 분리 여부). TBU.
- 모드 전환 시 기존 확정 공제 데이터 처리·Layer 4 대사 트리거 시점. TBU.