계산 모듈 조회와 실행 결과 확인
제품 개발 기록으로 · 급여 시트 · 급여 배포
화면·SDK·서버 코드를 대조한 모듈 조회·실행 안내입니다. 실제 급여 생성은 실행 검증하지 않았습니다.
목적과 진입
module-manager/에 로그인하면 Calculator I/O Registry가 열립니다. 수당·공제 계산기의 입력/출력 의미와 계산 원천을 확인하는 개발·운영 도구입니다. 조직의 서비스 사용 여부를 설정하는 관리자 메뉴와는 다른 기능입니다.
조회 API는 로그인과 조직 컨텍스트가 필요합니다. 직원 검색에는 직원 조회 권한, 실행에는 payroll:create 권한 및 결과 조회 권한이 각각 필요합니다. 화면 접근만으로 실행 권한까지 확보되는 것은 아닙니다.
현재 「실행」은 선택한 직원만 대상으로 하는 모의 계산이 아닙니다. 먼저 선택한 연월의 조직 급여 생성 API를 호출하고, 그다음 선택한 직원의 결과를 조회합니다. 서버는 CONFIRMED가 하나라도 있으면 거절하지만, 없고 집계 대상 직원이 있으면 해당 조직·기간의 기존 급여를 상태 필터 없이 삭제 후 재생성합니다. 초안만 대상이라는 보장이 없으며 계산됨·승인됨·지급됨 등 다른 상태도 삭제 대상이 될 수 있습니다. 수당·공제 기록은 연결을 해제한 뒤 재사용합니다. 개발 검증에는 별도 테스트 조직과 기간을 사용해야 하는 이유입니다.
제공 조작
| 조작 | 진입 | 결과 |
|---|---|---|
| 레지스트리 조회·재시도 | 최초 진입, 상단 새로고침, 오류의 「재시도」 | 계산기 목록과 요약 재조회 |
| 모듈 선택 | 좌측 모듈명 | 출력 키·원천/대상 테이블·연결 설정 표시, URL 해시 변경 |
| 직원 검색·선택 | 「이름, 이메일, 사번 검색...」 | 최대 10개 검색 결과 중 실제 직원 ID 선택 |
| 연월 지정·실행 | Test Runner의 연·월과 실행 버튼 | 조직 기간 급여 생성 후 해당 직원 결과 조회 |
| 결과 JSON 확인 | 결과의 「JSON」·「Raw JSON」 | 조회한 객체 상세 팝업 |
| 내 정보·로그아웃 | 상단 사용자명·로그아웃 | 내 정보 또는 인증으로 연결 |
모듈 설치·삭제, 코드 편집, 설정 생성·수정·저장 버튼은 없습니다. 이 도구의 실행 결과를 급여 확정·명세서 발송 완료로 해석하지 않습니다.
레지스트리 읽기
- 로그인 후 목록 로딩이 끝날 때까지 기다립니다. 오류가 표시되면 메시지를 확인하고 「재시도」를 누릅니다. 실패 시 이전 목록도 비워집니다.
- 좌측에서 필요한 모듈을 선택합니다. 모듈 전환 시 이전 테스트 결과·오류가 초기화되고 URL에 모듈 키가 기록됩니다. 같은 해시로 재진입하면 해당 모듈을 다시 선택합니다.
tables에서 관측 원천과 금액 기록 대상을 구분하고Output Keys의 키·이름·설명·단위를 읽습니다. 예를 들어 근로계약 계산기는 근로계약 관측값을 읽으며 수당 기록과 연결됩니다.No Configs,미구현,Manual상태를 구분합니다. 현재 서버는 연결 설정 배열을 항상 비워 반환합니다. 따라서 수당설정·공제설정의 0은 병원에 급여 설정이 전혀 없다는 뜻이 아닙니다. 설정 소유권이 시트 열로 이동한 뒤 이 레지스트리의 연결 조회가 아직 이관되지 않은 상태입니다.- 서버는
parameterSchema·defaultParameters를 반환하지만 화면의 기존inputDescriptions소비와 차이가 있습니다. 입력 설정이 표시되지 않으면 해당 계산기에 입력이 없다고 단정하지 말고 급여 시트의 실제 열 설정을 확인합니다.
직원·기간을 지정하고 결과 확인하기
- 사용할 테스트 조직과 기간을 확인합니다. 연·월 기본값은 화면을 연 브라우저의 현재 연월입니다. 연·월 입력은 숫자이며 서버에서 기간 스키마를 검증합니다.
- 직원 검색 칸에 한 글자 이상 입력합니다. 문자열 앞뒤 공백은 검색 시 제거합니다. 결과 행을 눌러 선택해야 하며, 이름만 입력한 상태는 실행 대상 선택이 아닙니다. 입력을 다시 수정하면 기존 직원 선택이 해제됩니다.
- 선택 후 사번·입사일·계약 금액 등 제공되는 보조 정보를 확인합니다. 보조 정보 조회가 실패해도 별도 오류가 나타나지 않을 수 있으므로 빈 금액을 0원으로 간주하지 않습니다.
- 모듈과 직원이 선택된 상태에서 연·월을 확인하고 실행합니다. 실행 중에는 중복 조작을 피하고 처리 결과를 기다립니다. 별도 미리보기나 실행 취소 단계는 없습니다.
- 먼저
payroll.generateForPeriod가 조직의 해당 기간을 처리합니다. 수당·공제 기록 자체를 다시 계산해 만드는 것이 아니라, 서버 현재 구현은 저장된 수당·공제 기록에서 급여를 집계합니다. 화면의 과거 'full pipeline' 주석과 현재 서버 동작을 구분합니다. - 선택 모듈이 공제 또는 양쪽 유형이면 해당 직원 공제 검토 결과를, 수당 유형이면 해당 직원 수당 최대 100건과 가능한 원천 상세를 읽습니다. 이 결과가 선택한 모듈 하나만의 산출물로 필터된다고 가정하지 않습니다.
- 「Raw JSON」 또는 행 「JSON」을 눌러 반환 구조를 확인하고 × 또는 팝업 바깥을 눌러 닫습니다. 실행 시간은 브라우저에서 생성과 후속 조회에 걸린 총 경과시간이며 계산기만의 성능 지표가 아닙니다.
실패와 재진입
- 확정 급여가 있으면 해당 기간 수정 불가 오류가 표시됩니다. 다른 연월로 임의 우회해 실제 급여를 만들지 말고 검증용 데이터 조건을 맞춥니다.
- 직원 검색 실패는 빈 결과로 처리됩니다. 검색 결과 없음과 권한·네트워크 실패를 화면만으로 구분하기 어렵습니다.
- 생성 성공 후 후속 조회가 실패할 수 있습니다. 화면의 오류만으로 생성이 취소됐다고 판단하지 않습니다. 급여 배포에서 해당 연월의 저장 결과를 확인한 뒤 재실행 여부를 결정합니다.
- JSON 팝업을 닫는 것은 결과 조회를 닫는 것이며 이미 실행된 급여 생성을 되돌리지 않습니다.
- 화면 새로고침은 선택 모듈 해시는 복원하지만 직원 선택·테스트 결과까지 영속화하지 않습니다.
다른 기능과 연결
레지스트리는 @hereby/code-modules의 listCodeModules()와 module-registry.router.ts에서 구성합니다. hasCalculator는 해당 원천에 코드 모듈이 등록됐는지를 뜻하며, 기존 UI와의 호환을 위해 필드명을 유지합니다. 출력 키·입력 스키마·기본값은 코드 모듈의 정의를 사용하고, 연결 설정 배열은 시트 열 조회가 연결될 때까지 비어 있습니다. 금액 원천은 급여 시트, 결과 집계와 배포는 급여 배포, 법정공제 판정은 법정공제를 함께 확인합니다.
근거·변경 기록·화면 검증
기존 모듈 설정 관리 설명을 실제 레지스트리 조회·급여 집계 흐름과 대조해 신규 작성했습니다. 실행 범위, 연결 설정의 빈 배열, 원천 필드 차이를 명시했습니다. 아래 영상으로 목록·모듈 상세를 추가 촬영했습니다. 아직 필요한 화면은 직원 선택, 실행 전 연월, 결과/확정 기간 오류이며 실제 급여 생성 권한과 테스트 데이터가 있는 환경에서 기록해야 합니다.
모듈 매니저 사용 영상
처음에는 재생 버튼을, 다시 볼 때는 아래 동작 번호를 누르세요.
- 계산 모듈을 선택합니다
모듈 매니저에서 ‘근로계약’ 계산기를 선택합니다. 등록된 계산기의 정보를 확인하는 담당자용 화면입니다. 자세히 따라 하기
- 계산에 쓰는 자료와 결과 항목을 확인합니다
계산에 사용하는 자료와 결과를 저장할 항목을 확인합니다. 「Output Keys」에서는 결과 항목의 키(식별 이름)·표시 이름·설명·단위를 볼 수 있습니다. 확대 영역은 실제 화면의 행을 그대로 읽은 내용입니다. 자세히 따라 하기
- 다른 계산기로 이동합니다
왼쪽 목록에서 ‘초과근무’ 계산기를 선택합니다. 자세히 따라 하기
- 출력 정의를 비교합니다
선택한 계산기의 출력 정의로 바뀌었는지 확인합니다. 영상은 레지스트리 조회까지만 다루며, Test Calculator 실행은 조직 전체의 해당 월 급여 생성에 영향을 주므로 별도 사용법을 먼저 확인합니다. 자세히 따라 하기
교육용 예제 조직에서 촬영했어요. 이름·금액·날짜는 교육용 예시이며, 사용 중인 조직의 자료를 확인하세요.
모듈 매니저 소개와 사용자 교육에서 실제 누르는 위치와 결과를 따라갈 수 있도록 번호 자막·강조 표시를 붙여 촬영했습니다. 별도 DB의 로컬 예제 조직·관리자 테스트 계정을 사용했습니다. 화면 크기는 1440×900입니다. 근로계약과 초과근무 계산기의 원천·대상 테이블과 출력 정의를 조회했습니다. 조직의 급여를 생성하는 Test Calculator 실행은 촬영·검증하지 않았습니다.
앱 소개 · 영상 목록과 교육 범위 · 촬영·검증 기록
사용자용 절차 연결
계산기 상세 조회은 고객이 개발 기록을 열지 않고 읽는 사용법입니다. Codex가 사용자용 절차에 모듈 선택과 출력 항목 조회를 보완했습니다. 테스트 실행이 선택한 직원만이 아니라 해당 조직·월의 급여를 생성한다는 영향과 확정 기간 제한은 앱 소개에 유지합니다. 영상의 자세히 따라 하기는 조회 절차로 연결하며 테스트 실행의 미검증 범위는 이 개발 기록에 유지합니다. 이 문서 연결 정리는 제품 동작을 다시 실행하거나 녹화 범위를 확장한 검증이 아닙니다.