reminder-backend-kit 0.1.9

Composable Python backend kit for reminder services.

reminder-backend-kit

리마인더 백엔드에서 자주 쓰는 모듈(Teams 발송, EventBridge Scheduler)을 하나로 묶은 통합 패키지입니다.

Installation

pip install reminder-backend-kit

Usage

from reminder_backend_kit import (
    TeamsSender,
    ReminderScheduler,
    ReminderScheduleInput,
)

teams = TeamsSender.from_environment()

scheduler = ReminderScheduler.from_environment()

teams.send_reminder(
    user_id="20240001",
    title="회의 준비",
    scheduled_at="2026-05-19T01:00:00Z",
)

scheduler.create_schedule(
    ReminderScheduleInput(
        reminder_id="abc-123",
        service_id="service-a",
        user_id="20240001",
        title="회의 준비",
        scheduled_at="2026-05-19T01:00:00Z",
        early_alert_minutes=10,
    )
)

Intended Use

• 이 패키지는 Python 백엔드(예: Docker 기반 Lambda 런타임)에서 import 해서 사용합니다.
• 실행 앱(lambda handler)은 얇게 유지하고, 실제 기능은 본 kit에 위임합니다.
• TEAMS_API_BASE_URL, TEAMS_DOMAIN는 플랫폼/인프라에서 환경변수로 주입합니다.
• ALERT_LAMBDA_ARN, SCHEDULER_ROLE_ARN는 플랫폼/인프라에서 환경변수로 주입합니다.
• 사용자 API에서는 Teams/Scheduler ARN 파라미터를 직접 받지 않는 사용 방식을 권장합니다.