LLM 기반 콘텐츠 생성 파이프라인과 어드민 CMS 아키텍처

// admin.module.ts — 14개 도메인 서비스 등록
@Module({
  imports: [AuthModule, ContentSafetyModule, GemsModule, SubscriptionsModule],
  controllers: [AdminController],
  providers: [
    AdminService,                  // 대시보드 통계만
    AdminAiGenerationService,      // AI 스토리/캐릭터 생성
    AdminCharacterService,         // 캐릭터 CRUD/승인
    AdminContentIoService,         // 콘텐츠 Export/Import
    AdminContentSafetyService,     // 블랙리스트/안전 로그
    AdminGemService,               // 젬 트랜잭션/잔액
    AdminImageService,             // 이미지 업로드
    AdminSessionService,           // 세션 조회/메시지 페이징
    AdminStoryService,             // 스토리+에피소드+이벤트
    AdminSubscriptionService,      // 구독/프로모 코드
    AdminTalkRoomService,          // 토크룸 CRUD/승인
    AdminUserLookupService,        // Clerk 유저 조회 헬퍼
    AdminUserService,              // 유저 목록/역할 변경
  ],
})
export class AdminModule {}

// admin.service.ts — 통계만 담당 (17줄)
@Injectable()
export class AdminService {
  constructor(private prisma: PrismaService) {}

  async getStats() {
    const [users, stories, sessions, messages] = await Promise.all([
      this.prisma.user.count(),
      this.prisma.story.count(),
      this.prisma.playSession.count(),
      this.prisma.chatMessage.count(),
    ]);
    return { users, stories, sessions, messages };
  }
}

// admin-ai-generation.service.ts — 아키타입 힌트
const ARCHETYPE_HINTS: Record<
  string,
  { label: string; emotionPattern: string; description: string }
> = {
  'cold-aloof': {
    label: '까칠/무뚝뚝',
    emotionPattern: 'neutral→confused→tender→longing',
    description:
      '겉은 차갑지만 관심 있으면 은근히 챙김. 짧은 문장·단답 후 긴 독백 전환.',
  },
  tsundere: {
    label: '츤데레',
    emotionPattern: 'angry→confused→shy→happy',
    description:
      '호감을 감추려 거칠게 대하지만 결정적 순간에 솔직. 부정 뒤 소곤("…아닌데") 패턴',
  },
  obsessive: {
    label: '집착형',
    emotionPattern: 'angry→jealous→longing→tender',
    description:
      '강한 독점욕, 소유격 대사("넌 내 거야"), 질투 독백, 과잉 보호 행동',
  },
  // ... cheerful, mysterious, healing-mentor, childhood-friend 등 총 10개
};

// admin-ai-generation.service.ts — 스토리 생성 진입점
async generateStory(dto: GenerateStoryDto) {
  const characterCount = dto.characterCount ?? STORY_DEFAULTS.CHARACTER_COUNT;
  const episodeCount = dto.episodeCount ?? STORY_DEFAULTS.EPISODE_COUNT;
  const presetHint = dto.preset ? STORY_PRESET_HINTS[dto.preset] : undefined;

  const systemPrompt = `너는 AI 스토리·토크 플랫폼 "플릿(Plit)"의 스토리 작가 AI이다.
  ...
  ## 생성 규칙
  - 캐릭터 수: ${characterCount}명
  - 에피소드 수: ${episodeCount}개
  ${PERSONA_QUALITY_RULES}
  ...`;

  const result = await this.callGeminiJson(
    systemPrompt,
    userMessage,
    MAX_OUTPUT_TOKENS.STORY, // 65,536 토큰
    '스토리',
  );
  return result;
}

// admin-ai-generation.service.ts — 기존 캐릭터 컨텍스트 주입
async generateCharacter(storyId: string, dto: { archetype?: string; ... }) {
  const story = await this.prisma.story.findUniqueOrThrow({
    where: { id: storyId },
    include: { characters: { include: { character: true } } },
  });

  // 기존 캐릭터 요약을 프롬프트에 포함
  const existingChars = story.characters
    .map((sc) =>
      `- ${sc.character.name} (${sc.role}, ${sc.character.gender}): ${(sc.character.personaPrompt ?? '').slice(0, 100)}...`
    )
    .join('\n');

  const systemPrompt = `...
## 기존 캐릭터
${existingChars || '(없음)'}
## 생성 규칙
- 기존 캐릭터들과 차별화된 개성을 가져야 함
${this.buildArchetypePrompt(dto.archetype)}
...`;
}

// admin-content-io.service.ts — 스토리 Export (관계 데이터 포함)
async exportStories(ids?: string[]) {
  const stories = await this.prisma.story.findMany({
    where: ids?.length ? { id: { in: ids } } : {},
    include: {
      characters: {
        include: { character: true },
        orderBy: { sortOrder: 'asc' },
      },
      episodes: {
        include: { events: { orderBy: { sortOrder: 'asc' } } },
        orderBy: { episodeNumber: 'asc' },
      },
    },
  });

  return {
    exportVersion: '1.0',
    type: 'stories',
    // ID, 타임스탬프 제거 — 이름 기반 충돌 해결
    data: stories.map(({ id, createdAt, updatedAt, characters, episodes, ...rest }) => ({
      ...rest,
      characters: characters.map(({ character, ...link }) => ({ ...link, character })),
      episodes: episodes.map(({ events, ...ep }) => ({ ...ep, events })),
    })),
  };
}

/admin                    # 대시보드 (통계)
/admin/contents           # 콘텐츠 목록 (스토리 + 토크룸)
/admin/contents/new       # 새 콘텐츠 생성 (위저드)
/admin/contents/story/[id] # 스토리 상세 편집 (탭 구조)
/admin/contents/talk/[id]  # 토크룸 상세 편집
/admin/sessions           # 세션 목록
/admin/sessions/[id]      # 세션 상세 (메시지 뷰어)
/admin/users              # 유저 관리
/admin/gems               # 젬 트랜잭션
/admin/subscriptions      # 구독 관리
/admin/feedback           # 피드백
/admin/images             # 이미지 관리

// AiCharacterGenerateDialog.tsx — 아키타입 선택 UI
<div className="grid grid-cols-2 gap-2">
  {CHARACTER_ARCHETYPES.map((arch) => (
    <button
      key={arch.key}
      onClick={() => setSelectedArchetype(arch.key)}
      className={`rounded-lg border p-2 text-left ${
        selectedArchetype === arch.key ? 'border-primary bg-primary/5' : 'border-border'
      }`}
    >
      <div className="text-sm font-medium">{arch.label}</div>
      <div className="text-xs text-muted-foreground">{arch.description}</div>
      <div className="mt-1 text-xs text-muted-foreground/60">{arch.emotionPattern}</div>
    </button>
  ))}
</div>

// admin-ai-generation.service.ts — Gemini JSON 호출 공통 레이어
private async callGeminiJson(
  systemPrompt: string,
  userMessage: string,
  maxOutputTokens: number,
  errorContext: string,
): Promise<Record<string, unknown>> {
  const response = await this.gemini.models.generateContent({
    model: GENERATE_MODEL,       // 'gemini-3.1-flash-lite-preview'
    contents: userMessage,
    config: {
      systemInstruction: systemPrompt,
      responseMimeType: 'application/json', // JSON 모드 강제
      maxOutputTokens,
    },
  });

  const text = response.text ?? '';
  if (!text) {
    const reason = response.candidates?.[0]?.finishReason ?? 'unknown';
    throw new InternalServerErrorException(
      'AI가 빈 응답을 반환했습니다. 다시 시도해주세요.',
    );
  }
  return JSON.parse(text); // 파싱 실패 시 재시도 유도
}