AI 인터랙티브 스토리의 호감도 시스템 설계: 행동 가이드, 이벤트 분기, 상태 복원

// game-rules.ts — 호감도별 행동 가이드
export function getAffinityBehaviorGuide(score: number): string {
  if (score <= 15) {
    return '경계/무관심. 대화에 최소한으로 응하지만 적대적이진 않다. 시선을 피하고 거리를 유지한다.';
  } else if (score <= 30) {
    return '쿨한 거리두기. 예의는 지키되 관심 없다는 태도. 필요한 말만 하고 벽을 세운다.';
  } else if (score <= 45) {
    return '중립~미약한 관심. 대화에 성실히 응하지만 먼저 다가오지 않는다.';
  } else if (score <= 60) {
    return '호의적. 플레이어에게 은근히 관심을 보인다. 가벼운 스킨십에 거부감 없다.';
  } else if (score <= 75) {
    return '뚜렷한 호감. 플레이어 근처에 있고 싶어한다. 진심 어린 대화를 원한다.';
  } else if (score <= 90) {
    return '연애 감정. 플레이어를 매우 의식하고 표현이 직접적. 스킨십을 주도하기도 한다.';
  } else {
    return '깊은 유대. 플레이어에게 완전히 빠져 있다. 감정 표현이 강렬하고 강한 독점욕.';
  }
}

// affinity-evaluation.service.ts — 평가 실행부
async evaluate(context: EvaluationContext): Promise<AffinityChange[]> {
  const systemPrompt = this.buildPrompt(context);

  const response = await this.aiClient.generateText({
    model: 'claude-haiku-4-5',
    system: systemPrompt,
    userMessage: `플레이어 발화: "${context.userMessage}"\n\nAI 생성 응답:\n${context.aiResponse}`,
    maxTokens: 2048,
    responseFormat: 'json',
  });

  const rawChanges = this.parseResult(response.text, context.affinities);
  // 프로그래밍 방식 감쇠 적용
  return this.dampenChanges(rawChanges, context.recentChanges ?? []);
}

// affinity-evaluation.service.ts — 연속 상승 경고 생성
const warnings: string[] = [];
for (const [name, count] of consecutivePositive) {
  if (count >= 4) {
    warnings.push(`${name}: ${count}턴 연속 상승 → 반드시 변화 없음(0) 반환`);
  } else if (count >= 3) {
    warnings.push(`${name}: ${count}턴 연속 상승 → 최대 +1만 가능`);
  } else if (count >= 2) {
    warnings.push(`${name}: ${count}턴 연속 상승 → 최대 +2만 가능`);
  }
}

// affinity-evaluation.service.ts — 프로그래밍 감쇠
private dampenChanges(changes: AffinityChange[], recentChanges: RecentChange[]): AffinityChange[] {
  return changes.map((change) => {
    if (change.delta === 0) return change;

    // 같은 방향의 최근 누적 변경량 합산
    const recentSameDir = recentChanges
      .filter((rc) => rc.characterName === change.characterName
        && Math.sign(rc.delta) === Math.sign(change.delta))
      .reduce((sum, rc) => sum + Math.abs(rc.delta), 0);

    // 누적량 * 7%만큼 감쇠 (누적 15점이면 약 100% 감쇠)
    const dampingFactor = Math.max(0, 1 - recentSameDir * 0.07);
    return { ...change, delta: Math.round(change.delta * dampingFactor) };
  }).filter((c) => c.delta !== 0);
}

EP.1 "첫 만남, 그리고 편지"
│
├── [sequential] 오프닝 나레이션 (에피소드 시작 즉시)
│
├── (자유 대화 흐름)
│
├── [sequential, after_messages: 10] "자기소개 시간"
│
├── [conditional, affinity_gte: 20] "옥상 대화"
│
├── [sequential, after_messages: 30] "편지 공개 미션"
│
└── [conditional, story_flag + affinity_gte: 25] 히든: "한시우의 진심"

// chat.service.ts — 분기 조건 평가
for (const branch of currentEvent.branches) {
  if (
    branch.condition.type === 'affinity_gte' &&
    branch.condition.character
  ) {
    const score = affinityByName.get(branch.condition.character) ?? 50;
    if (score >= (branch.condition.threshold ?? 0)) {
      nextId = branch.next;
      break;
    }
  } else if (branch.condition.type === 'default') {
    nextId = branch.next;
    break;
  }
}

// schema.prisma — Event 모델
model Event {
  id               String      @id @default(uuid())
  episodeId        String      @map("episode_id")
  eventType        EventType   // STORY_BRANCH | MISSION | SECRET_SCENE | CG_SCENE | GROUP_EVENT
  triggerType      TriggerType // sequential | conditional
  title            String

  // 조건: JSON으로 유연한 구조
  triggerCondition Json?       @map("trigger_condition")
  // { type: 'affinity_gte', character_id, value }
  // { type: 'combined', additional_conditions: [...] }

  // 결과: 호감도 변화(이벤트 전용 -20~+20), 감정 전환, 플래그
  choices          Json?       // [{ text, outcome: { affinity_change, story_flag } }]
  outcome          Json?       // 선택지 없는 이벤트의 기본 결과
}

// game-rules.ts — 호감도별 신체 접촉 허용 범위
export const PHYSICAL_CONTACT_RULES = `[호감도별 신체 접촉 허용 범위 — 절대 규칙]
- 0~15점: 모든 신체 접촉 거부/회피.
- 16~30점: 악수 정도만. 그 이상은 당황하며 거리를 둔다.
- 31~45점: 악수, 어깨 가볍게 치기. 그 이상은 부자연스러움.
- 46~60점: 팔짱, 가벼운 스킨십 수용. 키스 시도 시 놀라며 피함.
- 61~75점: 손잡기, 가벼운 포옹 자연스러움. 키스 분위기에 따라 수용.
- 76~90점: 키스, 포옹, 적극적 스킨십 수용/주도.
- 91~100점: 강한 독점욕과 열정. 성적 접촉에 매우 적극적.`;

// chat.controller.ts — 메시지 전송 시 스냅샷 캡처
const affinitySnapshot: Record<string, number | string | boolean> = {};
for (const a of ctx.session.affinityScores) {
  affinitySnapshot[a.characterId] = a.score;
}
// 이벤트 상태도 기록
affinitySnapshot.__eventId = ctx.session.stateJson.currentEventId ?? 'intro';

// chat.controller.ts — 되감기 엔드포인트 (DELETE /:messageId/rewind)
const snapshot = message.affinitySnapshot as Record<string, number | string> | null;
const restoredEventId = snapshot?.__eventId as string | undefined;

// 1. 해당 시점 이후의 모든 메시지 삭제
await this.prisma.chatMessage.deleteMany({
  where: { sessionId, createdAt: { gte: message.createdAt } },
});

// 2. 범위가 겹치는 기억(메모리)도 삭제
await this.prisma.sessionMemory.deleteMany({
  where: { sessionId, messageRangeEnd: { gte: message.createdAt } },
});

// 3. 호감도 복원 (__eventId, __isTalk 등 메타 키는 스킵)
if (snapshot) {
  for (const [key, score] of Object.entries(snapshot)) {
    if (key.startsWith('__')) continue;
    await this.prisma.affinityScore.updateMany({
      where: { sessionId, characterId: key },
      data: { score: score as number },
    });
  }
}