모니터링

CSO 정산 포털의 배포 상태, 이메일 발송 이력, 시스템 상태를 모니터링하는 방법을 설명합니다.

Vercel 배포 상태 확인

포털은 GitHub main 브랜치에 push하면 Vercel이 자동으로 빌드하고 배포합니다.

배포 현황 확인

1. Vercel 대시보드 에 로그인합니다.
2. csoweb 프로젝트를 선택합니다.
3. Deployments 탭에서 배포 이력을 확인합니다.

프리뷰 배포

PR(Pull Request) 생성 시 Vercel이 자동으로 프리뷰 URL을 생성합니다. 프리뷰 배포에서 변경 사항을 확인한 후 main에 머지하면 프로덕션에 반영됩니다.

이메일 발송 이력 (/admin/emails)

발송된 모든 이메일 내역을 조회합니다.

통계 카드

페이지 상단에 4개의 통계 카드가 표시됩니다.

필터링

이메일 로그 테이블

실패한 이메일은 빨간색 뱃지로 표시되며, 에러 메시지를 확인하여 원인을 파악할 수 있습니다.

메일머지 발송 (/admin/mailmerge)

CSO 업체들에게 개인화된 이메일을 일괄 발송합니다. 각 업체의 정산 데이터를 본문에 포함할 수 있습니다.

수신자 설정

섹션(거래처별, 제품별, 영업사원별 등)을 선택하여 정산 테이블을 본문에 포함할 수 있습니다. 섹션 순서는 드래그로 변경 가능합니다.

이메일 작성

• 제목: 변수 삽입 가능 (예: {{업체명}}님 정산 안내)
• 본문: 자유 텍스트 + 변수 삽입
• 사용 가능 변수: {{업체명}}, {{대표자명}}, {{사업자번호}}, {{정산월}} 등

미리보기 및 테스트 발송

1. 미리보기 버튼 클릭 → 변수가 치환된 실제 이메일 내용 확인
2. 테스트 계정 선택 → 테스트 발송 으로 실제 수신 확인
3. 테스트 확인 후 발송하기 클릭

발송 과정

발송은 SSE(Server-Sent Events)를 통해 실시간 진행 상황을 표시합니다.

발송 간격

발송 간격은 /admin/email-settings에서 email_send_delay_ms 값으로 조정할 수 있습니다. Resend API의 Rate Limit(초당 2건)을 초과하지 않도록 6초 이상을 권장합니다.

발송 결과

발송 완료 후 결과 요약이 표시됩니다.

시스템 정보 (/admin/system)

시스템 구성 및 외부 서비스 연결 상태를 한눈에 확인합니다. 읽기 전용 페이지입니다.

앱 정보 카드

배포 카드

데이터베이스 카드

외부 API 카드

인증 카드

이메일 서비스 카드

에러 로그 확인

Vercel 대시보드

1. Vercel 대시보드 → csoweb 프로젝트 → Logs 탭
2. Runtime Logs: 서버 사이드 에러 (API 라우트, 서버 컴포넌트)
3. Build Logs: 빌드 시 발생한 에러

주요 모니터링 포인트

이메일 알림 설정 (/admin/email-settings)

이메일 유형별로 자동 발송 여부를 ON/OFF할 수 있습니다.

메일머지는 수동 발송이므로 이 설정에 포함되지 않습니다.

이메일 프로바이더 설정

프로바이더 전환 시 연결 테스트 버튼으로 설정이 올바른지 확인할 수 있습니다. 테스트 이메일이 test_recipient_email로 발송됩니다.