설계 보고서 · 검토용 · 2026-06-05

코칭 리텐션·휴면 엔진 — 설계 보고서

"부모가 안 들어오기 시작하면 코칭 메시지가 똑같아지거나 아예 안 간다"는 문제의 해법. 편지를 최근 3일만 보여 매일 들어오게 하고(배포됨), 안 들어오면 휴면 단계별로 다른 편지 + 회유 알림톡 3번으로 다시 부릅니다. 아래 §8 결정 포인트만 체크해 주시면 바로 빌드합니다.

현황 · 무엇이 됐고 무엇이 남았나

키스톤은 배포됨, '휴면 부르기'가 남음

항목	상태
편지 최근 3일만 표시(웹툰 쿠키식 FOMO)	✅ 배포 — 홈 스레드 3일 제한 + "최근 3일만 볼 수 있어요" 푸터. 안 보면 사라짐 = 매일 접속 유도
도입부 반복 가드(편지 다양성)	✅ 배포·검증
편식 팁 36개(데이터 없을 때용)	✅ 생성·저장
cron 휴면 모드 + 회유 알림톡 D1·D3·D7	⏳ 이 보고서 = 그 계획

지금 동작(고쳐야 할 것)

① 끼니 기록이 최근 7일 중 3일 미만이면 크론이 그 자녀를 아예 스킵(편지 0). ② 3일 이상이지만 어제 미입력이면 어제 편지를 재사용(같은 메시지). → 둘 다 리텐션 구멍.

설계 ① · 휴면 단계 사다리

마지막 기록일 기준으로 편지를 바꾼다

신호 = 마지막 끼니 기록일(이 앱의 핵심 행동). "안 들어옴" ≈ "안 기록함". 편지는 휴면 7일까지 계속 생성(스킵 안 함), 7일 넘으면 중단.

마지막 기록	모드	편지 내용	회유 알림톡
0~1일 (활성)	정상	평소 개인화 편지	없음(매일 오는 사람)
2~7일 (휴면)	복귀	과거 데이터 긁어 따뜻한 컴백 — "아린이가 [과거 진전]했었죠. 한 끼만 다시 남기면 이어가요". 최근 데이터 빈약하면 편식 팁을 함께	D1·D3·D7에만
7일+ / 데이터 빈약	팁	짧은 편식 팁(36개 라이브러리, 날짜+자녀 시드 로테이션 — 데이터 없어도 따뜻하게)	D7 1회로 마무리

비중복

복귀 편지·팁도 방금 만든 코칭 비중복 엔진(도입부 가드·무브 로테이션) 재사용 — 휴면이어도 매번 다른 말.

설계 ② · 회유 알림톡 D1·D3·D7

안 들어온 다음날부터 딱 3번, 매일 오는 사람은 0

안 들어온 다음날 = D1. 그 이후 D1·D3·D7에만 발송(스팸·죄책감 방지). 발송 시각 = 아침 8~9시(아이 식사 전후). 멱등(자녀당 단계별 1회).

D1 — 손실 회피("그저께 편지 곧 사라져요")

[밀프레드] 아린이 코치 편지가 쌓여 있어요 🍪
그저께 편지는 곧 사라져요 — 코치 편지는 최근 3일만 볼 수 있거든요. 오늘의 한 걸음 보기 →

D3 — 부드러운 컴백 + 새 소식

[밀프레드] 아린이 잘 지내나요? 🌿
한 끼만 남겨도 코치가 다시 봐드려요. 그동안 다른 엄마들 노하우도 새로 올라왔어요 →

D7 — 마지막, 따뜻하게(죄책감 없이)

[밀프레드] 아린이의 식경험, 다시 시작해볼까요? ✉️
부담 없는 오늘의 한 걸음을 준비해뒀어요. 천천히 와도 괜찮아요 →

톤 철칙(절대)

"아이가 굶고 있어요"·"왜 안 하세요" 같은 죄책감·압박 금지(편식은 죄책감 주제 → 더 빨리 떠남). 매일 푸시 금지(D1·D3·D7만). 스트릭 끊겨도 비난 없이 부드럽게.

구현 계획

건드리는 곳 · 핵심 로직

휴면 일수 계산 — 자녀별 마지막 meal_logs.log_date로 daysSinceLastLog. 과거 ~21일에서 기록 일수(history)도 — 진짜 사용자(≥3일) 판별.
크론 eligibility 변경(/api/cron/coach) — 현행 'last 7일 ≥3일'에서 → history ≥3일 & 휴면 ≤7일이면 생성(스킵 정책 변경).
모드 분기 — coach.ts generateLetter에 dormancyDays 주입 → 2일+는 복귀 톤·과거 데이터 요약, 데이터 빈약하면 coach-tips.json 팁 1개.
회유 알림톡 — 휴면이 정확히 1·3·7일인 자녀에게 발송. 멱등(자녀+단계 키), 기존 알림톡 plumbing(sens.ts) 재사용. 매일 오는 사람(0일)은 제외.
빈도 제어 — D1·D3·D7만(편지 생성과 별개). 7일 후 중단.

의존성

알림톡 실제 발송 = NCP SENS 환경변수 + 회유 템플릿 3종 심사(D1/D3/D7). 로직은 지금 만들어두면 켜는 순간 작동. 편지 3일 윈도우·휴면 편지 생성은 알림톡 없이도 작동.

⭐ 결정 필요 · 이사님 체크

이것만 정해주시면 바로 빌드합니다

휴면 신호 = '끼니 기록' 기준으로 OK?

마지막 끼니 기록일로 휴면 판정(앱은 열었지만 기록 안 한 경우는 미감지). 대안: 앱 오픈 추적(last_seen) 추가 — 더 정확하지만 작업 늘어남. 권장: 끼니 기록 기준(핵심 행동·이미 추적).

회유 알림톡 카피 3종 — 위 초안대로 OK?

D1(손실 회피)·D3(컴백+노하우)·D7(마지막·따뜻). 문구 수정/톤 다르게 원하면 알려주세요.

타이밍 = D1·D3·D7 / 아침 발송 OK?

편지 생성은 새벽 2시, 회유 알림톡은 아침 8~9시. D1/D3/D7 외 추가/축소 원하면.

7일 후 = 완전 중단? 아니면 주 1회 팁 계속?

권장: 7일까지 편지·D7 알림톡 후 중단(알림 피로 방지). 원하면 그 이후 '주 1회 편식 팁'으로 약하게 유지 가능.

편지 '휴면 7일까지 생성' = 비용/스팸 우려 없나?

현재 사용자 소수라 비용 무시 가능. 푸시는 D1/D3/D7만이라 스팸 아님. (대규모 되면 휴면 생성 빈도 조정 옵션.)

← 문서 허브로