🚦 ④ 영양평가 레이어 (신호등·간식)

이 모듈은 아이가 며칠간 먹은 식재료 목록을 받아 '영양 신호등'을 켭니다. 부엌 저울로 그램(g)을 재는 게 아니라 "이 영양소를 채워주는 음식을 며칠에 한 번꼴로 먹었나"라는 빈도로 판단합니다. 단백질은 매일(주5일+) 먹어야 초록, 철분처럼 몸에 저장이 잘 되는 건 주2일만 닿아도 초록이 됩니다. 정량 측정이 불가능한 가정·기관 식단 기록의 한계를 '빈도'라는 현실적 잣대로 바꾼 것입니다. 색은 초록(충분)·노랑(조금 부족)·빨강(부족) 세 단계입니다.

이 모듈에는 세 갈래가 있습니다. (가) 식사 신호등(nutrition.ts): 36종 영양소(보건복지부 KDRI 2025)와 8개 식품군(곡물·콩류·유제품·고기계란·생선해산물·비타민A채소·기타채소·과일)을 각각 빈도로 평가하고, 가공식품·반복 메뉴 감점을 붙여 '다양성 점수'를 냅니다. (나) 간식 엔진(snack.ts): 끼니와 완전히 분리해 간식만 봅니다. 과자·사탕·단 음료 같은 초가공을 얼마나 자주 주는지, 좋은 통식품(과일·삶은 계란·치즈)으로 채우는지, 그리고 간식이 다음 끼니 입맛을 망쳤는지를 봅니다. (다) 체격·성장 트랙(growth-reference.ts + coachWeekly.ts): 키·몸무게를 질병관리청 성장도표에 빗대 또래 곡선을 잘 따라가는지 보고, 저체중·성장 더딤이면 결핍 다양성 대신 탄단지(고기·계란·콩·유제품) 보강으로 추천 방향을 틀고(macro 트랙), 과체중이면 간식 절제로 틉니다.

핵심 비유는 '신호등 + 안전장치'입니다. 데이터가 적으면(기록 3일 미만) 섣불리 빨강을 켜지 않고 노랑으로 보류하고, 비타민D처럼 음식보다 햇빛·보충제로 채우는 건 빨강을 끕니다. 짠 음식 많은 한국 식단 특성상 나트륨은 아예 집계에서 빼서 '괜한 빨강(가짜 경고)'을 막습니다. 결과물은 별도 화면이 아니라 매일 가는 코칭 편지 안에 자연스럽게 녹습니다.

이 모듈은 세 파일에 걸쳐 산다 — 식품군·미량 신호등(nutrition.ts), BMI·성장 추종도(growth-reference.ts), macro 트랙 + 거울 스케줄(coachWeekly.ts 주간계획 모듈). cron(app/api/cron/coach/route.ts)이 셋을 조립해 손(coach.ts)에 넘긴다.

A. 식품군·미량 신호등 — lib/nutrition.ts

B. BMI · 성장 추종도 — lib/growth-reference.ts 라이브

C. macro 트랙 + 거울 스케줄 — lib/coachWeekly.ts (주간계획 모듈) 라이브(코드)

D. 간식 엔진 — lib/snack.ts

E. cron 조립 + 손(편지) 배선 — app/api/cron/coach/route.ts · lib/coach.ts

• BMI·성장 산출(route:384-405): snackBand=bmiBandFor() · heightTrack/weightTrack=growthTracking(firstGrowth, latestGrowth) — baseline(가장 오래된) + current(최신) 2점으로 추종도 계산(firstGrowth:206·latestGrowth:205). 격주 게이트: 최근 13일 내 성장 거울 노출 있으면(recentGrowthDates) 생략, 없으면 growthMirrorCtx=growthTrackToPhrase(...).
• macro 슬롯(route:624-627): enrichWeeklyPlan에 band·heightTrack·weightTrack 전달 → macroTrack 박제. pickPlanSlot(route:852)이 오늘 슬롯·macroPhrase 픽.
• 손 배선(route:916): growthMirror: planSlotCtx?.macroPhrase ?? growthMirrorCtx — macro 슬롯 우선, 없으면 격주 BMI 거울. 같은 날 간식 멘트는 생략(route:834 — 성장 거울 있으면 snackText=null, 한 번에 하나).
• 편지 주입(coach.ts:788-789·793): growthBlock = b.growthMirror ? '[⚠️ 성장 신호 — 숫자·퍼센타일·BMI·체중·살 단어 금지…]\n'+growthMirror : '' → 프롬프트 본문에 ${growthBlock} 인서트. 작문기 재생성(coach.ts:1031)이 성장 구절 누락 시 fixNotes로 강제 포함.

데이터 파이프라인 전체 그림. 초록=손까지 닿음, 빨강 점선=코드는 있으나 실전에서 잠자는(DEAD) 경로.

┌──────────────────────────── 두 진단 축 (이 모듈의 골격) ────────────────────────────┐
│                                                                                      │
│   축1: 식품군 8분류 다양성  ──▶  reds·missing  ──▶  [라이브] 거울줄·추천 타깃·점수    │
│        (computeGroupSignals)      매일 손에 닿음                                       │
│                                                                                      │
│   축2: 체격·성장 연료(macro) ──▶  band·track   ──▶  [코드 라이브 / 실전 잠] phrase     │
│        (bmiBand·growthTracking)   growthTrack    null 다발 → growthBlock 빈 채 발행    │
│        ↑                                                                              │
│        └── 데이터 다리 부재: growth_logs 2점(≥1개월) 자녀 거의 없음 → 정보부족/정상   │
│            → growthTrackToPhrase=null → macro 트랙·성장 nudge 실전 미점화              │
└──────────────────────────────────────────────────────────────────────────────────────┘
   결론: 칼로리·단백·지방 절대량(성장 연료) 차원이 진단에서 사실상 빠짐 — 축1만 굴러감

아린(5세) 최근 5일 집/기관 식재료 → 이 모듈 통과 → 손에 닿는 출력. 두 케이스로 비교한다.

// computeSignals — 아린(5세) 최근 5일 식재료(날짜별)
computeSignals([
  ["쌀","소고기","계란","감자","미역"],
  ["쌀","계란","김치","두부"],
  ["쌀","소고기","감자","양파"],
  ["쌀","계란","미역","당근"],
  ["쌀","닭고기","감자","김치"],
], catOf)

// evaluateSnacks — 같은 아이 meal_logs + 밴드 + reds
evaluateSnacks({
  rows: [
   {slot:"pm_snack",log_date:"2026-06-15",
    menus:["초코우유","과자"],ingredients:[],
    ate_well:true,meal_time:15.5},
   {slot:"dinner",log_date:"2026-06-15",
    menus:["밥","미역국"],ingredients:["쌀","미역"],
    ate_well:false,meal_time:18.5},
  ],
  band:"정상",
  reds:["오메가3","비타민D","철"],
})

// macro 트랙 입력(EnrichContext 발췌)
band: "정상",  heightTrack: null,  weightTrack: null
// ↑ growth_logs 2점 없음 → growthTracking=null

// computeSignals → NutrientSignal[] (발췌)
[{nutrient:"단백질",daysCovered:5,level:"green"},
 {nutrient:"철",    daysCovered:4,level:"green"},
 {nutrient:"비타민A",daysCovered:1,level:"yellow"},
 {nutrient:"오메가3",daysCovered:0,level:"yellow"}]
// computeGroupSignals: 콩류 weeklyEst≈1.4
//   → rotation·0회 아님 → yellow (0회였다면 red)

// evaluateSnacks → SnackEval
{ultraCount:1, interference:[{date:"2026-06-15",
  mealSlot:"dinner",gapH:3,kind:"ultra"}],
 stance:"maintain", band:"정상",
 goodSuggestions:["치즈","삶은 계란","두유","과일"]}

// buildMacroTrack(band:정상,tracks:null)
{active:false, reason:null, boostGroups:[],
 phrase:null, cadenceWeek:false}   // ← macro 잠

// → LetterInput.growthMirror = null  (macroPhrase·격주거울 둘 다 null)
// → coach.ts growthBlock = ''  (성장 구절 0)

EARNED(사실) — 식품군 8분류 신호등·결핍 거울줄·간식 stance·다양성 점수·집/기관 분리·질식 가드는 실측상 매일 손에 닿아 작동한다. macro/성장 코드(buildMacroTrack·growthTracking·growthBlock 배선)도 깔려 있다. 아래는 미화 없이 정직한 천장.

• 빈도 평가 명시(정량 g 아님) — '며칠 커버' 기반, 과대 단정 금지
• 데이터 가드: 기록<3일이면 신호 보류(yellow/reference), 기록<5일이면 red 보류, 비타민D는 빈도 red 비활성(보충제 영양소)
• 빗대기 안전망: 미매핑 식재료를 '모름'으로 비우지 않고 카테고리 근사 / KDRI 미매핑은 reference(가짜 빨강 방지)
• KDRI 제외 5종(나트륨·에너지·수분·불소·크롬) — 결핍 걱정 없는 항목 신호화 안 함
• 환각 차단: computeTimeseries가 날짜 사실만 계산해 LLM 추정 방지, assertNoVeg는 catOf 신뢰 시에만 '채소 없음' 단정(P4)
• 질식 안전: 간식 추천에 (반으로 잘라)·(익혀·강판)·(잘게) 조리표시 보존 — 작문기가 통째 표현으로 못 바꾸게
• 체중 민감 가드: snackStance·snackEvalToPrompt·growthTrackToPhrase 모두 체중·살·다이어트·BMI·숫자·퍼센타일·등급 단어 금지, 방향(stance)·비수치 문구만 노출. growthBlock 지침도 동일 금지어 강제(coach.ts:789)
• 가공/반복 패널티 과잉처벌 방지: 끼니 3건 미만 미적용, 상한(가공22·반복12), 흰쌀밥·김치·국 등 주식 제외
• daycareMode: 점심 급식만 평가하는 기관이 과일·유제품 결핍으로 부당 감점되지 않게 제외
• 성장 잔소리 저빈도: 성장 거울은 격주(13일 쿨다운), macro 슬롯은 cadenceWeek=arcWeek%2===0(2주 연속 금지) — 측정 저빈도 존중

이 모듈이 채우는 컨텍스트 키: