AI용 분할본 · 지도 3단계(화면) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 5 운세 화면 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

PART 6 — 상담 채팅: 기억하는 AI 만들기

6-1. 두 가지 상담 모드 (앱 성격에 따라 선택)

HRUM 기억이 실제로 어떻게 동작하는지 (2026-09 실측) — 문안과 화면을 정직하게 만들려면 알아야 합니다:

• /reading/memory 는 직전 대화 원문을 그대로 넣지 않습니다. 같은 회원의 대화를 5번마다 요약해 두고, 그 요약·태그를 다음 답변에 넣습니다. 그래서 첫 4번은 memory.used: false이고, 5번째부터 true가 됩니다
• 요약은 큰 줄기(고민·상황·흐름)를 남기고 자잘한 사실은 빠질 수 있습니다. 실측에서 "이직 고민"은 기억했지만 대화 초반에 말한 반려견 이름은 요약에서 빠졌습니다 — 화면에는 이력이 다 보여도 AI의 기억은 요약입니다. "그럼 그건?" 같은 후속 질문은 앱이 앞 질문을 한 문장으로 다시 담아 보내면 정확해집니다
• 대화 이력(질문과 답 원문)은 HRUM이 보관하고 GET /memory/{endUserId}/messages로 20개씩 읽을 수 있습니다(크레딧 차감 없음, 요청 제한은 소모). 그래서 대화 기록 테이블을 만들 필요가 없습니다 — 폰을 바꿔도 로그인만 하면 같은 대화가 보입니다
• 기억 저장소는 endUserId 하나에 하나입니다. 같은 값으로 /reading/memory 와 자유 채팅(/chat/completions 의 user)을 부르면 두 대화가 한 이력 목록(GET /memory/{endUserId}/messages)에 섞여 저장되고, 요약 주기(5턴) 뒤에는 상담 맥락이 자유 채팅 답변에(또는 그 반대로) 섞여 들어갈 수 있습니다(2026-10-09 실측: 같은 값으로 두 엔드포인트를 1번씩 부르자 이력 4건이 한 목록에 저장). 기억을 기능별로 나누려면 endUserId 를 회원id:saju / 회원id:chat 처럼 기능 접미사로 나눠 보내세요 — 지난 대화 목록도 따로 나뉩니다. 책 코드 그대로면 상담 기억 열쇠는 회원 id 하나(lib/app-hooks.ts 의 memoryKey)라 상담만 쓰는 앱은 이대로 충분합니다. 자유 채팅을 붙일 때 나누는 법은 6-3 끝에 있습니다

6-2. 사주 상담 채팅 [메인 레시피]

[프롬프트]
상담 채팅 화면을 만들어 주세요. 아래 📄 두 파일(get-book-code 가 만든 app/api/history/route.ts, components/Chat.tsx)을 그대로 쓰고(기억 "불필요"여도 두 파일 모두 책 그대로 둔다), 디자인만 결정서 13번에 맞춰 입혀 주세요.

먼저 제작 결정서의 "기억" 항목을 적용한다:
- "필요"(기본): 화면에 <Chat profile={…} />. POST /api/float/reading/memory + GET /api/history — 열면 최근 20개, 위로 스크롤하면 20개씩 더
- "불필요": 화면에 <Chat profile={…} memory={false} /> 한 줄이면 끝. POST /api/float/reading 을 쓰고, 지난 대화 불러오기·기억 배지가 없다. 화면 대화는 이번 방문만 보인다.
  Chat.tsx 를 고치거나 app/api/history/route.ts 를 지우지 않는다 — 라우트는 그대로 두고 불리지 않을 뿐이다(고치면 verify-book-code 가 영원히 "다름")

데이터:
요청 body: readingBody(profile, question, personaKey, chartId?) + requestId (lib/api.ts) — 만세력 body 를 복사해 쓰지 말 것 (timezone 이 섞이면 FLOAT 400)
{
  year, month, day, hour?, minute?, gender, // 저장된 원국 (시간 모름이면 hour·minute 키 자체를 생략). timezone 없음
  question: 사용자가 입력한 질문 (최대 500자 — 프록시 pickBody 의 MAX_LEN 이 서버에서 강제, 넘으면 400),
  personaKey: "counsellor",                 // lib/persona-list.ts 의 key 만. 말투(tone)·페르소나 글은 서버 프록시가 목록에서 찾아 붙인다
  requestId: newRequestId(),                 // 질문 1건에 1회 생성, 재시도·409 재조회에는 같은 값 재사용 (없으면 400)
  // endUserId 는 브라우저가 보내지 않는다 — 프록시가 로그인 세션의 회원 id 를 넣는다 (7-2)
}
※ 사용자 질문은 최대 500자, AI 답변(interpretation)은 서버 max_tokens 로 별도 상한 — 둘을 같은 글자수 제한으로 묶지 않는다
응답 data: { interpretation(답변 텍스트), memory: { used, summaryInjected, notesInjected, tags[] }, costPoints }
※ FLOAT 원 응답은 { success, data } 이고 프록시는 그대로 돌려준다 — 화면은 callProxy 가 한 겹 벗긴 r.data.interpretation, 서버 훅(lib/app-hooks.ts afterFloat)은 벗기기 전이라 call.result.data.interpretation

endUserId 규칙 (기억이 섞이지 않게): 프록시가 로그인 세션의 회원 id(users.id)를 서버에서 강제로 넣는다 = 기억 단위는 계정(본인 원국 1개). 브라우저가 보낸 endUserId 는 무시 — 그대로 통과시키면 남의 ID 로 남의 상담 기억을 읽고 오염시킬 수 있다. 한 계정에서 여러 원국(가족·지인)을 보게 하려면 부록 E-0 확장이 필요하고, 그때 열쇠는 서버가 소유권을 검증한 뒤 파생하는 `${user.id}:${chartId}` 다

화면 요구사항 (Chat.tsx 가 이미 지키는 것 — 디자인을 바꿀 때 깨지 말 것):
1. 말풍선 UI — 사용자 오른쪽, AI 왼쪽(페르소나 이름·아바타 이모지는 디자인 때 추가). AI 답변은 Markdown 이므로 components/AssistantMessage.tsx 로만 렌더 — 화면에 ** 가 남으면 실패. dangerouslySetInnerHTML 금지
2. 전송 후 로딩: 페르소나에 맞는 문구(lib/persona-list.ts 캐릭터 항목의 loadingText, 없으면 기본 문구). 로딩 중에는 입력창·전송 버튼·추천 칩 비활성화
3. memory.used 가 true 면 "지난 상담을 기억하고 있어요" 표시 (기억 "필요"일 때만). 첫 4번은 false 가 정상이다
4. 끝없는 대화: 처음 20개, 맨 위에 닿으면 이전 20개를 앞에 붙이고 읽던 위치를 유지, id 가 같은 메시지는 두 번 보이지 않게. 더 없으면 "처음 대화예요"
5. 질문 입력 아래 추천 질문 칩 3개(lib/persona-list.ts 캐릭터 항목의 chips, 없으면 기본 칩)
6. 오류는 대화 배열에 넣지 말 것 — 오류 문구는 말풍선 밖에. 실패한 질문은 입력창으로 돌려준다 (오류 문구가 대화에 들어가면 다음 질문의 문맥처럼 보인다)
7. 409 OUTCOME_UNKNOWN(결과 불명): 새 requestId 로 재시도하지 않는다 — "처리 결과를 확인하는 중" + 같은 requestId 로 다시 확인하는 버튼
8. 입력창에 접근 가능한 이름(aria-label)과 500자 제한

완료 기준 (전부 실제로 실행해 증명):
- tests/assistant-message.test.tsx 통과 + 실제 상담 답변 한 건을 데스크톱·390px 에서 열어 별표 노출·가로 넘침이 없는지 눈으로 확인
- 기억 "필요": 같은 계정으로 5번 넘게 질문 → 5번째부터 memory.used 가 true / 로그아웃 → 재로그인 → 대화 이력이 그대로 보임 / 다른 계정으로 로그인 → 앞 계정의 대화가 안 보임
- 시간 모름 원국으로 상담 → 시주를 모른다고 밝히고, 정오 가정으로 단정하지 않음
- 서버를 끈 상태에서 전송 → 오류가 말풍선 밖에만 표시되고 대화에 남지 않음
- 같은 requestId 로 두 번 전송(더블클릭) → FLOAT 호출은 한 번 (7-5 자동 테스트로 증명)

app/api/history/route.ts — 지난 대화 20개씩 (HRUM 기억 서버에서)코드 자리: cat app/api/history/route.ts · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

캐릭터(페르소나)는 lib/persona-list.ts 한 곳에: 결정서의 캐릭터를 이 파일에 적습니다 — key(영문 id)·name(화면 이름)·tone(casual=반말, warm=다정한 존댓말, formal=격식체)·intro(한 줄 소개)·persona(3-2 공식으로 쓴 전문, 2,000자까지). 선택 항목 chips(추천 질문 칩, 4개·60자까지)·loadingText(답을 기다릴 때 문구)는 빼면 lib/persona.ts 의 기본값을 씁니다 — 상담 화면(components/Chat.tsx)은 고치지 않습니다. 하나만 적으면 고정 캐릭터, 둘 이상이면 상담 화면 위에 고르기 버튼이 생겨 사용자가 고릅니다(고른 것은 그 브라우저에 기억). 브라우저는 캐릭터 key 만 보내고, 서버 프록시가 목록에서 말투와 페르소나를 찾아 HRUM 에 붙입니다 — 목록에 없는 key 는 400. 페르소나 글자수만큼 상담 1회 입력 과금이 늘어나니(글자수 × 0.25토큰) 핵심만 쓰세요. lib/persona.ts(목록 검사·조회)는 [완전 코드], lib/persona-list.ts는 책이 수정을 허락한 파일입니다 — key 가 겹치거나 비어 있으면 빌드·테스트가 바로 실패해 알려 줍니다.

lib/persona-list.ts — 내 캐릭터 목록 (수정 허용 — 결정서대로 바꾼다)코드 자리: cat lib/persona-list.ts · 고쳐도 되는 파일(5-b) — 캐릭터 목록 — 결정서의 페르소나로 · 원문(사람용 — AI 는 열지 않는다)

lib/persona.ts — 캐릭터 목록 검사·조회코드 자리: cat lib/persona.ts · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

tests/persona.test.ts — 캐릭터 목록 검사 테스트코드 자리: cat tests/persona.test.ts · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

components/Chat.tsx — 끝없는 대화 + 기억형 상담 화면 (기억 불필요면 memory 를 false 로 — 이번 방문만)코드 자리: cat components/Chat.tsx · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

AI 답변은 Markdown입니다 — 절대 plain text로 그대로 뿌리지 마세요. HRUM의 interpretation·report·chat 답변에는 **굵게**, 번호·불릿 목록, 빈 줄 문단, `인라인 코드`가 섞여 옵니다. 문자열을 <p>{text}</p>로 넣으면 실제 초보자 완주에서처럼 말풍선에 **내 자리를…** 같은 별표가 그대로 보입니다. 아래 컴포넌트 하나로만 렌더하고, 프로젝트 구조가 달라도 이 파일을 기존 컴포넌트 폴더에 맞춰 넣으면 됩니다.

components/AssistantMessage.tsx — 설치: npm i react-markdown remark-gfm코드 자리: cat components/AssistantMessage.tsx · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

components/AssistantMessage.module.css — 코드 자리: cat components/AssistantMessage.module.css · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

tests/assistant-message.test.tsx — 코드 자리: cat tests/assistant-message.test.tsx · 없거나 verify 가 "다름"이면 node scripts/get-book-code.mjs · 손으로 고치지 않는다 · 원문(사람용 — AI 는 열지 않는다)

확인 방법: 테스트 통과 후 데스크톱·모바일(390px) 폭에서 긴 목록·긴 URL·표가 말풍선 밖으로 넘치지 않는지 눈으로 봅니다(overflow-wrap: anywhere·pre/table overflow-x가 그 방어선). 복사 버튼은 원문 Markdown을 복사합니다 — 저장도 원문, 복사도 원문, 파싱은 표시 때만.

이 앱의 상담은 어느 AI 가 답하나 — topic: 책의 app/page.tsx 는 상담 화면에 <Chat topic={…} /> 를 넘기고, 그 값이 HRUM 의 only 로 갑니다(lib/api.ts 의 readingBody). 프록시는 이 앱의 주제(lib/app-topics.ts)에 있는 AI 만 허용합니다(아니면 404). 사주 상담은 { only: 'saju' } — 다른 항목 없이 사주만 보고, 고정 요금 없이 토큰 값만 듭니다. 자미두수 상담은 { only: 'ziwei' } — 원국(시각 필수)으로 서버가 명반 요약을 만들어 그것만 근거로 답하고, 1회 = 토큰 값 + 명반 1회 값(₩50)입니다. 별자리 상담은 { only: 'astro' } — 원국으로 서버가 네이탈 차트 요약을 만들어 그것만 근거로 답하고, 1회 = 토큰 값 + 점성술 항목 요금(₩20)입니다. 타로 상담은 { only: 'tarot', tarot: { spread, seed } } — 생년월일 없이, 서버가 같은 seed 로 화면과 같은 카드를 다시 뽑아 그 카드로 답합니다. 1회 = 토큰 값 + 타로 1회 요금입니다. 꿈해몽 상담은 { only: 'dream', dream } — 생년월일 없이, 서버가 같은 꿈 이야기에서 상징 낱말을 찾아 그 낱말만 실마리로 답합니다. 1회 = 토큰 값 + 꿈해몽 1회 값(₩30, 못 찾으면 0원)이고, 꿈이 아니라 본인의 위기를 말하는 글이면 해몽 대신 도움 안내를 0원으로 돌려줍니다. 사주가 아닌 주제의 상담은 기억도 따로입니다 — 프록시가 기억 열쇠를 회원id:주제 로 나눠 보내고(대화 이력도 /api/history?topic=…), 사주 상담의 기억과 섞이지 않습니다. 통합판에서 only 를 빼고 부르면 오늘의 운세·자미두수·점성술이 모두 들어간 통합 풀이가 되고 그 항목들의 고정 요금이 모두 더해집니다(콘솔 문서 "포함 항목") — 이 책은 탭마다 한 AI 로 부르는 쪽을 기본으로 둡니다.

6-3. 페르소나를 채팅에 입히기

사주 상담(/reading/memory)에는 6-2의 캐릭터(말투+페르소나)가 이미 들어갑니다. 그래도 사주와 상관없는 잡담까지 캐릭터로 받고 싶다면 자유 채팅(/chat/completions)에 systemPrompt로 페르소나를 넣고, 사주 정보를 서버가 구조화해서 주입하는 하이브리드를 씁니다. 자유 채팅은 사주를 자동 주입하지 않으므로, 일간 한 줄만 넣으면 사주 상담이 아니라 일반 잡담이 됩니다. 브라우저가 model·systemPrompt·max_tokens를 정하게 두면 누구나 내 크레딧으로 아무 모델이나 돌릴 수 있으니 이 값들은 반드시 서버에서 고정합니다.

[프롬프트 — 캐릭터성 강한 앱용]
자유 채팅 모드를 추가해 주세요. 브라우저는 절대 model/systemPrompt/max_tokens를 보내지 않고, 서버 라우트가 전부 고정한다.

1) 서버 라우트 app/api/chat/route.ts (프록시와 별도. FLOAT 키는 lib/float-client.ts 의 callFloat 로만 사용)
   - 7-2 프록시와 같은 관문을 먼저 통과: getSessionUser(req) 로 로그인 확인(비로그인 401), dedup.allow 로 회원별 분당 10회 제한(429). 이게 없으면 "누구나 제 크레딧으로 채팅하는 공개 엔드포인트"가 된다
   - 입력: { personaKey, messages, requestId }  // saju 는 브라우저에게서 받지 않는다 — 서버가 DB 의 birth_profiles 에서 원국을 읽어 만세력을 조회한다. endUserId 도 받지 않는다
   - 시간 미상 판단은 서버가 만세력 응답에서 직접 한다: `saju.birthHour?.known === false`(또는 `!saju.wonkuk?.hour`). 클라가 보낸 값을 신뢰하지 않는다
   - personaKey: lib/persona.ts 의 findPersona(personaKey ?? DEFAULT_PERSONA_KEY) 로만 조회 — 목록(lib/persona-list.ts)에 없으면 400
   - user(기억 키) = 세션의 회원 id 를 서버가 넣는다
   - 검증: messages는 배열, 마지막 6턴만 사용, role은 user/assistant만. role:'user' content는 500자 이하(넘으면 400), role:'assistant'(과거 답변)는 4,000자까지 허용
   - requestId: 클라가 보낸 UUID 로 dedup.once 를 걸어 같은 값이 다시 오면 FLOAT 를 다시 부르지 않는다
   - systemPrompt = 찾은 캐릭터의 persona + 아래 사주 블록 (서버가 조립)
     [사주 정보 — 이 값만 근거로 상담한다]
     연주 {year.stemHanja}{year.branchHanja}({year.ohaeng}) 월주 … 일주 …
     {시간 미상이 아니면} 시주 {hour.stemHanja}{hour.branchHanja}
     {시간 미상이면} 시주: 미상(출생시간을 몰라 계산 불가). 시주·시간에 근거한 해석을 만들어내지 말고, 물으면 "출생시간을 알려주면 시주까지 볼 수 있다"고만 안내하라. 정오 등 임의 값으로 대신 추정하지 마라
     오행 분포: 목 n 화 n 토 n 금 n 수 n
     일간 요약: {ilganSummary}
   - FLOAT 호출: chat/completions, body { model: "ridm/gpt-5.6-terra", user: 세션 회원 id, systemPrompt, messages, max_tokens: 700 }  // model·systemPrompt·max_tokens 전부 서버 상수
   - 응답: 이 엔드포인트만 {success,data} 래핑 없이 OpenAI 형식 그대로. 답변은 choices[0].message.content
2) 클라이언트는 messages(최근 대화)·personaKey·requestId만 보낸다. 6-2의 화면 요구사항(오류 분리·입력 제한·마크다운 처리)을 그대로 적용
완료 기준: 시간 모름 원국으로 "제 시주가 뭐예요?"라고 물었을 때 모른다고 밝히고 정오 등으로 단정하지 않는지 실제 확인 / 목록에 없는 personaKey 로 호출하면 400 / 비로그인 401 / 같은 requestId 재전송 시 FLOAT가 두 번 불리지 않는지(콘솔 사용량으로 확인)

상담 기억과 자유 채팅 기억 나누기: 위 프롬프트대로 user 에 회원 id 를 그대로 넣으면 사주 상담(/reading/memory — 책 코드의 열쇠도 회원 id)과 같은 기억 저장소를 씁니다. 두 대화가 한 이력 목록에 섞이고, 요약 주기(5턴) 뒤에는 상담 맥락이 자유 채팅 답변에 섞여 들어갈 수 있습니다(2026-10-09 실측). 기억을 기능별로 분리하려면 endUserId 를 회원id:saju / 회원id:chat 처럼 기능 접미사로 나눠 보내세요 — 지난 대화 목록도 분리됩니다. 자유 채팅 라우트(app/api/chat/route.ts)는 user 를 회원id:chat 으로 보내고, 상담 쪽까지 나누려면 수정 허용 파일인 lib/app-hooks.ts 의 memoryKey 가 회원id:saju 를 돌려주게 합니다(지난 대화 /api/history 도 같은 함수를 써서 함께 나뉩니다). 열쇠를 바꾸면 그 전에 쌓인 기억·이력은 옛 열쇠(회원 id)에 남아 새 화면에 안 보이니, 이미 운영 중인 앱이면 상담은 그대로 두고 자유 채팅에만 :chat 을 붙이는 편이 안전합니다. 어느 쪽이든 열쇠는 서버가 세션에서 만들고 브라우저 값은 쓰지 않습니다.

6-4. 흔한 함정

• 응답이 null: data 한 겹을 안 깠을 확률 99%. "응답 JSON을 콘솔에 찍어서 구조 확인하고 파싱 고쳐 주세요"
• 기억을 못 함: ① 첫 4번은 원래 memory.used: false입니다(5번마다 요약) ② endUserId 로 회원 id 가 아닌 딴 값이 가고 있는 것. "상담 호출에 로그인한 회원의 id 가 endUserId 로 들어가는지 확인해 주세요"
• AI가 앞에서 말한 세부 사항을 모른다고 함: 기억은 요약이라 자잘한 사실은 빠질 수 있습니다(6-1). 중요한 전제는 질문에 다시 담아 보내게 하세요 — "앞서 말한 반려견 두부 얘기인데, …"
• 429 에러: 여러분 프록시(route.ts)의 자체 요청 제한(회원당 분당 10회)에 걸림 — 정상 동작입니다. 데모 시연 때는 제한을 20으로. (HRUM(흐름) 콘솔의 "요청 제한"은 별개 — 기본 무제한)
• 다른 사람 상담이 섞임: 고정 endUserId("demo-user")를 쓰거나, 브라우저가 보낸 endUserId 를 프록시가 그대로 통과시킨 것. 프록시가 세션 회원 id 로 강제해야 합니다
• 로그인했는데 곧바로 401: 세션 쿠키를 브라우저 JS(document.cookie)로 만든 것 — RIDM Apps 관문은 서버 응답의 Set-Cookie만 받아 줍니다. 7-2 lib/get-session-user.ts의 setSessionCookie로만 설정
• AI가 오류 문구를 따라 말함: 네트워크 오류를 assistant 말풍선으로 대화 배열에 넣은 것. 오류는 별도 상태로
• 시간 모름인데 시주를 단정함: hour를 생략했는데도 화면이 시주 카드를 그리고 있거나, 자유 채팅 systemPrompt에 "시주: 미상" 블록(6-3)을 안 넣은 것
• 임의 페르소나로 답이 이상해짐: personaKey 를 검증 안 하고 클라 문자열을 그대로 systemPrompt에 꽂은 것. 서버가 lib/persona.ts 의 findPersona 로만 조회해야 한다
• 더블클릭하면 같은 질문이 두 번 크레딧을 씀: requestId 를 질문마다 한 번만 만들지 않고 클릭마다 새로 만든 것. 콘솔 빌링에서 같은 질문이 2회 과금됐는지 확인

AI용 분할본 · 지도 3단계(화면) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 5 운세 화면 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)