HBMM210_모듈 상세 (Output Keys)

(Hereby) Module Manager > 모듈 상세 (Output Keys)

개요

좌측 module 선택 시 우측에 render되는 detail panel이다. 미선택 시 placeholder("좌측에서 모듈을 선택하면 Calculator의 Output Keys, Input 설정, Config 매핑을 확인합니다")를 유지하고, 선택 시 URL hash가 module.key로 변경되며 상세가 노출된다.
핵심 구성: Output Keys 표(key / 이름 / 설명(산식) / 단위 / 사용 Config) + Input 설정(parameterSchema · defaultParameters) + Test Calculator([[HBMM220_Test Calculator]]).
예로 근로계약(#employment_contract)의 baseSalary는 이름 "계약 기본급", 설명 "근로계약에 서명된 월 기본급 (계약연봉/12)", 단위 "원", 사용 Config "미사용"으로 노출된다. 4대보험(#payroll_rate_config) 선택 시에는 Output Keys 5행이 산식과 함께 노출된다.
**전 key 사용 Config가 "미사용"**이다(수당설정 0과 정합). 요율·파라미터가 코드 내장(default parameter)이고 tenant Config 동적변경이 미연동임을 뜻한다 → 요율 config화 Donue P1.

날짜	작성자	팀	변경 내용
2026-07-06	카나	PM	최초 작성
2026-07-10	카나	PM	라이브 기능 검토 반영
2026-07-21	카나	PM	GC700 깊이 재작성 + 확정 스타일 (메타/Data I/O 분리)

변수	엔티티.컬럼	값 없을 때	비고
$	calculator.calculate() 반환 키	미선택 시 placeholder	Output Keys 표 (key/이름/설명(산식)/단위/사용 Config)
$	계산 파라미터 스키마	{}	Input 설정
$	기본 계산 파라미터	{}	예 dailyDivisor=30, monthlyHours=209
${module.allowanceConfigs} / $	Config 매핑	0 (미사용)	현재 전 모듈 0

액션	전달 값	tRPC procedure	권한 토큰
module 선택	module.key	URL hash 변경, detail read-only render, mutation 없음	client (권한 없음)

번호	항목/기능명	타입	사양 및 기능 설명	연관/영향 범위	비고
00	미선택 placeholder	Text	• module 미선택 또는 detail render 전 안내 유지 • 표시: 제목 "Calculator I/O Registry" + "좌측에서 모듈을 선택하면 Calculator의 Output Keys, Input 설정, Config 매핑을 확인합니다"	client state
10	module 선택 → detail	Behavior	• 좌측 카드 선택 시 우측 detail을 render하는 동작 • 클릭 시: URL hash가 module key로 변경(예 #payroll_rate_config) → 우측 detail render	[[HBMM200_모듈 레지스트리 목록]]	client route/hash
20	Output Keys 표	Table	• calculator.calculate() 반환값을 열거하는 표. 컬럼: key / 이름 / 설명(산식 UI 노출) / 단위 / 사용 Config	module.outputKeys	보조표 4대보험 예시
30	Input 설정 (parameterSchema)	-	• 계산 파라미터 스키마 + defaultParameters 노출 • 예: 근로계약 dailyDivisor=30 · monthlyHours=209 · longevityThreshold=5	module.parameterSchema/defaultParameters	보조표 참조
40	Config 매핑	-	• allowanceConfigs/deductionConfigs 표시. 현재 전 모듈 0 = "미사용" • 의미: 요율/파라미터 코드 내장 → 요율 config화 P1	module.allowanceConfigs/deductionConfigs	요율 config화 P1
50	Test Calculator	-	• detail 하단 e2e 검증 도구. 직원 검색/연도/월/"실행" • 클릭 시: [[HBMM220_Test Calculator]] 참조. 실행 = 급여 record 생성 mutation (사람 실행)	[[HBMM220_Test Calculator]]	[[POL_급여정본경계]]

key	이름	설명	단위	사용 Config
baseSalary	계약 기본급	근로계약에 서명된 월 기본급 (계약연봉/12)	원	미사용

전 key "미사용" 상태(수당설정 0과 정합) — 요율·파라미터가 default parameter로 코드 내장이고 tenant Config가 연결되지 않았음을 뜻한다.

key	이름	설명(산식)	단위	사용 Config
national_pension	국민연금	기본급 × 4.5%	원	미사용
health_insurance	건강보험	기본급 × 3.545%	원	미사용
long_term_care	장기요양보험	건강보험 × 12.95%	원	미사용
employment_insurance	고용보험	기본급 × 0.9%	원	미사용
total	4대보험 합계	모든 보험료 합계	원	미사용

module.key	defaultParameters	비고
employment_contract	dailyDivisor=30, monthlyHours=209, longevityThreshold=5	호봉/장기근속
overtime_record	overtimeMultiplier=1.5, nightMultiplier=0.5, holidayMultiplier=1.5, weekendMultiplier=0.5, nightMealPrice=0	가산율
resignation_record	dailyDivisor=30, defaultLeaveDays=15	퇴사정산
payroll_rate_config	nationalPensionRate=4.5%, healthInsuranceRate=3.545%, longTermCareRate=12.95%, employmentInsuranceRate=0.9%	요율 코드 내장 (사용 Config=미사용)
tax_bracket_config	localTaxRate=10%	지방소득세
manual	unitPrice=0, multiplier=1	수동입력
fixed_incentive / education_subsidy / year_end_settlement	없음	default parameter 미노출