본문으로 건너뛰기

API

ChurchApps API는 모듈형 모놀리스입니다. 하나의 코드베이스가 각각 자체 데이터베이스를 가진 여섯 개의 데이터 모듈을 제공합니다. 이 구조는 마이크로서비스의 장점(명확한 경계, 독립적인 데이터 저장소)을 가지면서도, 단일 배포의 운영 단순함을 제공합니다.

모듈​

모듈목적
Membership교인, 그룹, 가구, 권한
Attendance예배, 세션, 체크인 기록
Content페이지, 섹션, 요소, 스트리밍
Giving헌금, 기금, 결제 처리
Messaging대화, 알림, 이메일
Doing할 일, 계획, 배정

기술 스택​

  • 런타임: TypeScript(ES 모듈)를 사용하는 Node.js 24.x
  • 프레임워크: Express
  • 의존성 주입: Inversify(데코레이터 기반 라우팅)
  • 데이터베이스: MySQL -- 모듈마다 하나의 데이터베이스, 각각 자체 연결 풀 사용
  • 인증: CustomAuthProvider를 통한 JWT 기반 인증
  • 배포: Serverless Framework v3를 통한 AWS Lambda

포트​

프로토콜포트설명
HTTP8084기본 REST API
WebSocket8087실시간 소켓 연결

Lambda 함수​

AWS에 배포하면 API는 여섯 개의 Lambda 함수로 실행됩니다.

  • web -- 모든 HTTP 요청 처리
  • socket -- WebSocket 연결 관리
  • timer15Min -- 이메일 알림을 위해 30분마다 실행됨(이름은 역사적인 이유로 유지됨)
  • timerMidnight -- 요약 이메일과 유지보수 작업을 위해 매일 실행
  • timerScheduledTasks -- 기한이 된 자동화와 기한이 지난 워크플로 처리를 위해 매일 실행
  • timerWebhooks -- 대기 중인 외부 웹훅을 전송하기 위해 매분 실행

공유 라이브러리​

API는 두 개의 ChurchApps 공유 패키지에 의존합니다.

정보

API는 ES 모듈을 사용합니다(package.json에 "type": "module"). 가져오기(import)는 반드시 ES 모듈 문법을 사용해야 합니다.

이 섹션의 내용​

  • 로컬 설정 -- API를 복제하고, 구성하고, 로컬에서 실행하기
  • 데이터베이스 -- 모듈별 데이터베이스 구조, 스키마 스크립트, 데이터 접근 패턴
  • 모듈 구조 -- 컨트롤러, 리포지토리, 모델, 인증
  • API 키 -- 스크립트와 커넥터를 위한 개인 액세스 토큰
  • 연결된 앱(OAuth) -- 제3자 앱을 위한 다중 테넌트 OAuth 흐름
  • 웹훅 -- 외부 시스템에 이벤트 알림 보내기
  • MCP 서버 -- API를 AI 어시스턴트에 노출하는 Model Context Protocol 엔드포인트
  • 엔드포인트 참조 -- 모든 모듈의 전체 REST API 문서