API 라우터 레퍼런스

packages/api/src/router.ts에 등록된 57개 tRPC 라우터가 http://localhost:3000/trpc에서 제공됩니다. 아래 프로시저 표는 핵심 비즈니스 라우터 22개를 상세히 다루며, 나머지 35개 등록 라우터는 추가 등록 라우터에 정리했습니다.

인증

auth

프로시저	타입	인증	설명
login	mutation	공개	이메일/비밀번호로 로그인
register	mutation	공개	새 사용자 + 조직 등록
refreshToken	mutation	공개	액세스 토큰 갱신
me	query	보호	현재 사용자 프로필 조회
logout	mutation	보호	토큰 무효화

직원 관리

employee

프로시저	타입	인증	설명
getEmployees	query	보호	필터로 직원 목록 조회 (검색, 상태, 팀)
getEmployee	query	보호	ID로 단일 직원 조회
create	mutation	보호	새 직원 생성
updateEmployee	mutation	보호	직원 필드 수정
uploadProfilePicture	mutation	보호	프로필 이미지 업로드 (base64)

team

프로시저	타입	인증	설명
list	query	보호	필터로 팀 목록
create	mutation	보호	팀 생성
update	mutation	보호	팀 수정
delete	mutation	보호	소프트 삭제
getComposition	query	보호	팀 멤버 조회
addMember	mutation	보호	팀에 직원 추가
removeMember	mutation	보호	팀에서 멤버 제거

organization

프로시저	타입	인증	설명
get	query	보호	조직 상세 조회
update	mutation	관리자	조직 설정 수정

급여

payroll

프로시저	타입	인증	설명
list	query	보호	급여 기록 목록 (연도, 월, 직원 필터)
create	mutation	보호	급여 기록 생성
calculate	mutation	보호	급여 계산 (4대보험, 세금)
approve	mutation	보호	지급 승인
getDetail	query	보호	항목별 급여 상세 조회

salary-grade

프로시저	타입	인증	설명
list	query	보호	카테고리별 호봉 목록
create	mutation	보호	호봉 생성
update	mutation	보호	호봉 금액 수정

allowance-record

프로시저	타입	인증	설명
list	query	보호	유형/상태 필터로 수당 목록
create	mutation	보호	수당 기록 생성
update	mutation	보호	수당 수정
approve	mutation	보호	일괄 수당 승인

deduction-record

프로시저	타입	인증	설명
list	query	보호	기간별 공제 목록
create	mutation	보호	공제 생성
update	mutation	보호	공제 수정

근태

attendance

프로시저	타입	인증	설명
list	query	보호	출근 기록 목록
quickCheckIn	mutation	보호	출근 (현재 시간 + GPS)
quickCheckOut	mutation	보호	퇴근
getTodayStatus	query	보호	오늘 출근 상태 조회
getWorkHoursSummary	query	보호	주간 근무시간 요약 (52시간 준수)

overtime-record

프로시저	타입	인증	설명
list	query	보호	연장근무 기록 목록
create	mutation	보호	연장근무 기록 생성
update	mutation	보호	연장근무 수정
request	mutation	보호	직원 연장근무 신청
approve	mutation	보호	연장근무 승인

leave-request

프로시저	타입	인증	설명
list	query	보호	휴가 신청 목록
request	mutation	보호	휴가 신청 제출
cancel	mutation	보호	대기 중인 신청 취소
approve	mutation	보호	휴가 신청 승인
reject	mutation	보호	사유와 함께 반려

준법 및 복리후생

year-end-settlement

프로시저	타입	인증	설명
list	query	보호	연도별 정산 목록
create	mutation	보호	정산 기록 생성
update	mutation	보호	정산 수정

resignation-record

프로시저	타입	인증	설명
list	query	보호	퇴직 기록 목록
create	mutation	보호	퇴직 정산 생성

education-subsidy

프로시저	타입	인증	설명
list	query	보호	교육비 지원 목록
create	mutation	보호	교육비 기록 생성
update	mutation	보호	교육비 수정

fixed-incentive

프로시저	타입	인증	설명
list	query	보호	필터별 인센티브 목록 (직원, 상태, 카테고리, 기간)
get	query	보호	ID로 인센티브 조회
create	mutation	보호	추가전용 버전 관리 인센티브 생성
update	mutation	보호	인센티브 수정 (내용 변경 시 새 버전 생성)
delete	mutation	보호	인센티브 소프트 삭제
approve	mutation	보호	인센티브 일괄 승인
history	query	보호	chainId별 버전 이력 조회

간호 스케줄링

nurse-scheduler

프로시저	타입	인증	설명
listSchedules	query	보호	병동 + 기간별 근무표 목록
getSchedule	query	보호	배정 포함 근무표 조회
createSchedule	mutation	관리자	새 초안 근무표 생성
generateSchedule	mutation	관리자	AI 근무 배정 생성
updateEntry	mutation	관리자	단일 셀 수정
confirmSchedule	mutation	관리자	근무표 수정 잠금
publishSchedule	mutation	관리자	간호사에게 공개
getProfile	query	보호	간호사 프로필 조회
listProfiles	query	관리자	병동별 프로필 목록
createProfile	mutation	관리자	간호사 프로필 등록
deleteProfile	mutation	관리자	간호사 프로필 삭제
getMyPreference	query	보호	나의 희망 일정 조회
createPreference	mutation	보호	기간별 희망 일정 생성
updatePreference	mutation	보호	희망 일정 수정
submitPreference	mutation	보호	검토를 위한 제출
requestWorkTypeChange	mutation	보호	근무형태 변경 요청
cancelWorkTypeChange	mutation	보호	대기 중인 변경 요청 취소
listWorkTypeChanges	query	보호	변경 요청 이력 조회

팀 관리

team-manager

프로시저	타입	인증	설명
dashboard	query	팀 리더	대기 건수 조회
myTeams	query	팀 리더	관리 팀 목록
teamMembers	query	팀 리더	팀 멤버 목록
listLeaveRequests	query	팀 리더	팀 휴가 신청 목록
approveLeaveRequests	mutation	팀 리더	일괄 휴가 승인
rejectLeaveRequests	mutation	팀 리더	사유와 함께 일괄 반려
listOvertime	query	팀 리더	팀 연장근무 목록
approveOvertime	mutation	팀 리더	일괄 연장근무 승인
rejectOvertime	mutation	팀 리더	사유와 함께 일괄 반려
listIncentives	query	팀 리더	팀 인센티브 목록
createIncentive	mutation	팀 리더	팀원 인센티브 생성
approveIncentives	mutation	팀 리더	일괄 인센티브 승인

커뮤니케이션

conversation

프로시저	타입	인증	설명
list	query	보호	사용자 대화 목록
create	mutation	보호	1:1/그룹/채널 대화 생성

message

프로시저	타입	인증	설명
list	query	보호	대화의 메시지 목록
send	mutation	보호	메시지 전송
markRead	mutation	보호	대화 읽음 처리

document

프로시저	타입	인증	설명
list	query	보호	문서 목록
upload	mutation	보호	문서 업로드

notification

프로시저	타입	인증	설명
getSettings	query	보호	알림 설정 조회
updateSettings	mutation	보호	푸시/이메일 설정 수정

역할 및 권한

role

프로시저	타입	인증	설명
list	query	관리자	권한 포함 역할 목록
create	mutation	관리자	역할 생성
update	mutation	관리자	역할 수정
delete	mutation	관리자	비시스템 역할 삭제
listPermissions	query	관리자	사용 가능한 전체 권한 목록
updatePermissions	mutation	관리자	역할의 권한 할당 설정

추가 등록 라우터

appRouter(packages/api/src/router.ts)에 등록되어 있으나 위 프로시저 표로는 아직 펼치지 않은 라우터입니다. 라우터 키 → 도메인:

라우터 키	소스 모듈	도메인
account	account.router.ts	Account 레이어 — 통합 로그인 회원, owner 범위 가드
platform	platform.router.ts	플랫폼/프로비저닝 관리
ai	ai.router.ts	Claude AI 통합 — 대화, tool 루프, 임베딩
invite	invite.router.ts	멤버 초대
inquiry	inquiry.router.ts	랜딩/문의
signup	signup.router.ts	셀프 회원가입 + 워크스페이스 허브
organizationHoliday	organization-holiday.router.ts	조직 휴일 달력
organizationParameter	organization-parameter.router.ts	조직 전역 급여 파라미터 저장소(append-only 버전)
teamDrive	team-drive.router.ts	드라이브 — 공유 폴더/파일 저장(admin 임베드)
eSign	e-sign.router.ts	전자서명 레코드 + 제공자 웹훅 인박스
attendanceRate	attendance-rate.router.ts	출근율 설정
workTimeClosing	worktime-closing.router.ts	근무시간 월 마감
offsiteWork	offsite-work.router.ts	외근 기록/유형
deductionImport	deduction-import.router.ts	공제 일괄 임포트
annualLeavePromotion	annual-leave-promotion.router.ts	연차사용촉진 워크플로(안내/서명/자동취소/지정)
permissionRequest	permission-request.router.ts	권한 부여 요청
shiftGroup	shift-group.router.ts	시프트 그룹 정의
certificationType	certification-type.router.ts	자격증/면허 커스텀 유형 설정
sheetView	sheet-view.router.ts	급여대장 워크북 — 시트 뷰
sheetRow	sheet-row.router.ts	급여대장 워크북 — 행 + commitSheet(AR/DR 산출)
sheetCell	sheet-cell.router.ts	급여대장 워크북 — 셀 값
sheetTemplate	sheet-template.router.ts	급여대장 워크북 — 시트 템플릿
deviceToken	device-token.router.ts	푸시 알림 디바이스 토큰 등록 (FCM/Web Push)
documentTemplate	document-template.router.ts	HTML 증명서 양식 — 변수 치환·미리보기
employeeCertification	employee-certification.router.ts	자격증/면허 대장 — 등록·자가제출·Excel export
generalAffairs	general-affairs.router.ts	총무 — 공지·법정의무교육·반복업무 (중첩 라우터)
gradePromotion	grade-promotion.router.ts	호봉 승급 요청·승인 워크플로
inventory	inventory.router.ts	재고 — 품목·카테고리·유통기한·반품
itemCode	item-code.router.ts	수당/공제 항목 코드 (eCount 호환)
managementDashboard	management-dashboard.router.ts	경영 대시보드 — 인건비·청구(revenue)·인력
moduleRegistry	module-registry.router.ts	소스 모듈 메타·계산기 상태 (Module Manager)
payrollCellMemo	payroll-cell-memo.router.ts	급여 셀 메모 — 해결(resolve) 추적
secomEvent	secom-event.router.ts	세콤 지문 이벤트 수집·처리·조회
shift	shift.router.ts	근무 시프트 CRUD (차등율·treatAsHoliday)
storage	storage.router.ts	presigned 업로드/다운로드 URL

sheet* 4개 라우터가 급여대장 워크북의 핵심 API 표면입니다. AllowanceRecord/DeductionRecord는 sheet-row 파이프라인의 commitSheet로만 산출됩니다 — Payroll Provenance 참고.