tb_track_item_m은 제목, 설명, 주기 사용 여부, 주기 일수, 알림 사용 여부, 사용자별 sort_order_no, 재활성화 가능한 is_active, 삭제 시각 deleted_at, 사용자 소유권을 저장함. 신규 항목은 활성 항목의 마지막 순서로 생성됨.
tb_track_notification_rule_n은 항목별 days_before, notification_time, 정렬 순서와 deleted_at을 저장함. 현재 규칙의 (track_item_id, days_before, notification_time) 중복은 WHERE deleted_at IS NULL 부분 고유 인덱스로 제한함.
tb_track_record_n은 실제 처리 일시, 비고, 사용자 소유권과 deleted_at을 저장함. 처리 이력 삭제는 deleted_at만 설정함.
tb_track_notification_delivery_n은 알림 규칙과 도래 시각의 조합을 기준으로 발송 상태를 저장해 중복 전달을 막음. delivery_status는 전달 성공 SENT와 채널 전달 실패 FAILED를 구분함.
항목·규칙·이력 목록은 deleted_at IS NULL만 조회함. 항목의 is_active=false는 관리 화면에서 재활성화 가능한 상태이며 삭제와 구분함.
목록 조회 인덱스는 항목 (user_id, deleted_at, is_active, sort_order_no), 규칙 (track_item_id, deleted_at, sort_order_no), 이력 (track_item_id, deleted_at, performed_at DESC)임. 현재 테이블 규모에서 deleted_at 단독 인덱스는 사용하지 않음.
Track SQLite는 Track API만 writer임. Hub, Automation, Message는 Track SQLite를 직접 읽거나 쓰지 않음.
Track은 최신 처리 이력이 있는 항목만 최신 처리 일시, 주기, days_before, notification_time으로 실제 알림 시각을 계산함. days_before=0은 도래일 당일 지정 시각을 의미함.
발송 시각이 도래하고 동일 규칙·도래일 조합의 delivery가 없을 때만 Message의 notification.send internal API를 호출함. 이 호출에는 Automation 인증 정보, X-Junkbox-Job-Type: notification.send, 항목 소유자의 owner_user_id를 전달함.
Message는 Telegram 등 채널 전달과 발송 이력을 소유함. Track은 Message SQLite를 직접 다루지 않음.
Message 응답 본문의 status가 SUCCESS가 아니면 delivery를 FAILED로 기록하고 다시 호출하지 않음. 같은 키는 Message가 재전달하지 않으며 실패는 Message의 실패 알림이 사용자에게 전달함.