Hapibit Church Planner

사역을 원본 시작 연도보다 이후의 year로 복사하여 같은 교회·seriesId의 새 DRAFT 초안을 생성하며 원본은 변경하지 않습니다. 제목·설명·부서·담당자·장소·예상 인원, 할 일 내용·담당자, 자원 이름·종류·메모, 기도제목, 프로그램 내용·시간·담당자, 예산 항목·계획 금액은 승계합니다. 준비 시작·진행 시작·종료 날짜, 할 일 dueDate, 프로그램 date는 연도 차이만큼 이동하며 대상 연도에 없는 날짜는 해당 월의 말일로 조정합니다. todos.done은 모두 false, resources.status는 모두 NEEDED, budget.actual은 모두 0으로 초기화합니다. links는 빈 배열 []로 초기화하여 자료·신청 링크를 복사하지 않고, 새 사역의 retrospective는 null입니다. 평가 저장 시 이미 생성된 도움말을 포함한 기존 tips는 title·source 중복 제거 후 마지막 30개까지 승계하며, 이 호출에서 평가를 새로 작성하거나 도움말을 새로 생성하지 않습니다. 사역과 할 일·자원·기도·프로그램·예산 항목에는 새 ID를, 새 사역에는 현재 생성·수정 시각을 부여합니다. 같은 seriesId에 시작 연도가 year인 사역이 이미 있으면 중복 이월을 거부합니다.

rollover_ministry

새 사역을 저장하고 생성된 사역을 반환합니다. 기본 상태는 DRAFT입니다. 같은 입력으로 반복 호출하면 사역이 중복 생성될 수 있습니다.

create_ministry

연결된 교회, 현재 사용자의 역할·부서, 접근 가능한 사역 수, 쓰기 권한 및 커뮤니티 이용규칙 동의 상태를 반환합니다.

get_planner_context

지정한 ID의 사역 상세와 현재 updatedAt을 반환합니다. 내부 준비·예산·평가 내용은 사용자 권한에 따라 제한됩니다.

get_ministry

권한 범위 안에서 사역 개요를 검색합니다. 연도는 진행 기간과 겹치는 사역을 포함합니다. ministries는 현재 페이지이며 total은 조건에 맞는 전체 개수입니다. limit은 기본 30, 최대 100입니다. nextOffset은 다음 페이지의 offset이며 마지막 페이지에서는 null입니다. 개요에는 ID·제목·부서·상태·담당자·장소·준비 및 진행 날짜·예상 인원·updatedAt이 포함됩니다. 준비 항목·예산·평가 등 상세 내용은 포함되지 않습니다.

list_ministries

기존 사역의 지정한 필드만 수정하고 저장된 사역을 반환합니다. 현재 저장된 updatedAt이 필수이며 일치하지 않으면 버전 충돌로 수정이 거부됩니다. 배열은 전체 교체되며 생략한 필드는 유지됩니다.

update_ministry